# Conectar tu agente de IA

> Cómo conectar Claude, ChatGPT, GitHub Copilot, Cursor, Gemini u otro cliente MCP al servidor MCP de Tilopay.

- kind: guide
- status: stable
- last_verified: 2026-09-02
- url: https://www.tilopay.com/developers/agentes/conectar

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.

```text
https://mcp.tilopay.com/mcp
```

## Antes de conectar [#antes]

1. El acceso no es autoservicio: el comercio lo solicita en el
   [formulario del servidor MCP](/developers/agentes/mcp#solicitud) 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](/developers/agentes/permisos) antes de conectarlo, sobre
   todo las herramientas marcadas como sensibles.

<Callout type="warn">
Nunca pegues `apiKey`, `apiUser` ni `apiPassword` del comercio en el agente ni en su archivo de
configuración. Las credenciales del comercio viven cifradas en el servidor de Tilopay: el agente
sólo maneja su propia sesión OAuth.
</Callout>

## Claude [#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]

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 [#copilot]

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]

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 [#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 [#otros]

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 [#verificar]

Pedile al agente que liste las herramientas disponibles: deberían aparecer las de Tilopay
agrupadas en [ventas y transacciones](/developers/agentes/mcp/ventas),
[enlaces de pago](/developers/agentes/mcp/enlaces-de-pago),
[catálogo](/developers/agentes/mcp/catalogo),
[contactos](/developers/agentes/mcp/contactos),
[cobros recurrentes](/developers/agentes/mcp/recurrentes),
[tarjetas guardadas y cobros masivos](/developers/agentes/mcp/tarjetas-guardadas) y
[soporte y diagnóstico](/developers/agentes/mcp/soporte).

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](/developers/agentes/recetas).

## Si algo falla [#problemas]

- **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.