En esta página
Conectar agentes de IA por MCP
Conecta Claude, ChatGPT, Cursor u otro agente de IA a tu negocio en iion pay. Tu agente consulta ventas, cobros y saldos. Si le das permiso, también crea links de cobro y gestiona tu tienda. Ningún agente puede retirar ni enviar dinero.
¿Qué es el conector MCP?
MCP (Model Context Protocol) es un estándar abierto para conectar agentes de IA con servicios externos. iion pay tiene un servidor MCP para negocios. Tu agente lo usa para leer los datos de tu negocio y, con el permiso correcto, para operar.
Con el conector tu agente puede:
- Responder preguntas como «¿Cuánto vendí hoy?» o «¿Qué cobros están pendientes?».
- Crear un cobro y darte el link de pago para tu cliente.
- Gestionar tu tienda: productos, reservas, membresías, eventos, bonos y despachos.
create_charge y membership_renewal_link generan links que tu cliente paga: el dinero entra a tu negocio solo cuando tu cliente paga. business_payout solo consulta el historial de tus retiros. Tampoco cambia tu cuenta bancaria ni tus API Keys.
URL y autenticación
Todos los agentes usan la misma dirección del servidor:
https://mcp.iionpay.com/api/v1/mcp
La conexión usa OAuth 2.1 con registro dinámico de cliente y PKCE (S256). No necesitas crear ni pegar un token:
- Agrega el servidor en tu agente (pasos en Instalar).
- Tu agente abre el navegador. Inicia sesión con tu cuenta de iion pay.
- Elige el negocio y el permiso que le das al agente.
- Pulsa «Autorizar» y vuelve a tu agente.
Para desconectar un agente, entra al panel de negocios de iion pay, sección «Conecta tu IA» (/merchant/connectors). En «Conexiones activas» pulsa «Desconectar». El agente deja de ver los datos del negocio al instante.
Permisos
Al autorizar eliges uno de tres permisos. Cada permiso incluye las herramientas del anterior.
| Permiso | En la pantalla de autorización | Qué permite | Herramientas |
|---|---|---|---|
read-only | Solo consulta | Ve tus ventas, cobros y saldos. No crea nada ni mueve dinero. | 22, todas de lectura |
business-sales | Consulta y ventas | Lo anterior, más crear, consultar y cancelar cobros. | 26 |
business-store | Todos los permisos | Lo anterior, más operar tu tienda y tu catálogo. | 74 |
business-sales el agente crea cobros que tu cliente paga. Con business-store gestiona tu tienda. Ningún permiso envía ni retira dinero. Si un permiso no está disponible para tu negocio, la pantalla de autorización no lo muestra.
Herramientas
Estas son las 74 herramientas del servidor, agrupadas por el permiso mínimo que necesitan. «Destructiva» indica una acción que no se deshace desde el chat.
Con read-only (22)
| Herramienta | Permiso mínimo | Lee o escribe | ¿Mueve dinero? | Para qué sirve |
|---|---|---|---|---|
business_report | read-only | Lee | No | Ventas y libro del negocio en el período. |
business_operations | read-only | Lee | No | Caja, stock bajo, cuentas por cobrar y por pagar. |
business_payin | read-only | Lee | No | Cobros del período por estado, con total por moneda. |
business_profile | read-only | Lee | No | Nombre, estado y verificación del negocio. |
business_balance | read-only | Lee | No | Saldo actual de la cuenta de negocio. |
business_payout | read-only | Lee | No | Historial de retiros a tu banco. Solo consulta: no retira. |
business_webhooks | read-only | Lee | No | Entregas de webhooks del período, por estado. |
business_settlements | read-only | Lee | No | Liquidaciones diarias: bruto, comisión, IVA, neto y reversos. |
business_funds_summary | read-only | Lee | No | Dónde está tu dinero: disponible, en camino, retenido y en revisión. |
business_kyb_status | read-only | Lee | No | Estado de la verificación del negocio (KYB) y motivo de rechazo. |
business_reconciliation | read-only | Lee | No | Conciliación por día: vendido, liquidado, comisión y diferencias. |
business_summary | read-only | Lee | No | Resumen contable de un día, una semana o un mes. |
business_daily_series | read-only | Lee | No | Ingresos, gastos y neto por día en COP, hasta 366 días. |
business_fees_paid | read-only | Lee | No | Comisiones que iion pay te cobró en el período. |
business_apps_metrics | read-only | Lee | No | Ingresos y unidades vendidas por día de cada mini app. |
business_products | read-only | Lee | No | Productos del catálogo con precio y link de pago. |
get_integration_docs | read-only | Lee | No | Esta documentación de integración. No usa datos del negocio. |
store_overview | read-only | Lee | No | Mini apps de la tienda, ventas e ingresos del período. |
store_memberships | read-only | Lee | No | Membresías: miembros activos, cobrado en el mes y renovaciones. |
store_bookings | read-only | Lee | No | Reservas y agenda del rango, sin datos de contacto. |
store_events | read-only | Lee | No | Eventos: entradas vendidas, ingresos y asistencia. |
store_vouchers | read-only | Lee | No | Bonos vendidos, canjeados y vigentes. |
Con business-sales (4 más)
| Herramienta | Permiso mínimo | Lee o escribe | ¿Mueve dinero? | Para qué sirve |
|---|---|---|---|---|
create_charge | business-sales | Escribe | Sí | Crea un cobro y su link de pago. El dinero entra cuando el cliente paga. |
get_charge | business-sales | Lee | No | Consulta un cobro: estado, monto, link y fecha de pago. |
list_charges | business-sales | Lee | No | Lista tus cobros, con filtro por estado. |
cancel_charge | business-sales | Escribe | No | Cancela un cobro pendiente. Un cobro pagado no se cancela. |
Con business-store (48 más)
| Herramienta | Permiso mínimo | Lee o escribe | ¿Mueve dinero? | Para qué sirve |
|---|---|---|---|---|
booking_cancel | business-store | Escribe (destructiva) | No | Cancela una reserva. No reembolsa el anticipo. |
booking_mark_balance_paid | business-store | Escribe | No | Marca como pagado el saldo cobrado en el local. No cobra. |
membership_cancel | business-store | Escribe (destructiva) | No | Cancela una membresía. No reembolsa pagos. |
membership_renewal_link | business-store | Escribe | Sí | Genera un link de renovación que el cliente paga. El dinero entra cuando el cliente paga. |
event_ticket_void | business-store | Escribe (destructiva) | No | Anula una entrada. No reembolsa. |
event_cancel | business-store | Escribe (destructiva) | No | Cancela un evento. No reembolsa las entradas. |
voucher_void | business-store | Escribe (destructiva) | No | Anula un bono de regalo. No reembolsa. |
redemption_lookup | business-store | Lee | No | Busca un código de canje y dice si se puede canjear. |
redemption_consume | business-store | Escribe | No | Canjea un código de bono o entrada. |
order_update_fulfillment | business-store | Escribe | No | Cambia el despacho de un pedido: preparando, enviado o entregado. |
store_catalog | business-store | Lee | No | Mini apps con sus planes, bonos, eventos y servicios. |
app_install | business-store | Escribe | No | Instala una mini app en la tienda publicada. |
app_uninstall | business-store | Escribe (destructiva) | No | Desinstala una mini app de la tienda. |
membership_plan_create | business-store | Escribe | No | Crea un plan de membresía en COP. |
membership_plan_update | business-store | Escribe | No | Edita un plan de membresía. |
membership_plan_archive | business-store | Escribe (destructiva) | No | Archiva un plan: deja de venderse. |
voucher_product_create | business-store | Escribe | No | Crea un bono o paquete de sesiones en COP. |
voucher_product_update | business-store | Escribe | No | Edita un bono. Los bonos vendidos no cambian. |
voucher_product_archive | business-store | Escribe (destructiva) | No | Archiva un bono. Los vendidos siguen válidos. |
voucher_product_image_set | business-store | Escribe | No | Pone o reemplaza la foto de un bono. |
booking_service_create | business-store | Escribe | No | Crea un servicio reservable, sin horario. |
booking_service_update | business-store | Escribe | No | Edita un servicio. No toca horario ni reservas. |
booking_service_archive | business-store | Escribe (destructiva) | No | Archiva un servicio. No cancela reservas. |
booking_service_schedules_set | business-store | Escribe (destructiva) | No | Reemplaza todo el horario semanal del servicio. |
event_create | business-store | Escribe | No | Crea un evento. No crea entradas. |
event_update | business-store | Escribe | No | Edita un evento activo. |
event_archive | business-store | Escribe (destructiva) | No | Archiva un evento: deja de venderse. |
event_image_set | business-store | Escribe | No | Pone o reemplaza la foto del evento. |
event_ticket_type_create | business-store | Escribe | No | Agrega un tipo de entrada con precio y cupo. |
event_ticket_type_update | business-store | Escribe | No | Edita un tipo de entrada. |
event_ticket_type_archive | business-store | Escribe (destructiva) | No | Archiva un tipo de entrada. Las vendidas siguen válidas. |
product_create | business-store | Escribe | No | Crea un producto con página de venta en COP. |
product_update | business-store | Escribe | No | Edita un producto. |
product_archive | business-store | Escribe (destructiva) | No | Archiva un producto: su página deja de vender. |
product_rotate_link | business-store | Escribe (destructiva) | No | Emite un link nuevo. El anterior deja de servir. |
product_image_add | business-store | Escribe | No | Agrega una foto o reemplaza la portada. |
store_draft_list | business-store | Lee | No | Lista los borradores de tienda. |
store_draft_create | business-store | Escribe | No | Crea un borrador de tienda. No la publica. |
store_draft_update | business-store | Escribe | No | Cambia nombre, descripción o web de un borrador. |
store_template_set | business-store | Escribe | No | Elige la plantilla del constructor de tiendas. |
store_brand_set | business-store | Escribe | No | Cambia el logo o la portada de la tienda. |
store_publish | business-store | Escribe (destructiva) | No | Publica el borrador en la dirección elegida. |
store_unpublish | business-store | Escribe (destructiva) | No | Retira la tienda publicada. |
store_credits_balance | business-store | Lee | No | Créditos del constructor de tiendas con IA. |
store_builder_run | business-store | Escribe (destructiva) | No (gasta créditos) | Genera o ajusta la tienda con IA. Gasta créditos ya comprados. |
store_builder_job_status | business-store | Lee | No | Estado de un trabajo del constructor con IA. |
image_upload_link_create | business-store | Escribe | No | Enlace de un solo uso para subir una foto. Vence en 10 minutos. |
image_upload_status | business-store | Lee | No | Estado de un enlace de subida de foto. |
Instalar en tu agente
Usa siempre la URL https://mcp.iionpay.com/api/v1/mcp. Al terminar, tu agente te pide iniciar sesión en iion pay para autorizar la conexión.
Claude
iion pay está en el directorio de conectores de Claude: claude.ai/directory/iion-pay. Ábrelo y pulsa «Conectar». También puedes agregarlo a mano en Claude web o de escritorio:
- Abre Ajustes.
- Entra en Conectores.
- Pulsa «Añadir conector personalizado».
- Pega la URL del servidor MCP de iion pay y guarda.
ChatGPT
La interfaz de ChatGPT está en inglés. Sigue estos pasos:
- Abre chatgpt.com/plugins.
- Pulsa «Add» y elige «Add custom MCP server».
- Ponle de nombre «iion pay» y pega la URL del servidor MCP de iion pay.
- Deja la autenticación en «OAuth», marca «I understand and want to continue» y pulsa «Create».
- Pulsa «Continue to iion pay» y autoriza en tu panel.
Claude Code
Ejecuta en tu terminal:
claude mcp add --transport http iion-pay https://mcp.iionpay.com/api/v1/mcp
Después escribe /mcp en Claude Code para autenticarte con iion pay.
Cursor
- Abre este enlace con Cursor instalado: Instalar iion pay en Cursor.
- Confirma la instalación en Cursor.
- Cuando Cursor lo pida, inicia sesión en iion pay y autoriza.
VS Code
Copia el comando y pégalo en tu terminal:
code --add-mcp '{"name":"iion-pay","type":"http","url":"https://mcp.iionpay.com/api/v1/mcp"}'
Codex
Copia el comando y pégalo en tu terminal:
codex mcp add iion-pay --url https://mcp.iionpay.com/api/v1/mcp
Windsurf
Copia este JSON en la configuración MCP de Windsurf:
{
"mcpServers": {
"iion-pay": {
"serverUrl": "https://mcp.iionpay.com/api/v1/mcp"
}
}
}
Gemini CLI
Copia el comando y pégalo en tu terminal:
gemini mcp add --transport http iion-pay https://mcp.iionpay.com/api/v1/mcp
WhatsApp y Telegram
En WhatsApp y Telegram no usas MCP. Ahí hablas con Niia, el asistente de iion pay, sobre tu negocio. La conexión se hace desde el panel de negocios, sección «Conecta tu IA»:
- WhatsApp: pide un código en el panel y envíalo a Niia por WhatsApp. El código sirve una sola vez y caduca en pocos minutos.
- Telegram: pulsa «Conectar Telegram». Se abre el chat del bot con tu código listo. Pulsa «Iniciar».
Un WhatsApp o un Telegram solo puede estar conectado a una cuenta. Si lo conectas a tu negocio, deja de responder por tu cuenta personal. Puedes desconectarlo desde la misma sección.
Cómo leen esta documentación los agentes
Si un agente te ayuda a integrar iion pay, puede leer esta documentación en texto plano:
- https://pay.iionpay.com/llms.txt: índice de las páginas, con un resumen de cada una.
- https://pay.iionpay.com/llms-full.txt: la documentación completa en Markdown.
- La herramienta
get_integration_docsdel servidor MCP: devuelve esta documentación al agente conectado. Sintopic, devuelve el índice de secciones. No usa datos de tu negocio.
Seguridad
- Empieza con
read-only. Dabusiness-salesobusiness-storesolo cuando el agente lo necesite. - El rol en el negocio limita el permiso. Cualquier miembro con acceso de lectura puede autorizar
read-only.business-salesexige un rol que pueda crear cobros: dueño, administrador u operador.business-storeexige un rol que pueda editar el negocio: dueño o administrador. - Revoca cuando quieras. En «Conecta tu IA», «Conexiones activas» muestra el último uso y la actividad de cada agente. «Desconectar» corta el acceso al instante.
- Topes en los cobros. iion pay limita el monto máximo de cada cobro (en COP y en USD) y la cantidad de cobros por hora de cada conexión. También limita las escrituras de catálogo por hora.
- Confirmación en acciones delicadas. Publicar la tienda y cambiar el link de un producto exigen confirmación explícita. Generar la tienda con IA exige tu consentimiento porque gasta créditos.
- Tus datos pasan por tu agente. Lo que consultes pasa por los servidores del proveedor de tu agente para que te pueda responder. iion pay nunca comparte tu contraseña ni tu PIN.