Integración con Claude Code

Claude Code ejecuta @burnbound/mcp como un servidor MCP stdio local. Una vez añadido, Claude Code puede llamar a fetch_paid para pagar APIs x402 y MPP, a stripe_refund para reembolsar cargos de Stripe a través de tu gateway de acciones y a get_budget para ver cuánto puede gastar, y cada pago o reembolso se comprueba contra la política de tu agente antes de que se mueva el dinero. Esta página tiene la configuración exacta para cada ámbito, las reglas de permisos que conviene añadir y soluciones a los problemas habituales. Sintaxis según la documentación de Claude Code: Connect to MCP servers y la referencia de MCP.

Añade el servidor para todos tus proyectos

Necesitas Node.js 20 o posterior y una clave del agente (bb_agent_…) del panel de Burnbound, que muestra esta línea con la clave ya rellenada:

claude mcp add burnbound --scope user -e BURNBOUND_KEY=bb_agent_… -- npx -y @burnbound/mcp@latest

• burnbound es el nombre del servidor. Las herramientas aparecen en Claude Code como mcp__burnbound__fetch_paid, mcp__burnbound__get_budget, etc.
• -e (--env) define una variable de entorno para el servidor. BURNBOUND_KEY es la única obligatoria.
• Todo lo que va después de -- es el comando que ejecuta Claude Code.

Comprueba que está registrado y conectado:

claude mcp list
claude mcp get burnbound

Dentro de una sesión, /mcp muestra el estado del servidor y sus herramientas.

Para obtener una versión nueva de @burnbound/mcp, reinicia el servidor MCP: vuelve a conectarlo desde /mcp o reinicia la sesión de Claude Code. Con @latest, npx busca la versión más reciente cuando arranca el servidor.

¿Qué ámbito debería usar?

Si el mismo nombre existe en más de un ámbito, local gana a project, y project a user. Un agente de Burnbound por cada carga de trabajo mantiene separados los topes y la auditoría: puedes registrar una clave distinta en cada proyecto con el ámbito local por defecto.

Compártelo con un equipo sin hacer commit de la clave

Un .mcp.json de proyecto está pensado para hacerle commit, así que deja la clave fuera. Claude Code expande ${VAR} (y ${VAR:-default}) a partir del entorno en command, args y env:

{
  "mcpServers": {
    "burnbound": {
      "command": "npx",
      "args": ["-y", "@burnbound/mcp@latest"],
      "env": {
        "BURNBOUND_KEY": "${BURNBOUND_KEY}"
      }
    }
  }
}

Cada desarrollador exporta su propia clave del agente (export BURNBOUND_KEY=bb_agent_… en el perfil de su shell) antes de arrancar Claude Code. Claude Code lee .mcp.json al empezar la sesión y pide a cada persona que apruebe un servidor de proyecto la primera vez; claude mcp reset-project-choices deshace un rechazo.

Permisos: preguntar antes de pagar

@burnbound/mcp tiene ocho herramientas. fetch_paid y stripe_refund son las únicas que pueden mover dinero; stripe_refund solo funciona con el gateway de acciones y BURNBOUND_GATEWAY_URL. propose_rule escribe una regla, pero una que solo puede restringir el gasto del propio agente. Las otras cinco solo leen. Una configuración sensata deja que las herramientas de solo lectura se ejecuten y mantiene una pregunta en cada pago, cada reembolso y cada regla nueva, para que veas la regla antes de que se aplique. En .claude/settings.json (proyecto) o ~/.claude/settings.json (todos los proyectos):

{
  "permissions": {
    "allow": [
      "mcp__burnbound__get_budget",
      "mcp__burnbound__list_payments",
      "mcp__burnbound__get_approval_status",
      "mcp__burnbound__search_paid_apis",
      "mcp__burnbound__diagnose_payment"
    ],
    "ask": [
      "mcp__burnbound__fetch_paid",
      "mcp__burnbound__stripe_refund",
      "mcp__burnbound__propose_rule"
    ]
  }
}

La política de Burnbound se aplica elijas lo que elijas aquí: una pregunta que apruebas sigue sin poder llevar un pago más allá de los topes o los hosts permitidos del agente. La sintaxis de las reglas está en la documentación de permisos de Claude Code.

Si el agente firma con una clave en tu máquina (firma en el cliente), quítale también las vías habituales para leerla. Estas reglas reducen los accidentes; no son un sandbox, y por eso Coinbase CDP es la opción más sólida para los agentes de programación:

{
  "permissions": {
    "deny": [
      "Read(~/.burnbound/**)",
      "Edit(~/.burnbound/**)",
      "Bash(security find-generic-password:*)",
      "Bash(security dump-keychain:*)",
      "Bash(secret-tool lookup:*)",
      "Bash(npx -y @burnbound/mcp@latest wallet export:*)",
      "Bash(npx -y @burnbound/mcp wallet export:*)",
      "Bash(burnbound-mcp wallet export:*)"
    ]
  }
}

Primera llamada

Pregúntale a Claude Code:

What is my Burnbound budget?

Después, una petición de pago a uno de los hosts permitidos del agente, por ejemplo la búsqueda de Tavily (0.01 USDC por llamada en Base la última vez que lo verificamos):

Use fetch_paid to POST https://x402.tavily.com/search with the JSON body
{"query": "what is x402?", "max_results": 3}, the header
Content-Type: application/json, and maxAmountUsd "0.02".

Tienes más vendedores, con sus hosts y precios, en el catálogo de APIs x402. El recorrido completo está en Cómo pagar una API x402 desde Claude Code.

Windows

claude mcp add funciona igual en PowerShell y en el Símbolo del sistema, así que el comando de arriba no necesita cambios. En Windows, ~/.claude.json es %USERPROFILE%\.claude.json.

En Windows, la firma en el cliente guarda la cartera en un archivo y es experimental. Allí es mejor usar Coinbase CDP.

Resolución de problemas

Para quitar el servidor: claude mcp remove burnbound (añade --scope user si lo añadiste en ese ámbito).

Relacionado

• Primeros pasos: del registro al primer pago.
• Referencia de las herramientas MCP: cada entrada, resultado y código de error.
• Configuración de Cursor y Claude Desktop.