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.
Lo que el conector no hace
Ninguna herramienta envía, retira ni transfiere dinero. 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:

Servidor MCP de iion pay
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:

  1. Agrega el servidor en tu agente (pasos en Instalar).
  2. Tu agente abre el navegador. Inicia sesión con tu cuenta de iion pay.
  3. Elige el negocio y el permiso que le das al agente.
  4. 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.

PermisoEn la pantalla de autorizaciónQué permiteHerramientas
read-onlySolo consultaVe tus ventas, cobros y saldos. No crea nada ni mueve dinero.22, todas de lectura
business-salesConsulta y ventasLo anterior, más crear, consultar y cancelar cobros.26
business-storeTodos los permisosLo anterior, más operar tu tienda y tu catálogo.74
Ningún permiso mueve dinero de tu cuenta
Con 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)

HerramientaPermiso mínimoLee o escribe¿Mueve dinero?Para qué sirve
business_reportread-onlyLeeNoVentas y libro del negocio en el período.
business_operationsread-onlyLeeNoCaja, stock bajo, cuentas por cobrar y por pagar.
business_payinread-onlyLeeNoCobros del período por estado, con total por moneda.
business_profileread-onlyLeeNoNombre, estado y verificación del negocio.
business_balanceread-onlyLeeNoSaldo actual de la cuenta de negocio.
business_payoutread-onlyLeeNoHistorial de retiros a tu banco. Solo consulta: no retira.
business_webhooksread-onlyLeeNoEntregas de webhooks del período, por estado.
business_settlementsread-onlyLeeNoLiquidaciones diarias: bruto, comisión, IVA, neto y reversos.
business_funds_summaryread-onlyLeeNoDónde está tu dinero: disponible, en camino, retenido y en revisión.
business_kyb_statusread-onlyLeeNoEstado de la verificación del negocio (KYB) y motivo de rechazo.
business_reconciliationread-onlyLeeNoConciliación por día: vendido, liquidado, comisión y diferencias.
business_summaryread-onlyLeeNoResumen contable de un día, una semana o un mes.
business_daily_seriesread-onlyLeeNoIngresos, gastos y neto por día en COP, hasta 366 días.
business_fees_paidread-onlyLeeNoComisiones que iion pay te cobró en el período.
business_apps_metricsread-onlyLeeNoIngresos y unidades vendidas por día de cada mini app.
business_productsread-onlyLeeNoProductos del catálogo con precio y link de pago.
get_integration_docsread-onlyLeeNoEsta documentación de integración. No usa datos del negocio.
store_overviewread-onlyLeeNoMini apps de la tienda, ventas e ingresos del período.
store_membershipsread-onlyLeeNoMembresías: miembros activos, cobrado en el mes y renovaciones.
store_bookingsread-onlyLeeNoReservas y agenda del rango, sin datos de contacto.
store_eventsread-onlyLeeNoEventos: entradas vendidas, ingresos y asistencia.
store_vouchersread-onlyLeeNoBonos vendidos, canjeados y vigentes.

Con business-sales (4 más)

HerramientaPermiso mínimoLee o escribe¿Mueve dinero?Para qué sirve
create_chargebusiness-salesEscribeSíCrea un cobro y su link de pago. El dinero entra cuando el cliente paga.
get_chargebusiness-salesLeeNoConsulta un cobro: estado, monto, link y fecha de pago.
list_chargesbusiness-salesLeeNoLista tus cobros, con filtro por estado.
cancel_chargebusiness-salesEscribeNoCancela un cobro pendiente. Un cobro pagado no se cancela.

Con business-store (48 más)

