Docs · IA y MCP Descargar .md

Conecta QuickPay a tu IA (MCP)

Con el servidor MCP de QuickPay, tu asistente de IA (Claude, ChatGPT, Claude Code, Cursor u otro compatible con MCP) crea y consulta tus enlaces de cobro cuando se lo pides con tus palabras: "Cobra Bs 1.500 por el pedido 1024", "¿Qué cobros tengo pendientes?".

No copias ninguna llave: pegas la dirección del servidor, entras con el correo de tu comercio y autorizas.

text

https://mcp.pagaconquickpay.com/mcp

Para leerlo o compartirlo: Guía esencial del MCP en PDF.

Qué puede hacer tu IA

Casi todo lo de la API pública: lo que no puede está en la sección siguiente.

Herramienta	Qué hace	Prueba	Producción
`crear_link_cobro`	Crea un enlace de cobro con monto y concepto (opcional: `moneda`, `expira_horas`, `expira_en`, `idempotency_key`, `success_url`, `metadata`). Crearlo no mueve dinero: el cobro ocurre sólo si alguien lo paga.	Sí	Sí
`listar_cobros`	Lista tus enlaces, los más recientes primero (20 por omisión, hasta 50 por página). Filtra por estado, fechas, montos o texto (concepto, nombre de quien pagó, referencia bancaria o id).	Sí	Sí
`ver_cobro`	Muestra un enlace por su id: monto, estado, cuándo se pagó y el código del comprobante.	Sí	Sí
`cancelar_link`	Cancela un enlace que sigue pendiente. Uno pagado o en proceso de pago no se cancela.	Sí	Sí
`simular_cobro`	Fuerza el resultado de un enlace de prueba (`pagado`, `rechazado` o `expirado`). → Modo prueba	Sí	No
`crear_lote`	Crea hasta 500 enlaces de una vez. → Cobro por lote	Sí	Sí
`listar_lotes` · `ver_lote`	Tus lotes con su resumen, o uno con el estado de cada enlace.	Sí	Sí
`cancelar_lote`	Cancela los enlaces de un lote que siguen pendientes.	Sí	Sí
`verificar_comprobante`	Comprueba un comprobante por su código `QP-XXXXX-XXXXX`.	Sí	Sí
`consultar_estado`	Dice si un pago está confirmado, por el id de la transacción (el `txn_id` de un enlace pagado): `LIQUIDADA`, `ACEPTADA` (en proceso) o `RECHAZADA`.	Sí	Sí
`listar_liquidaciones`	Tus liquidaciones.	Sí	Sí
`listar_bancos`	Los bancos desde los que tus clientes pueden pagarte (código y nombre).	Sí	Sí
`mi_conexion`	Con qué comercio y en qué modo está conectada.	Sí	Sí
`listar_llaves`	Tus llaves de API, enmascaradas.	Sí	Sí
`crear_llave` · `revocar_llave`	Crea o revoca una llave de prueba (`sk_test`). La llave completa se muestra una sola vez. → Llaves y entornos	Sí	No: desde el portal
`listar_webhooks` · `ver_webhook` · `ver_entregas_webhook`	Tus webhooks (sin el secreto) y sus últimas entregas.	Sí	Sí

Webhooks: tu IA sólo los ve. Registrarlos, cambiarlos o borrarlos se hace desde el portal › Integraciones. → Webhooks

En producción, las llaves también sólo se ven: crearlas o revocarlas se hace desde el portal › Integraciones. Si se lo pides a tu IA, QuickPay responde 403 solo_desde_el_portal y tu IA te lo dice.

Las herramientas que cambian algo (cancelar, simular, llaves) van marcadas para que tu IA te pida confirmación antes de usarlas.

Qué no puede hacer

Tu IA no puede enviar, pagar, transferir ni devolver dinero, ni sacar dinero de ninguna cuenta. Tampoco puede ver tus movimientos o tu saldo, cambiar tus datos o tu cuenta bancaria, registrar o cambiar webhooks, ni, en producción, crear o revocar llaves (eso se hace en el portal). Esas herramientas no existen en el servidor MCP y, además, QuickPay rechaza (403) cualquier otra operación hecha con el acceso de una IA, aunque alguien intente usarlo fuera del MCP.

