Guía general de integración de Eulerian MCP mediante OAuth

Guía general de integración de Eulerian MCP mediante OAuth

EULERIAN MCP
  • Guía de integración — Otros clientes (OAuth)
  • Para usuarios sin conocimientos técnicos avanzados
  • Conector remoto con OAuth 2.1 · válido para cualquier cliente compatible con MCP

1. Qué es esta guía

Casi todos los asistentes de IA compatibles con MCP se conectan a Eulerian de la misma forma: añades un conector remoto con la URL del servidor MCP de Eulerian y te identificas mediante OAuth 2.1. Lo único que cambia entre un cliente y otro es dónde se añade ese conector. Esta guía general describe el proceso común; si usas Claude, ChatGPT, Gemini o Mistral, tienes además una guía específica ilustrada.
El patrón común a todos los clientes: conector remoto + inicio de sesión OAuth en Eulerian.
El principio, en una fraseEndpoint remoto + inicio de sesión OAuth: no instalas nada, no usas el terminal, no pegas ningún token y el cliente nunca ve tu contraseña. Eulerian solo entrega un acceso limitado y revocable.

2. Requisitos: qué debe cumplir tu cliente

Para conectarse con este método, el cliente de IA debe reunir estas características:
  • Soporta servidores MCP remotos (conectores personalizados), no solo servidores locales.
  • Admite OAuth 2.1 como método de autenticación; idealmente con dynamic client registration, para no tener que crear un Client ID/Secret a mano.
  • Permite indicar una URL de servidor (endpoint remoto) accesible por HTTPS con un certificado TLS válido.
  • La conexión parte de los servidores del proveedor de IA, por lo que el endpoint debe ser accesible desde internet (no detrás de un firewall o VPN).
  • Usa el transporte estándar de MCP (Streamable HTTP).
El servidor MCP de EulerianEl conector se apoya en el servidor MCP de Eulerian, desarrollado por Eulerian. Expone las herramientas de la plataforma y delega la autenticación en OAuth 2.1, de modo que cada usuario accede únicamente a los datos que su cuenta de Eulerian le permite ver.

3. Agentes compatibles

A modo de ejemplo, estos clientes cumplen hoy los requisitos anteriores. La parte de Eulerian (endpoint + OAuth) es idéntica; solo cambia dónde se añade el conector:
Agente
MCP remoto
OAuth 2.1
Dónde se configura
Claude (web y escritorio)
Sí
Sí
Ajustes → Connectors (o extensión .dxt de un clic en escritorio)
ChatGPT
Sí
Sí
Ajustes → Aplicaciones → Configuración avanzada → Modo desarrollador
Google Gemini
Sí
Sí
Consola/administración de Gemini, según edición (verificar)
Mistral (Vibe)
Sí
Sí
Mistral Studio → Conectores; activar por conversación
Otros clientes MCP
Según el cliente
Según el cliente
Interfaz del cliente o archivo de configuración
La disponibilidad y los nombres de menú pueden cambiar con el tiempo y según tu plan u organización. Si un cliente no aparece aquí, comprueba en su documentación que cumple los requisitos de la Sección 2.

4. Antes de empezar

Necesitas estos elementos antes de continuar:
Title
Title
1
Un cliente de IA compatible
Un asistente que cumpla los requisitos de la Sección 2 (MCP remoto + OAuth 2.1).
Title
Title
2
La URL del endpoint MCP de Eulerian
Es tu endpoint de API de Eulerian con /mcp añadido al final. Lo encuentras en la propia interfaz de Eulerian, dentro de tu cuenta, en el apartado «Eulerian API» (ver recuadro más abajo).
Title
Title
3
Tus credenciales de Eulerian
Usuario y contraseña de Eulerian. Iniciarás sesión durante el paso de OAuth. No hay que pegar ningún token de API.
Title
Title
4
Permisos de organización (si aplica)
En algunos clientes con cuentas de equipo/empresa, un administrador debe habilitar los conectores personalizados o añadir el conector a nivel de organización.
https://<tu-endpoint-de-API-de-Eulerian>/mcp
Cómo obtener tu endpointEn la interfaz de Eulerian, dentro de tu cuenta, ve al apartado «Eulerian API»: ahí aparece tu endpoint de API. La URL del servidor MCP es ese mismo endpoint con /mcp añadido al final.

5. El proceso paso a paso (OAuth)

