claude-handoff-mcp

El primer servidor MCP de código abierto para paquetes de entrega (handoff) de Claude Design.

Pega una URL de entrega de Claude Design en Cursor, Claude Code, Cline, Windsurf —o cualquier cliente compatible con MCP— y el paquete se materializará en tu proyecto, listo para ser enviado.

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

Por qué

Claude Design (Anthropic Labs, lanzado el 17-04-2026) exporta diseños como URLs de entrega servidas desde api.anthropic.com/v1/design/h/<hash>. Hoy en día, consumirlos significa: descargar el tar, extraer, leer el README, averiguar qué copiar y dónde. Este MCP convierte eso en un solo paso en cualquier IDE con capacidades de agente.

• Estado: proyecto comunitario. No afiliado a Anthropic.

• Alcance: envuelve el formato de paquete de entrega servido públicamente. Sin scraping, sin endpoints no documentados más allá de la URL de entrega publicada, sin suplantación de sesión de claude.ai.

Related MCP server: Claude Figma MCP

Herramientas expuestas

Instalación

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

Uso en Claude Code

Añádelo a tu configuración de MCP (~/.claude.json o donde sea que tu cliente lea los servidores MCP):

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

Luego en el chat:

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

Uso en Cursor / Cline / Windsurf

La misma estructura de configuración: apunta a la entrada npx. Consulta la documentación de MCP de cada cliente para ver el archivo exacto.

Uso directo de la CLI

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

Advertencias

• Las URLs de entrega caducan. Tienen un TTL y pueden ser de un solo uso. La exportación desde el menú Compartir es la única forma de obtener una URL nueva; no existe un endpoint de listado público. Si fetch_handoff devuelve un HTTP 404, la URL ha caducado; vuelve a exportar desde claude.ai/design.

• No se utiliza clave API. Esta herramienta solo llama a la URL de entrega pública. No requiere ANTHROPIC_API_KEY.

• Estabilidad del formato. El formato del paquete es observado, no especificado. Si Anthropic lo cambia, esta herramienta se adaptará o se detendrá.

Contribución

Las incidencias y PRs son bienvenidas. La lógica central de obtención/extracción/despliegue tiene menos de 400 líneas de código en src/core.ts: fácil de leer, fácil de bifurcar.

Licencia

MIT. Ver LICENSE.