¿Cómo lo conecto a Claude, ChatGPT o Cursor?

Agrega un servidor MCP remoto con la URL de pruebas o en vivo. Si el cliente admite OAuth, elige esa opción: iniciarás sesión y revisarás permisos en la pantalla de consentimiento. Si no, usa una clave API como Bearer. La configuración exacta cambia por cliente; nunca pongas la clave en el prompt.

OAuth es el canal pensado para agentes: el usuario autoriza y puede revocar el acceso en /agent-access. La clave API (sk_test_… o sk_live_…) sirve para servidores y clientes que solo aceptan un Bearer estático. La clave se muestra una sola vez en el dashboard.

¿Hay sesiones o secretos en las herramientas?

No. El servidor es stateless (POST, Streamable HTTP). Las herramientas no devuelven claves, tokens de Stripe ni secretos. list_connections solo muestra metadatos del proveedor.

Model Context Protocol

Cobra desde tu agente

El MCP de Pagos Express es el mismo producto que el dashboard y la API: enlaces de pago, seguimiento y correo. El agente propone el cobro; tu cliente paga en la página.

Crear cuenta Qué es un MCP de pagos

Cómo conectar

Crea una cuenta y, en el dashboard, abre API y MCP. Ahí está la URL del entorno que tengas seleccionado.
En Claude, ChatGPT, Cursor u otro cliente MCP, agrega un servidor remoto. URL de pruebas: https://api.pagos.express/mcp/test. En vivo: https://api.pagos.express/mcp.
Prefiere OAuth si el cliente lo admite: inicias sesión y ves qué puede hacer el agente (incluido el envío de correo). Si no, usa una clave sk_test_… o sk_live_… como Authorization: Bearer.
El entorno lo define la credencial, no un argumento de la herramienta. Una clave de prueba no opera en vivo.

Herramientas

Doce herramientas, las mismas operaciones que REST. Ninguna inicia un checkout ni reembolsa. Los importes van en centavos enteros (MX$1,500.00 = 150000).

Herramienta	REST	Para qué sirve
create_payment_link	POST /v1/payment_links	Crea un cobro con conceptos e importes. Devuelve la URL para compartir; no cobra ni envía correo por sí solo.
list_payment_links	GET /v1/payment_links	Lista los enlaces del entorno actual, con paginación por cursor.
get_payment_link	GET /v1/payment_links/{id}	Consulta un enlace y su estado.
disable_payment_link	POST /v1/payment_links/{id}/disable	Desactiva un enlace. No reembolsa pagos ya cobrados.
update_payment_link	POST /v1/payment_links/{id}	Edita título, descripción, datos del cliente o si es facturable un enlace activo. Conceptos e importes no cambian.
mark_payment_link_paid	POST /v1/payment_links/{id}/mark_paid	Registra un pago recibido fuera del checkout (transferencia, efectivo). Cierra el enlace y dispara los webhooks. Pide confirmación al usuario.
list_payments	GET /v1/payments	Lista pagos. Solo el estado succeeded confirma fondos recibidos.
get_payment	GET /v1/payments/{id}	Consulta el estado de un pago concreto.
sync_payment	POST /v1/payments/{id}/sync	Verifica el pago con su pasarela y actualiza el estado.
send_payment_link_email	POST /v1/payment_links/{id}/email	Envía el enlace por correo si el usuario lo autoriza. En pruebas no se entrega correo real.
list_payment_link_emails	GET /v1/payment_links/{id}/emails	Consulta las últimas entregas de correo de un enlace.
list_connections	GET /v1/connections	Lista proveedores conectados. No expone credenciales.
get_invoicing_connection	GET /v1/invoicing/connection	Consulta la conexión con CFDI Express y el emisor (RFC) que factura.
get_invoicing_catalogs	GET /v1/invoicing/catalogs	Catálogos SAT de régimen fiscal y uso de CFDI para validar los datos del receptor.
get_payment_invoice	GET /v1/payments/{id}/invoice	Consulta si un pago se puede facturar, el enlace de autofacturación y su factura.
invoice_payment	POST /v1/payments/{id}/invoice	Timbra el CFDI de un pago con los datos fiscales del cliente. Confirma los datos con el usuario.
get_payment_invoice_files	GET /v1/payments/{id}/invoice/files	Devuelve el PDF y el XML de la factura (enlaces que caducan en 15 minutos).
cancel_payment_invoice	POST /v1/payments/{id}/invoice/cancel	Pide al SAT cancelar la factura de un pago. Pide autorización al usuario; no reembolsa.

OAuth para agentes

El usuario revisa el cliente, el entorno (pruebas o en vivo) y los permisos. Puedes revocar el acceso cuando quieras. Los tokens no sustituyen las cookies del dashboard.

Clave API

Úsala en un servidor o en la config secreta del cliente MCP. Nunca en un chat, un repo o el navegador del pagador. Se muestra una sola vez al crearla.

Prueba el MCP en modo test

El modo de pruebas es gratis y no mueve dinero real. Cuando conectes Stripe o eCart Pay y actives en vivo, usa /mcp.

Crear cuenta Prefiero REST

Preguntas frecuentes

¿Qué es un MCP de pagos?: MCP (Model Context Protocol) es un protocolo para que un agente de IA use herramientas de un servidor remoto. El MCP de Pagos Express expone crear y consultar enlaces de pago, revisar cobros, sincronizar con Stripe y enviar el link por correo. El agente no procesa tarjetas: tu cliente paga en la página pública.
¿Cómo lo conecto a Claude, ChatGPT o Cursor?: Agrega un servidor MCP remoto con la URL de pruebas o en vivo. Si el cliente admite OAuth, elige esa opción: iniciarás sesión y revisarás permisos en la pantalla de consentimiento. Si no, usa una clave API como Bearer. La configuración exacta cambia por cliente; nunca pongas la clave en el prompt.
¿OAuth o clave API?: OAuth es el canal pensado para agentes: el usuario autoriza y puede revocar el acceso en /agent-access. La clave API (sk_test_… o sk_live_…) sirve para servidores y clientes que solo aceptan un Bearer estático. La clave se muestra una sola vez en el dashboard.
¿Hay sesiones o secretos en las herramientas?: No. El servidor es stateless (POST, Streamable HTTP). Las herramientas no devuelven claves, tokens de Stripe ni secretos. list_connections solo muestra metadatos del proveedor.