Cómo se conecta

Agregas QuickPay en tu IA con la dirección de arriba (los pasos de cada una están más abajo).
Tu IA abre una página de QuickPay en el navegador. Escribe el correo de tu comercio, el mismo con el que entras al portal, y te llega un enlace de acceso.
Abre el enlace en el mismo navegador donde empezaste. Expira en 15 minutos y es de un solo uso.
Revisa qué podrá hacer la IA, elige el comercio (si tienes varios) y el modo, y toca Autorizar.

Modo prueba o producción

Modo	Qué pasa
Prueba (por omisión)	Los enlaces son de prueba: nadie paga dinero real. Igual que con tu llave `sk_test`. → Modo prueba
Producción	Los enlaces cobran dinero real a quien los pague. Llaves y webhooks sólo se ven (se manejan desde el portal). Sólo se puede elegir si tu cuenta ya está aprobada y la aplicación es conocida (Claude, ChatGPT, Cursor o una de línea de comandos como Claude Code).

Si la página dice Aplicación no verificada, la aplicación que pidió el acceso no vuelve a una de las conocidas: sólo se puede conectar en modo prueba. Autoriza sólo si reconoces la dirección que aparece en "Volverá a".

Para cambiar de modo, quita el conector y vuelve a conectarlo eligiendo el otro.

Claude

En Claude (web o escritorio), agrega un conector personalizado con la dirección https://mcp.pagaconquickpay.com/mcp, ponle de nombre QuickPay y conéctalo: se abre la página de QuickPay para entrar y autorizar.

ChatGPT

En la configuración de ChatGPT, en Conectores, crea un conector con la dirección https://mcp.pagaconquickpay.com/mcp y autenticación OAuth. Al conectarlo se abre la página de QuickPay para entrar y autorizar. Los conectores personalizados dependen de tu plan de ChatGPT.

Claude Code

bash

claude mcp add --transport http quickpay https://mcp.pagaconquickpay.com/mcp

Luego, dentro de Claude Code, escribe /mcp, elige quickpay y autentícate: se abre el navegador para entrar y autorizar.

Cursor

Agrega esto a ~/.cursor/mcp.json (si ya tienes otros servidores, suma sólo quickpay dentro de mcpServers):

json

{
  "mcpServers": {
    "quickpay": { "url": "https://mcp.pagaconquickpay.com/mcp" }
  }
}

Cuando Cursor lo pida, entra y autoriza en el navegador.

Ejemplos

Lo que le pides a tu IA y lo que hace. Tu IA redacta la respuesta a su manera; los datos salen de QuickPay.

Le dices	Usa	Te responde
"Cobra Bs 1.500 por el pedido 1024"	`crear_link_cobro`	El enlace (`https://pay.pagaconquickpay.com/l/…`) para mandárselo a tu cliente, con el monto, el concepto y hasta cuándo vale (24 horas si no le dices otra cosa).
"¿Qué cobros tengo pendientes?"	`listar_cobros`	Tus enlaces pendientes, del más reciente al más viejo, con monto y concepto.
"¿Ya pagaron el pedido 1024?"	`listar_cobros` / `ver_cobro`	Busca el enlace por el concepto y te dice su estado: `pendiente`, `procesando`, `pagado`, `expirado` o `cancelado`; si está pagado, cuándo.
"Cancela el enlace del pedido 1024"	`cancelar_link`	Que quedó `cancelado` y ya no se puede pagar. Si alguien ya lo pagó o lo está pagando, te dice que no se puede.
"¿Con qué bancos me pueden pagar?"	`listar_bancos`	La lista de bancos desde los que tus clientes pueden pagarte.
"¿Qué liquidaciones tengo?"	`listar_liquidaciones`	Tus liquidaciones con su estado y monto.
"¿Estás en modo prueba?"	`mi_conexion`	Tu comercio y si la conexión es de prueba o de producción.
"Crea un lote con estas 3 facturas: …"	`crear_lote`	El lote con un enlace por factura.
"Simula que pagaron el enlace de prueba"	`simular_cobro`	Que el enlace de prueba quedó `pagado` (en producción no se puede).
"¿Qué webhooks tengo?"	`listar_webhooks`	Tus webhooks con su URL, eventos y estado.
"Crea una llave de prueba para mi servidor"	`crear_llave`	La llave `sk_test_…` completa, una sola vez.
"¿Es auténtico el comprobante QP-…?"	`verificar_comprobante`	Si es válido, con el monto y la fecha del pago.

