---
title: Brokkr — 홈페이지 제작 에이전트
updated: 2026-04-01
tags: [infra, agent, incus, claude-code]
---

## 개요

Brokkr는 홈페이지 제작 전담 에이전트. 북유럽 신화의 드워프 대장장이(토르의 묠니르 제작자)에서 이름을 따옴.

| 항목 | 값 |
|------|-----|
| 위치 | incus-kr1, default 프로젝트 |
| OS | Debian 13 (trixie) |
| IP | 10.100.3.54 |
| 접속 | `ssh root@10.100.3.54` (incus-kr1 경유) |
| 역할 | 홈페이지/웹사이트 제작 에이전트 |

## 설치된 도구

| 도구 | 버전 |
|------|------|
| Claude Code | v2.1.87 |
| Node.js | 22.22.2 |
| bun | 1.3.11 |
| git | 2.47.3 |
| jq | 1.7.1 |
| uv | 최신 |
| tmux | 3.5a |
| Python | 3.13.5 |
| gcloud SDK | 563.0.0 |
| socat | 1.8.0.3 |

## PATH 설정

`/root/.bashrc`에 추가됨:
```
export PATH=/root/.bun/bin:/opt/google-cloud-sdk/bin:/root/.local/bin:$PATH
```
bun은 `/usr/local/bin/bun`에도 심볼릭 링크.

## 설정

- SSH: root 키 인증 (kaffa@KaFFa-Mac-mini.lan)
- tmux: dotfiles 기반 Dracula 테마, Debian 서버 환경 최적화 (`~/.tmux.conf`)
- CLAUDE.md: 역할, 디자인 워크플로우, Figma/Stitch 사용법, 에셋 가이드 포함

## 실행 방법

```bash
# tmux 세션으로 실행
tmux new -d -s brokkr 'export PATH=/root/.bun/bin:/opt/google-cloud-sdk/bin:/root/.local/bin:$PATH && claude --channels plugin:discord@claude-plugins-official'

# 신뢰 확인 프롬프트 통과
tmux send-keys -t brokkr Enter

# 상태 확인
tmux capture-pane -t brokkr -p
```

## MCP 서버

| MCP | 상태 | 용도 |
|-----|------|------|
| plugin:figma:figma | ✓ | Figma 디자인 읽기/쓰기 (OAuth, credentials.json에 토큰 저장) |
| plugin:context7:context7 | ✓ | 라이브러리 문서 조회 |
| plugin:playwright:playwright | ✓ | 브라우저 자동화 |
| outline | ✓ | Outline Wiki 문서 CRUD (API 키: Vault `secret/apps/outline`, 키명 brokkr-api-key) |
| stitch | ✓ | Google Stitch AI 디자인 (gcloud 인증 필요) |
| claude.ai Google Calendar | ✓ | 캘린더 |
| claude.ai Gmail | ✓ | 이메일 |
| claude.ai Cloudflare | ✓ | Cloudflare Workers/R2 |

## Discord 연결

| 항목 | 값 |
|------|-----|
| 봇 ID | 1488674138359857152 |
| 봇 토큰 | Vault `secret/messaging/discord-brokkr` |
| 채널 1 | 1488669324393578506 (brokkr 전용) |
| 채널 2 | 1488679091514380450 |
| 권한 | Send Messages, Read Message History, View Channels, Add Reactions |

## 담당 작업

- Ironclad 홈페이지 제작 (ironclad.it.com)
- 기획서: https://outline.inouter.com/doc/ironclad-AlZo9my3KN
- 기술 스택: Astro + Google Stitch + Tailwind CSS
- 배포: cf-multisite (Gitea → R2 → Cloudflare Workers)

## 주의사항

- Figma OAuth 토큰은 `/root/.claude/.credentials.json`에 저장됨. 로컬 Mac keychain에서 복사한 토큰.
- gcloud 인증은 로컬에서 복사한 application_default_credentials.json 사용

## 관련 문서

- [[infra-hosts]] — 인프라 호스트 전체
- [[outline]] — Outline Wiki (기획서 위치)
- [[heimdall]] — 헤임달 에이전트 (인프라 관리)