Conectar tu agente de IA

Todos los agentes se conectan al mismo servidor y con el mismo flujo: se agrega un servidor MCP remoto con la URL de Tilopay y la sesión se autoriza en el navegador. Lo único que cambia entre agentes es dónde se agrega.

https://mcp.tilopay.com/mcp

Antes de conectar#

1. El acceso no es autoservicio: el comercio lo solicita en el formulario del servidor MCP y Tilopay crea un usuario dedicado, asociado a un comercio.
2. Ese usuario recibe una invitación por correo y define su contraseña. Es la cuenta con la que se inicia sesión al autorizar el agente.
3. Revisá qué puede hacer un agente antes de conectarlo, sobre todo las herramientas marcadas como sensibles.

Claude#

Claude soporta conectores remotos, tanto en la app de escritorio como en la web.

1. Agregá un conector personalizado remoto con la URL del servidor.
2. Claude abre la pantalla de autorización de Tilopay: iniciá sesión con el usuario del MCP.
3. Revisá la pantalla de consentimiento (aplicación que pide acceso, URL de retorno y permisos) y aprobá.
4. Al volver a la conversación, las herramientas de Tilopay quedan disponibles.

No hay que pegar ningún token: el conector se registra solo.

ChatGPT#

ChatGPT se conecta como conector remoto usando la misma URL.

1. Agregá el servidor como conector remoto con la URL de arriba.
2. La autorización se completa en el navegador con el usuario del MCP.
3. Al aprobar, el conector queda activo y el modelo puede llamar las herramientas.

GitHub Copilot y VS Code#

En VS Code (con Copilot en modo agente) se declara un servidor MCP remoto de tipo HTTP.

1. Declará el servidor con la URL, sin token ni credenciales en el archivo de configuración.
2. Al primer uso, el editor abre el navegador para autorizar.
3. Después de aprobar, las herramientas aparecen en la lista de herramientas del agente.

Cursor y otros editores#

Cursor y editores equivalentes usan el mismo esquema: un servidor MCP remoto por HTTP.

1. Agregá el servidor remoto con la URL, sin token en la configuración.
2. Autorizá en el navegador cuando el editor lo pida.
3. Habilitá las herramientas para el chat o el agente del editor.

Gemini#

Los clientes de Gemini que soportan MCP remoto se conectan igual: se registra la URL del servidor y la autorización ocurre en el navegador. Si el cliente sólo soporta servidores MCP locales por stdio, se requiere un puente que hable Streamable HTTP contra la URL de Tilopay.

Otros clientes MCP#

Para un cliente propio o cualquier otro agente, el requisito es soportar transporte Streamable HTTP y OAuth 2.0 con registro dinámico de cliente. La secuencia es:

1. El cliente llama al servidor y recibe un 401 con WWW-Authenticate, que apunta a /.well-known/oauth-protected-resource.
2. El cliente descubre los endpoints del proveedor de identidad.
3. Se registra dinámicamente y abre la pantalla de autorización.
4. El usuario inicia sesión y aprueba el consentimiento.
5. El cliente queda conectado con authorization_code y refresh_token.

Lo único que se configura es la URL del servidor.

Verificar la conexión#

Pedile al agente que liste las herramientas disponibles: deberían aparecer las de Tilopay agrupadas en ventas y transacciones, enlaces de pago, catálogo, contactos, cobros recurrentes, tarjetas guardadas y cobros masivos y soporte y diagnóstico.

Una primera prueba segura es una consulta de sólo lectura, por ejemplo pedir las transacciones de un rango de fechas. Para flujos completos mirá las recetas.

Si algo falla#

• El cliente no abre la autorización: revisá que el servidor esté declarado como remoto por HTTP y no como servidor local.
• La autorización no termina: la sesión se inicia con el usuario dedicado del MCP, no con el usuario del panel de Tilopay.
• El agente no ve herramientas: en varios clientes hay que habilitarlas para la conversación o para el modo agente después de conectar.
• Una herramienta responde vacío: puede ser el ambiente consultado; varias herramientas trabajan en production por defecto.