Saltar al contenido principal

Pagos con agentes de IA: cobros cripto con Claude Code y MCP

· 9 min de lectura
OrcaRail
OrcaRail
Crypto payment rails for web2 apps

Los pagos con agentes de IA pueden significar dos cosas. Una son los agentes que pagan: un asistente de IA compra algo o paga una llamada a una API por su cuenta, con un protocolo de pagos como x402. La otra son los agentes que gestionan los pagos de un negocio: un agente de programación como Claude Code crea un checkout, una suscripción o un producto llamando a una API de pagos a través de un servidor MCP.

OrcaRail hace lo segundo hoy. Su servidor MCP permite que Claude Code, Cursor y Codex creen payment intents y suscripciones cripto que tus clientes pagan en USDC, USDT u otros tokens. Este artículo explica los dos significados, explica qué hace el servidor MCP de OrcaRail y muestra cómo conectarlo de forma segura en un sandbox.

Qué son los pagos con agentes de IA​

Agentes que paganAgentes que gestionan pagos
Qué pasaEl agente paga a un comercio o a una API en nombre de su usuarioEl agente crea checkouts, suscripciones y productos para tu negocio
Quién pagaEl agente, con fondos que su usuario autorizaTu cliente, en un checkout que creó el agente
Se basa enProtocolos de pago como x402, AP2 y ACPUna API de pagos y su servidor MCP
EjemploUn agente paga por cada petición a una API de pago"Crea un enlace de pago de 25 USD en USDC y dámelo"
OrcaRail hoyNo disponibleSí: el servidor @orcarail/mcp

Protocolos de pago para agentes de IA: x402, AP2 y ACP​

Estos protocolos definen cómo paga un agente. Así se describe cada uno, según lo revisado el 11 de noviembre de 2026:

  • x402 se presenta como un estándar abierto y neutral para pagos nativos de internet. Cuando llega una petición sin pago, el servidor responde con HTTP 402 (Payment Required), y el cliente paga y vuelve a intentarlo. El sitio dice que x402 funciona en cadenas EVM y Solana, y que los pagos con stablecoins son el caso de uso principal.
  • AP2, el Agent Payments Protocol, es un protocolo abierto para la economía de agentes que publicó Google (anuncio). Su sitio incluye flujos de ejemplo que pagan con x402.
  • ACP, el Agentic Commerce Protocol, es un estándar abierto para flujos de compra programáticos entre compradores, agentes de IA y empresas.

OrcaRail no ofrece pagos con x402, AP2 ni ACP hoy. Si vendes a personas, sigues necesitando checkouts, suscripciones y webhooks, y un servidor MCP permite que un agente los cree y los gestione por ti.

APIs de pago con servidor MCP para Claude Code​

Un servidor MCP (Model Context Protocol) da a un agente de IA un conjunto de herramientas para una API. OrcaRail publica uno como @orcarail/mcp:

  • Cómo se ejecuta: en local mediante stdio, con Node.js 18 o posterior.
  • Cómo se conecta: con tu clave y secreto de API de OrcaRail, pasados como variables de entorno.
  • Clientes: Claude Code, Cursor, Codex, Claude Desktop y cualquier cliente compatible con servidores MCP por stdio.
  • Qué hace: crea checkouts y suscripciones cripto que se pagan en USDC, USDT y otros tokens, y cada pago se reenvía a tus propias billeteras.

Claude Code lo añade con claude mcp add, como se muestra abajo.

Qué puede hacer el servidor MCP de OrcaRail​

@orcarail/mcp tiene 27 herramientas, con nombres recurso.acción:

GrupoHerramientasNecesita clave de API
Payment intentspayment_intents.create, .retrieve, .update, .confirm, .complete, .cancel, .simulate (solo sandbox)Sí
Suscripcionessubscriptions.create, .retrieve, .update, .cancel, .resume, .list, .list_payment_linksSí
Productosproducts.list, .create, .update, .deleteSí
Preciosprices.list, .create, .update, .deactivateSí
Cuentaaccount.get_modeNo
Tipos de cambiorates.get_fiat_quote, rates.list_currenciesNo
Páginas de pago alojadaspay.get_by_slug, pay.cancel_by_slugNo

Le hablas en lenguaje natural, por ejemplo:

  • "Crea un producto llamado Pro Plan con un precio recurrente de 29 USD al mes."
  • "Lista mis suscripciones activas y cancela la de [email protected] al final del periodo."
  • "¿Cuánto son 500 EUR en USDC ahora mismo?"
  • "¿En qué estado está el payment intent 550e8400-…?"

Los payment intents y los precios necesitan un ID de token y un ID de red (UUID), y el servidor no tiene ninguna herramienta que los liste. Pasa a tu agente los ID de redes y tokens, o usa un precio que ya hayas creado (price_id).

