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における1つのステップに集約します。

• ステータス: コミュニティプロジェクト。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（生存時間）があり、1回限りの使用である可能性があります。共有メニューからのエクスポートが新しいURLを取得する唯一の方法であり、公開リストのエンドポイントはありません。fetch_handoff がHTTP 404を返す場合、URLの有効期限が切れています。claude.ai/designから再エクスポートしてください。

• APIキーは使用しません。 このツールは公開ハンドオフURLのみを呼び出します。ANTHROPIC_API_KEY は不要です。

• 形式の安定性。 バンドル形式は観測に基づくものであり、仕様化されたものではありません。Anthropicが変更を加えた場合、このツールは適応するか、一時停止します。

コントリビューション

IssueやPRを歓迎します。コアとなる取得・展開・デプロイのロジックは src/core.ts 内の400行未満のコードで構成されており、読みやすく、フォークも容易です。

ライセンス

MIT。LICENSE を参照してください。