claude-handoff-mcp

Der erste Open-Source-MCP-Server für Claude Design Handoff-Bundles.

Fügen Sie eine Claude Design-Handoff-URL in Cursor, Claude Code, Cline, Windsurf — oder einen beliebigen MCP-kompatiblen Client — ein, und das Bundle erscheint in Ihrem Projekt, bereit zur Bereitstellung.

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

Warum

Claude Design (Anthropic Labs, gestartet am 17.04.2026) exportiert Designs als Handoff-URLs, die unter api.anthropic.com/v1/design/h/<hash> bereitgestellt werden. Heutzutage bedeutet die Nutzung dieser: Tar-Datei herunterladen, extrahieren, README lesen, herausfinden, was wohin kopiert werden muss. Dieses MCP macht daraus einen einzigen Schritt in jeder agentischen IDE.

• Status: Community-Projekt. Nicht mit Anthropic verbunden.

• Umfang: Umhüllt das öffentlich bereitgestellte Handoff-Bundle-Format. Kein Scraping, keine undokumentierten Endpunkte jenseits der veröffentlichten Handoff-URL, kein Spoofing von claude.ai-Sitzungen.

Related MCP server: Claude Figma MCP

Verfügbare Tools

Installation

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

Verwendung in Claude Code

Fügen Sie dies zu Ihrer MCP-Konfiguration hinzu (~/.claude.json oder wo auch immer Ihr Client MCP-Server liest):

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

Dann im Chat:

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

Verwendung in Cursor / Cline / Windsurf

Gleiche Konfigurationsstruktur — verweisen Sie auf den npx-Eintrag. Siehe die MCP-Dokumentation des jeweiligen Clients für die genaue Datei.

Verwendung direkt über die CLI

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

Vorbehalte

• Handoff-URLs laufen ab. Sie haben eine TTL (Time-to-Live) und sind möglicherweise nur einmal verwendbar. Der Export über das Teilen-Menü ist der einzige Weg, eine neue URL zu erhalten — es gibt keinen öffentlichen Endpunkt zur Auflistung. Wenn fetch_handoff einen HTTP 404-Fehler zurückgibt, ist die URL abgelaufen; exportieren Sie sie erneut von claude.ai/design.

• Kein API-Schlüssel erforderlich. Dieses Tool ruft nur die öffentliche Handoff-URL auf. Es benötigt keinen ANTHROPIC_API_KEY.

• Formatstabilität. Das Bundle-Format wird beobachtet, nicht spezifiziert. Wenn Anthropic es ändert, passt sich dieses Tool an oder pausiert.

Mitwirken

Issues und PRs sind willkommen. Die Kernlogik für Abruf/Extraktion/Bereitstellung umfasst weniger als 400 Zeilen Code in src/core.ts — leicht zu lesen, leicht zu forken.

Lizenz

MIT. Siehe LICENSE.