Seguridad

Para quitarle el acceso a tu IA, quita el conector en tu IA (en Claude Code: claude mcp remove quickpay). Para volver a conectarla tienes que entrar y autorizar de nuevo.
El acceso de la IA vale para un solo comercio y un solo modo, los que elegiste al autorizar.
Una llave de prueba creada desde tu IA sigue funcionando aunque quites el conector. Revócala con revocar_llave o en tu portal › Integraciones › Llaves de API cuando ya no la uses.
QuickPay no guarda los accesos en claro: guarda una huella que sólo sirve para comprobarlos.
Si tu comercio se suspende, o el correo deja de ser el contacto verificado del comercio, el acceso se corta en el acto.
Si alguien intenta conectarse con tu correo, el enlace te llega a ti y sólo funciona en el navegador donde se empezó la conexión: abierto en el tuyo, no le da acceso a nadie. Si no fuiste tú, ignora el correo.

Con tu llave, sin iniciar sesión

Si tu herramienta no soporta el inicio de sesión de MCP (OAuth), puedes mandar tu llave en un header. La IA tiene entonces el modo de la llave (sk_test = prueba, sk_live = producción) y las mismas herramientas de arriba.

bash

claude mcp add --transport http quickpay https://mcp.pagaconquickpay.com/mcp --header "x-switch-key: <comercio>:<tu_llave>"

Con este método la llave queda guardada en la configuración de tu herramienta. Usa la de prueba mientras pruebas y revócala en tu portal › Integraciones › Llaves de API si se expone. Con el inicio de sesión no hay llave que cuidar.

Detalles técnicos

Para quien construye su propio cliente MCP. El servidor sigue la especificación de autorización de MCP (2025-06-18):


Recurso protegido (RFC 9728)	`https://mcp.pagaconquickpay.com/.well-known/oauth-protected-resource`
Servidor de autorización (RFC 8414)	`https://mcp.pagaconquickpay.com/.well-known/oauth-authorization-server`
Registro de clientes (RFC 7591)	`POST /oauth/register`
Autorización	`GET /oauth/authorize`: código de autorización con PKCE `S256` obligatorio
Tokens	`POST /oauth/token`: `authorization_code` y `refresh_token`
Revocación (RFC 7009)	`POST /oauth/revoke`

/mcp sin token responde 401 con WWW-Authenticate: Bearer resource_metadata="…".
Las redirect_uri tienen que ser https://, o http://localhost / http://127.0.0.1 para aplicaciones de línea de comandos (en esas el puerto puede cambiar). Sin fragmento. Con una que no sea de claude.ai, claude.com, chatgpt.com, Cursor o loopback, sólo se autoriza modo prueba.
Scope: cobros (el único).
El token de acceso dura 1 hora; el refresh_token dura 30 días y cambia en cada uso. Si un refresh_token ya usado se presenta otra vez, se revoca la autorización completa.
Si tu comercio se suspende, o el correo deja de ser el contacto verificado del comercio, el acceso se corta en el acto. Si el correo deja de ser el contacto verificado del comercio, se corta al vencer el token de acceso (a más tardar en una hora).
Un enlace de acceso por intento de conexión, y hasta 5 por correo cada 10 minutos.
Hasta 60 llamadas a herramientas por minuto por conexión y 120 por comercio; los listados devuelven hasta 50 resultados por página.
Las herramientas devuelven sólo los campos documentados de cada respuesta (glosario); un error llega como error (código) y mensaje.