Integración con Claude Desktop

Claude Desktop ejecuta los servidores MCP locales que aparecen en su claude_desktop_config.json. Si añades ahí @burnbound/mcp, Claude puede pagar APIs x402 y reembolsar cargos de Stripe desde un chat, dentro de los topes y los hosts permitidos de tu agente. Esta página tiene la configuración exacta para macOS y Windows y dónde mirar cuando el servidor no arranca. Los pasos siguen la documentación de Connect to local MCP servers y la guía de Anthropic sobre servidores MCP locales en Claude Desktop.

Abre el archivo de configuración

Claude Desktop necesita Node.js instalado: compruébalo con node --version en una terminal (@burnbound/mcp necesita la versión 20 o posterior).

1. Pulsa el menú Claude en la barra de menús de tu sistema (no los ajustes dentro de la ventana de Claude) y elige Settings….
2. Abre la pestaña Developer y pulsa Edit Config.

Eso abre, o crea, el archivo:

Añade el servidor

Añade una entrada burnbound dentro de mcpServers, con la clave de tu agente (bb_agent_…) del panel de Burnbound. Conserva los servidores que ya haya en el archivo:

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

Guarda el archivo y después cierra Claude Desktop del todo y vuelve a abrirlo. Solo lee el archivo al arrancar.

Comprueba que está conectado

Pulsa el botón Add files, connectors, and more (+) abajo a la izquierda del cuadro de mensaje, pasa el ratón por Connectors y elige Manage connectors. burnbound debería aparecer con sus ocho herramientas: fetch_paid, get_budget, propose_rule, list_payments, get_approval_status, search_paid_apis, diagnose_payment y stripe_refund (que necesita el gateway de acciones y BURNBOUND_GATEWAY_URL en env).

Después pregunta en un chat:

What is my Burnbound budget?

Claude te pide aprobación antes de usar una herramienta, llama a get_budget y te muestra el gasto de hoy, el tope diario y los hosts permitidos.

Haz una petición de pago

Añade el host de un vendedor a los hosts permitidos del agente en el panel y pregunta. Por ejemplo, con Nansen (api.nansen.ai, 0.01 USDC por llamada en Base la última vez que lo verificamos):

Use fetch_paid to POST https://api.nansen.ai/api/v1/profiler/address/current-balance
with the header Content-Type: application/json, the JSON body
{"address": "0x28c6c06298d514db089934071355e5743bf21d60", "chain": "ethereum"},
and maxAmountUsd "0.02". Summarize the balances.

Cada pago se comprueba contra la política del agente antes de firmarse, y aparece en el panel con su transacción. El catálogo de APIs x402 tiene más vendedores verificados, y Claude puede buscar en él con search_paid_apis.

Cuando el servidor no arranca

Claude Desktop escribe los logs de MCP en:

• macOS: ~/Library/Logs/Claude
• Windows: %APPDATA%\Claude\logs

mcp.log tiene los errores de conexión, y mcp-server-burnbound.log los mensajes del propio servidor (su stderr). En macOS, síguelos con:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Para probar el servidor fuera de Claude Desktop, ejecútalo en una terminal con la clave puesta; debería arrancar y quedarse esperando entrada sin imprimir ningún error:

BURNBOUND_KEY=bb_agent_… npx -y @burnbound/mcp@latest

¿Qué modo de cartera encaja con Claude Desktop?

Los dos funcionan. La firma en el cliente deja la clave en tu máquina, y su protección depende de que el agente no pueda leer esa clave. Si además das a Claude Desktop herramientas que ejecutan comandos o leen archivos de tu máquina, se aplica la misma advertencia que con los agentes de programación, y una cartera de Coinbase CDP es la opción más segura. Consulta Carteras de agente: Coinbase CDP o una clave local.

Relacionado

• Primeros pasos: crea el agente, sus topes y su clave.
• Aprobación humana de los pagos de agentes con Slack: haz que los pagos más grandes te esperen.
• Configuración de Claude Code y Cursor.