claude-handoff-mcp

Claude Design 핸드오프 번들을 위한 최초의 오픈 소스 MCP 서버.

Cursor, Claude Code, Cline, Windsurf 또는 모든 MCP 호환 클라이언트에 Claude Design 핸드오프 URL을 붙여넣으면 번들이 프로젝트에 즉시 생성되어 바로 사용할 수 있습니다.

Paste handoff URL  →  MCP fetches, extracts, summarizes the README,
                      and deploys files into your repo. One tool call.

목적

Claude Design(Anthropic Labs, 2026년 4월 17일 출시)은 api.anthropic.com/v1/design/h/<hash>에서 제공되는 핸드오프 URL로 디자인을 내보냅니다. 현재 이를 사용하려면 tar 파일을 다운로드하고, 압축을 풀고, README를 읽고, 무엇을 어디로 복사해야 할지 파악해야 합니다. 이 MCP는 그 과정을 모든 에이전트형 IDE에서 단일 단계로 만들어 줍니다.

• 상태: 커뮤니티 프로젝트. Anthropic과 관련 없음.

• 범위: 공개적으로 제공되는 핸드오프 번들 형식을 래핑합니다. 스크래핑이나 공개된 핸드오프 URL 이외의 문서화되지 않은 엔드포인트 사용, claude.ai 세션 스푸핑은 없습니다.

Related MCP server: Claude Figma MCP

노출된 도구

설치

npm install -g @kiwuuu/claude-handoff-mcp

Claude Code에서 사용

MCP 설정(~/.claude.json 또는 클라이언트가 MCP 서버를 읽는 위치)에 추가하세요:

{
  "mcpServers": {
    "claude-handoff": {
      "command": "npx",
      "args": ["-y", "@kiwuuu/claude-handoff-mcp"]
    }
  }
}

그런 다음 채팅에서:

Fetch https://api.anthropic.com/v1/design/h/abc123 and deploy it into ./public/

Cursor / Cline / Windsurf에서 사용

동일한 설정 형식을 사용하며 npx 엔트리를 가리키면 됩니다. 정확한 파일 위치는 각 클라이언트의 MCP 문서를 참조하세요.

CLI 직접 사용

npx claude-handoff one-shot https://api.anthropic.com/v1/design/h/abc123 ./my-app/public

주의 사항

• 핸드오프 URL은 만료됩니다. TTL이 있으며 일회용일 수 있습니다. 공유 메뉴 내보내기가 최신 URL을 얻는 유일한 방법이며, 공개 목록 엔드포인트는 없습니다. fetch_handoff가 HTTP 404를 반환하면 URL이 만료된 것이므로 claude.ai/design에서 다시 내보내세요.

• API 키를 사용하지 않습니다. 이 도구는 공개 핸드오프 URL만 호출합니다. ANTHROPIC_API_KEY가 필요하지 않습니다.

• 형식 안정성. 번들 형식은 관찰된 것이며 명시된 것이 아닙니다. Anthropic이 형식을 변경하면 이 도구는 적응하거나 중단됩니다.

기여

이슈 및 PR을 환영합니다. 핵심 fetch/extract/deploy 로직은 src/core.ts에 400줄 미만으로 작성되어 있어 읽기 쉽고 포크하기 쉽습니다.

라이선스

MIT. LICENSE를 참조하세요.