Cómo conectar Claude Code con OrcaRail​

  1. Crea un sandbox. Regístrate en app.orcarail.com, crea una organización sandbox y una clave de API ak_test_ con su secreto. Un sandbox solo funciona en testnets, así que no se mueven fondos reales.

  2. Añade el servidor a Claude Code. Necesita Node.js 18 o posterior. Pasa la clave como variables de entorno, no como parámetros en la línea de comandos:

    claude mcp add orcarail \
      -e ORCARAIL_API_KEY=ak_test_xxx \
      -e ORCARAIL_API_SECRET=sk_test_xxx \
      -- npx -y @orcarail/mcp --tools=all

  3. Compruébalo con claude mcp list. Después pregunta a Claude Code "¿En qué modo de OrcaRail estoy?". Llamará a account.get_mode, que debería devolver sandbox.

  4. Crea un checkout. Por ejemplo: "Crea un payment intent para el precio <price-id> con la URL de retorno https://example.com/thanks, confírmalo y dame el enlace de pago." El agente llama a payment_intents.create y luego a payment_intents.confirm.

  5. Pruébalo. Pide "Simula el pago." La herramienta payment_intents.simulate completa el payment intent sin billetera y envía los webhooks habituales. Los pagos simulados nunca se pueden retirar. Con un pago real, llama a payment_intents.complete cuando el cliente vuelva a tu URL de éxito; hasta entonces el pago no es definitivo.

  6. Limita las herramientas. Cambia --tools=all por solo lo que el agente necesita, por ejemplo --tools=payment_intents.create,payment_intents.retrieve,subscriptions.list, para que no pueda cancelar suscripciones ni borrar productos.

  7. Pasa a producción solo cuando estés listo, con la clave ak_live_ de una organización live. En modo live, el servidor avisa al agente de que hay fondos reales y le pide que te confirme cualquier create, confirm, complete, cancel, update o delete.

¿Usas Cursor o Codex? Añade el mismo comando a .cursor/mcp.json o a ~/.codex/config.toml. La guía del servidor MCP tiene cada archivo de configuración.

Reglas de seguridad para dar acceso de pagos a un agente​

  • Empieza en un sandbox. Una clave ak_test_ solo funciona en testnets. Una clave live mueve fondos reales.
  • Mantén las claves fuera del historial de la terminal y de git. Usa variables de entorno y nunca subas un archivo de configuración con una clave live.
  • Expón solo las herramientas que necesitas con --tools.
  • Comprueba el modo antes de cualquier escritura. account.get_mode devuelve live, sandbox o public.
  • Rota la clave en el dashboard si puede haberse filtrado.

El agente nunca guarda el dinero. Los clientes pagan en la página de pago alojada, y cada pago se reenvía a direcciones de retiro que tú controlas.

Construye el resto de la integración con IA​

El servidor MCP gestiona los pagos. Para construir la integración en tu aplicación, da a tu agente la documentación en texto plano: llms.txt lista todas las páginas, y Construir con IA tiene consejos. Para el código, consulta integración de pasarela de pago y la guía de la API de pagos con stablecoins.

Preguntas frecuentes​

¿Es seguro dar a un agente de IA mi clave de API de pagos?​

Usa una clave sandbox mientras construyes: una clave ak_test_ solo funciona en testnets, así que no se mueven fondos reales. Antes de usar una clave live, limita las herramientas con --tools, guarda la clave en variables de entorno y haz que el agente te confirme cada escritura, algo que el servidor de OrcaRail pide en modo live. Rota cualquier clave que pueda haberse filtrado.

¿Qué APIs de pago tienen un servidor MCP para Claude Code?​

OrcaRail tiene uno: @orcarail/mcp. Claude Code lo añade con claude mcp add, y crea checkouts y suscripciones cripto que se pagan en USDC, USDT y otros tokens. Consulta la guía del servidor MCP.

¿Qué es un protocolo de pagos para agentes de IA?​

Un estándar sobre cómo paga un agente. x402 usa el código de estado HTTP 402 para que un cliente pague una petición y la repita, sobre todo con stablecoins. AP2, publicado por Google, es un protocolo abierto para pagos de agentes. ACP cubre el checkout y el intercambio de credenciales de pago entre agentes y empresas.

¿Puede un agente de IA aceptar pagos cripto para mi negocio?​

Sí, a través de un servidor MCP. Con OrcaRail, el agente crea un payment intent y te da el enlace de la página de pago alojada. Tu cliente paga en USDC, USDT u otro token compatible, y el pago se reenvía a tus billeteras. OrcaRail cobra el 0,5 % por transacción completada, y las primeras 100 son gratis. Consulta los precios.

¿OrcaRail admite x402?​

Hoy no. Las herramientas de OrcaRail para agentes de IA son el servidor MCP y la documentación en texto plano, y los clientes pagan con checkouts alojados y suscripciones.

Empieza en el sandbox · Guía del servidor MCP · Precios