HerramientaPermiso mínimoLee o escribe¿Mueve dinero?Para qué sirve
booking_cancelbusiness-storeEscribe (destructiva)NoCancela una reserva. No reembolsa el anticipo.
booking_mark_balance_paidbusiness-storeEscribeNoMarca como pagado el saldo cobrado en el local. No cobra.
membership_cancelbusiness-storeEscribe (destructiva)NoCancela una membresía. No reembolsa pagos.
membership_renewal_linkbusiness-storeEscribeSíGenera un link de renovación que el cliente paga. El dinero entra cuando el cliente paga.
event_ticket_voidbusiness-storeEscribe (destructiva)NoAnula una entrada. No reembolsa.
event_cancelbusiness-storeEscribe (destructiva)NoCancela un evento. No reembolsa las entradas.
voucher_voidbusiness-storeEscribe (destructiva)NoAnula un bono de regalo. No reembolsa.
redemption_lookupbusiness-storeLeeNoBusca un código de canje y dice si se puede canjear.
redemption_consumebusiness-storeEscribeNoCanjea un código de bono o entrada.
order_update_fulfillmentbusiness-storeEscribeNoCambia el despacho de un pedido: preparando, enviado o entregado.
store_catalogbusiness-storeLeeNoMini apps con sus planes, bonos, eventos y servicios.
app_installbusiness-storeEscribeNoInstala una mini app en la tienda publicada.
app_uninstallbusiness-storeEscribe (destructiva)NoDesinstala una mini app de la tienda.
membership_plan_createbusiness-storeEscribeNoCrea un plan de membresía en COP.
membership_plan_updatebusiness-storeEscribeNoEdita un plan de membresía.
membership_plan_archivebusiness-storeEscribe (destructiva)NoArchiva un plan: deja de venderse.
voucher_product_createbusiness-storeEscribeNoCrea un bono o paquete de sesiones en COP.
voucher_product_updatebusiness-storeEscribeNoEdita un bono. Los bonos vendidos no cambian.
voucher_product_archivebusiness-storeEscribe (destructiva)NoArchiva un bono. Los vendidos siguen válidos.
voucher_product_image_setbusiness-storeEscribeNoPone o reemplaza la foto de un bono.
booking_service_createbusiness-storeEscribeNoCrea un servicio reservable, sin horario.
booking_service_updatebusiness-storeEscribeNoEdita un servicio. No toca horario ni reservas.
booking_service_archivebusiness-storeEscribe (destructiva)NoArchiva un servicio. No cancela reservas.
booking_service_schedules_setbusiness-storeEscribe (destructiva)NoReemplaza todo el horario semanal del servicio.
event_createbusiness-storeEscribeNoCrea un evento. No crea entradas.
event_updatebusiness-storeEscribeNoEdita un evento activo.
event_archivebusiness-storeEscribe (destructiva)NoArchiva un evento: deja de venderse.
event_image_setbusiness-storeEscribeNoPone o reemplaza la foto del evento.
event_ticket_type_createbusiness-storeEscribeNoAgrega un tipo de entrada con precio y cupo.
event_ticket_type_updatebusiness-storeEscribeNoEdita un tipo de entrada.
event_ticket_type_archivebusiness-storeEscribe (destructiva)NoArchiva un tipo de entrada. Las vendidas siguen válidas.
product_createbusiness-storeEscribeNoCrea un producto con página de venta en COP.
product_updatebusiness-storeEscribeNoEdita un producto.
product_archivebusiness-storeEscribe (destructiva)NoArchiva un producto: su página deja de vender.
product_rotate_linkbusiness-storeEscribe (destructiva)NoEmite un link nuevo. El anterior deja de servir.
product_image_addbusiness-storeEscribeNoAgrega una foto o reemplaza la portada.
store_draft_listbusiness-storeLeeNoLista los borradores de tienda.
store_draft_createbusiness-storeEscribeNoCrea un borrador de tienda. No la publica.
store_draft_updatebusiness-storeEscribeNoCambia nombre, descripción o web de un borrador.
store_template_setbusiness-storeEscribeNoElige la plantilla del constructor de tiendas.
store_brand_setbusiness-storeEscribeNoCambia el logo o la portada de la tienda.
store_publishbusiness-storeEscribe (destructiva)NoPublica el borrador en la dirección elegida.
store_unpublishbusiness-storeEscribe (destructiva)NoRetira la tienda publicada.
store_credits_balancebusiness-storeLeeNoCréditos del constructor de tiendas con IA.
store_builder_runbusiness-storeEscribe (destructiva)No (gasta créditos)Genera o ajusta la tienda con IA. Gasta créditos ya comprados.
store_builder_job_statusbusiness-storeLeeNoEstado de un trabajo del constructor con IA.
image_upload_link_createbusiness-storeEscribeNoEnlace de un solo uso para subir una foto. Vence en 10 minutos.
image_upload_statusbusiness-storeLeeNoEstado 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:

  1. Abre Ajustes.
  2. Entra en Conectores.
  3. Pulsa «Añadir conector personalizado».
  4. Pega la URL del servidor MCP de iion pay y guarda.

ChatGPT

La interfaz de ChatGPT está en inglés. Sigue estos pasos:

  1. Abre chatgpt.com/plugins.
  2. Pulsa «Add» y elige «Add custom MCP server».
  3. Ponle de nombre «iion pay» y pega la URL del servidor MCP de iion pay.
  4. Deja la autenticación en «OAuth», marca «I understand and want to continue» y pulsa «Create».
  5. Pulsa «Continue to iion pay» y autoriza en tu panel.

Claude Code

Ejecuta en tu terminal:

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

  1. Abre este enlace con Cursor instalado: Instalar iion pay en Cursor.
  2. Confirma la instalación en Cursor.
  3. Cuando Cursor lo pida, inicia sesión en iion pay y autoriza.

VS Code

Copia el comando y pégalo en tu terminal:

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:

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:

Configuración MCP
{
  "mcpServers": {
    "iion-pay": {
      "serverUrl": "https://mcp.iionpay.com/api/v1/mcp"
    }
  }
}

Gemini CLI

Copia el comando y pégalo en tu terminal:

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:

Seguridad

  • Empieza con read-only. Da business-sales o business-store solo cuando el agente lo necesite.
  • El rol en el negocio limita el permiso. Cualquier miembro con acceso de lectura puede autorizar read-only. business-sales exige un rol que pueda crear cobros: dueño, administrador u operador. business-store exige 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.