Conectar un cliente MCP
La conexión es siempre por usuario: el asistente pasa a actuar en nombre de quien lo autorizó.
Antes de empezar
- Debes estar con sesión iniciada en la app con el perfil que quieres usar.
- Tu administrador debe haber habilitado las funciones que pretendes usar (cuentas, oportunidades, campañas).
Flujo de autorización
- En el cliente MCP, agrega un servidor remoto e indica
https://api.agents2.me/mcp. - El cliente descubre los metadatos en
/.well-known/oauth-protected-resourcey abre el navegador. - Inicia sesión en agents2.me (si aún no lo hiciste).
- La app abre la pantalla de consentimiento mostrando el nombre del cliente que está pidiendo acceso.
- Aprueba o rechaza.
- El cliente recibe los tokens y pasa a listar las herramientas.
Clientes conocidos
| Cliente | Cómo agregarlo |
|---|---|
| Claude | Configuración → Conectores → Agregar conector personalizado → pega la URL del endpoint |
| ChatGPT | Configuración → Conectores → Crear → URL del endpoint MCP |
| Cursor / VS Code | Archivo de configuración MCP del editor, tipo http, URL del endpoint |
| n8n y automatizaciones | Nodo de cliente MCP genérico, tipo Streamable HTTP, con OAuth |
El cliente debe soportar MCP remoto sobre HTTP con OAuth. Los clientes que solo hablan MCP local (stdio) exigen un adaptador.
Verificar si funcionó
- En la app, abre Configuración → Apps conectadas.
- La conexión debe aparecer con el nombre del cliente, la fecha del último uso y el usuario responsable.
- En el asistente, pide algo simple — "lista mis conversaciones esperando respuesta".
Ejemplos de uso
| Pedido al asistente | Herramientas activadas |
|---|---|
| "¿Qué está esperando respuesta ahora?" | list_open_conversations |
| "Resume la conversación de María" | search_inbox + get_conversation_history |
| "Asume su conversación y responde X" | take_conversation + send_message |
| "¿Qué oportunidades cerraron este mes?" | search_opportunities + run_report |
| "Arma la campaña de reactivación para los contactos sin contacto hace 30 días" | create_campaign + list_campaign_templates + update_campaign |
Revocar el acceso
En Configuración → Apps conectadas, usa el ícono de papelera en la fila de la conexión. La revocación es inmediata: los tokens de esa conexión dejan de funcionar y el asistente debe autorizar de nuevo para volver.
Límites
- 120 llamadas por minuto por conexión. Al superarlo, la respuesta es
429y basta con esperar. - 30 días de validez del refresh token. Después de eso, autoriza de nuevo.
- La conexión es personal: dos usuarios apuntando al mismo asistente tienen conexiones distintas, con permisos distintos.
Consulta OAuth y seguridad para los detalles técnicos.