main.py                     # FastAPI 앱 — 4개 MCP 서버 마운트
src/
├── core/                   # 인프라 레이어
│   ├── config.py           # 환경변수 → Settings 싱글턴 (frozen dataclass + lru_cache)
│   └── http.py             # figma_client / notion_client async 컨텍스트 매니저
├── services/               # 비즈니스 레이어
│   ├── figma.py            # FigmaService — Figma REST API 호출 + 응답 가공
│   ├── notion.py           # NotionService — Notion API 호출 + 응답 가공
│   └── figma_draw.py       # FigmaDrawService — 디자인 명세 → Figma Plugin Script 생성
└── mcp/                    # 인터페이스 레이어
    ├── figma.py            # figma_mcp + @tool 8개
    ├── notion.py           # notion_mcp + @tool 7개
    ├── project.py          # project_mcp + @tool 3개
    └── draw.py             # draw_mcp + @tool 8개

pip install -r requirements.txt

cp .env.example .env

FIGMA_ACCESS_TOKEN=fig_xxxxxxxxxxxxxxxxxxxxxxxx
NOTION_API_KEY=secret_xxxxxxxxxxxxxxxxxxxxxxxx

python3 main.py

uvicorn main:app --reload --port 8000

# 필수 (Figma + Notion + 통합)
claude mcp add --transport sse soldoc-figma https://your-mcp-server.com/figma/sse
claude mcp add --transport sse soldoc-notion https://your-mcp-server.com/notion/sse
claude mcp add --transport sse soldoc-project https://your-mcp-server.com/project/sse

# 선택
claude mcp add --transport sse soldoc-draw https://your-mcp-server.com/draw/sse
claude mcp add --transport sse soldoc-asana https://your-mcp-server.com/asana/sse

claude mcp list

{
  "mcpServers": {
    "soldoc-figma": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://your-mcp-server.com/figma/sse", "--port", "5011"]
    },
    "soldoc-notion": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://your-mcp-server.com/notion/sse", "--port", "5012"]
    },
    "soldoc-project": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://your-mcp-server.com/project/sse", "--port", "5013"]
    },
    "soldoc-draw": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://your-mcp-server.com/draw/sse", "--port", "5014"]
    },
    "soldoc-asana": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://your-mcp-server.com/asana/sse", "--port", "5015"]
    }
  }
}

# Figma — URL 붙여넣기만 하면 됩니다
"이 Figma 기획 내용 정리해줘: https://www.figma.com/design/abc123/..."

# Notion
"Notion에서 '스프린트' 키워드로 검색해줘"

# 통합 조회
"Figma 파일과 Notion 페이지로 프로젝트 현황 요약해줘"

# Asana
"Asana 프로젝트 목록 보여줘"
"'로그인 버그 수정' 태스크를 만들고 김철수에게 할당해줘"

# 디자인 생성
"로그인 페이지 디자인을 Figma에 그려줘"

pip install -r requirements.txt
cp .env.example .env   # 토큰 입력
python3 main.py        # http://localhost:8000

1. Figma 데스크탑 앱 실행
2. 상단 메뉴 Plugins → Development → Open Console
3. 도구가 반환한 plugin_script 값을 붙여넣기
4. Enter → 현재 페이지에 디자인 생성 완료

# Figma 분석
"Figma 파일 abc123의 컴포넌트 목록을 보여줘"
"이 Figma 파일에서 색상 스타일을 전부 뽑아줘"

# Notion 작업
"Notion에서 '스프린트' 키워드로 페이지를 검색해줘"
"이 데이터베이스에서 Status가 '진행 중'인 항목만 뽑아줘"

# 통합 조회
"Figma 파일 abc123과 Notion 페이지 def456으로 프로젝트 현황을 요약해줘"
"Figma 컴포넌트 목록을 Notion DB에 동기화해줘"

# 디자인 자동 생성
"소셜 로그인 버튼이 있는 로그인 페이지를 Figma에 그려줘"
"카드 4개짜리 대시보드를 만들어줘"
"파란색 primary 버튼 하나 만들어줘"
"상단 네비바, 프로필 이미지, 이름, 소개, 편집 버튼이 있는 프로필 페이지 그려줘"

ruff check .          # 린트 검사
ruff check . --fix    # 자동 수정
ruff format .         # 포매팅
mypy src/             # 타입 체크