obsidian/infra/platform/brokkr.md

title, updated, tags

title	updated	tags
Brokkr — 홈페이지 제작 에이전트	2026-04-01	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 사용법, 에셋 가이드 포함

실행 방법

# 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 — 헤임달 에이전트 (인프라 관리)