Los pasos son los mismos en cualquier cliente; solo cambia dónde encuentras el apartado de conectores en el paso 1.
Paso 1 Localiza dónde se añaden los conectores
En tu cliente de IA, busca el apartado de conectores (puede llamarse Connectors, Conectores o Aplicaciones). En algunos clientes tendrás que activar antes un modo desarrollador o contar con permisos de administrador.
Paso 2 Añade un conector remoto con la URL del endpoint
Elige añadir un conector personalizado / servidor MCP remoto y pega la URL del endpoint de Eulerian con /mcp al final (ver Sección 4).
Paso 3 Elige OAuth como autenticación
Selecciona OAuth 2.1 como método de autenticación. En muchos clientes se detecta automáticamente a partir de la URL; deja el Client ID/Secret en blanco salvo que Eulerian te indique lo contrario.
Paso 4 Inicia sesión en Eulerian
El cliente te redirige a la pantalla de inicio de sesión de Eulerian. Introduce tu usuario y contraseña de Eulerian. Aquí no pegas ningún token: el cliente nunca ve tu contraseña.
Paso 5 Autoriza el acceso (Approve)
Eulerian te muestra los permisos solicitados (por ejemplo eulerian:reports.read). Revísalos y pulsa «Approve» para autorizar (o «Deny» para cancelar).
Ejemplo de la pantalla de autorización de Eulerian; el nombre del cliente y los permisos pueden variar.
Concede solo lo necesarioRevisa siempre los permisos antes de aprobar. Para solo lectura de informes basta con eulerian:reports.read; concede permisos de escritura únicamente si tu caso de uso lo requiere.
Paso 6 Actívalo y úsalo
El conector queda conectado. Algunos clientes exigen además activarlo en cada conversación (en el menú de herramientas/tools). Después, pregunta en lenguaje natural, por ejemplo:
¿A qué herramientas de Eulerian tienes acceso?
Conexión completadaSin instalar nada y sin pegar tokens. Puedes revocar el acceso en cualquier momento desde tu cliente o desde tu cuenta de Eulerian.

6. Dónde se configura en cada cliente

La parte de Eulerian es siempre la misma; esto es solo un mapa de dónde añade cada plataforma el conector. Para el detalle ilustrado, consulta la guía específica de cada cliente:
  • Claude (web): Ajustes → Connectors → «Add custom connector».
  • Claude (escritorio): método manual o extensión .dxt de un clic.
  • ChatGPT: Ajustes → Aplicaciones → Configuración avanzada → Modo desarrollador → «Crear aplicación».
  • Google Gemini: en la consola/administración de Gemini, según la edición (verificar).
  • Mistral (Vibe): créalo en Mistral Studio → Conectores; luego actívalo en cada conversación.
  • Clientes CLI/IDE (Codex, VS Code + Copilot, Mistral Vibe CLI, Gemini CLI): se configuran mediante un archivo de configuración; consulta la guía de cada uno.

7. Seguridad y buenas prácticas

OAuth en lugar de tokens

No se guarda ningún token en tu equipo ni en el navegador. Te autenticas con tu cuenta de Eulerian y Eulerian entrega al cliente un acceso limitado y revocable en cualquier momento.

Permisos explícitos y mínimos

Revisa los permisos en la pantalla de autorización de Eulerian antes de pulsar «Approve» y concede solo los necesarios. Evita permisos de escritura si no los vas a usar.

Solo conectores de confianza

Añade únicamente servidores MCP de desarrolladores en los que confíes. Verifica siempre el origen de la URL: en este caso, el desarrollador es Eulerian.

Endpoint accesible y seguro

El endpoint debe responder por HTTPS con un certificado TLS válido y ser accesible desde internet, ya que la conexión sale de los servidores del proveedor de IA.

Valida con tu departamento de IT

Antes de usar datos reales de negocio, confirma con IT qué plataformas de IA están aprobadas para el tratamiento de datos de empresa.

8. Si algo no funciona

Problema
Solución
No encuentro dónde añadir un conector
Busca «Connectors», «Conectores» o «Aplicaciones» en los ajustes del cliente. Algunos requieren activar un modo desarrollador o permisos de administrador (ver Secciones 3 y 6).
La conexión no se establece o se marca como inválida
Revisa la URL: debe ser tu endpoint de Eulerian API con /mcp al final, por HTTPS y con un certificado TLS válido.
La conexión no llega al servidor
El endpoint debe ser accesible desde internet: la conexión sale de los servidores del proveedor de IA, no de tu equipo. Si está tras un firewall o VPN, no conectará.
Eulerian rechaza el inicio de sesión
Usa tus credenciales de Eulerian (no las del cliente de IA). Si tienes acceso a varias grids, usa el endpoint con el parámetro correcto.
«Permiso denegado» tras autorizar
En la pantalla de autorización de Eulerian debes pulsar «Approve» (no «Deny»). Si pulsaste «Deny», repite el flujo de conexión.
El asistente dice que no tiene acceso al MCP
Algunos clientes exigen activar el conector en cada conversación (menú de herramientas/tools). Actívalo y vuelve a preguntar.

9. Recursos adicionales

  • Tu endpoint de API: en la interfaz de Eulerian, apartado «Eulerian API» (añade /mcp al final).
  • OAuth 2.1 de Eulerian (integraciones de terceros):  doc.api.eulerian.com/#section/Introduction/OAuth-2.1-for-third-party-integrations 
  • Documentación del MCP Server de Eulerian:  doc.eulerian.com/p/sbLg7nk-W2eWAl/Servidor-MCP 
  • Repositorio GitHub:  github.com/EulerianTechnologies/eulerian-marketing-platform-mcp 
  • Guías específicas por cliente: Claude (web y escritorio), ChatGPT, Gemini y Mistral.