Guía de integración de Eulerian MCP con Claude Desktop

Guía de integración de Eulerian MCP con Claude Desktop

EULERIAN MCP
Guía de Integración con Claude Desktop
Para usuarios sin conocimientos técnicos avanzados
Extensión en 1 clic o instalación manual · Claude Desktop

1. Qué es el MCP de Eulerian

El MCP (Model Context Protocol) de Eulerian es un conector que permite a Claude acceder directamente a los datos de tu plataforma Eulerian Marketing Platform. En lugar de abrir dashboards, exportar ficheros CSV o escribir consultas SQL, simplemente le preguntas a Claude en lenguaje natural.
Analogía sencillaPiensa en el MCP como un «intérprete» entre Claude y Eulerian. Claude habla en lenguaje natural, Eulerian habla en APIs; el MCP traduce entre ambos automáticamente.

Qué puedes hacer con él:

  • Consultar el rendimiento de campañas de paid search de la semana pasada con una frase.
  • Descubrir qué canales de media aportaron más conversiones este mes.
  • Analizar el recorrido de cliente de tu segmento con mayor conversión.
  • Obtener insights de analítica sin necesidad de exportar datos manualmente.

2. Antes de empezar

Asegúrate de tener estos cuatro elementos antes de continuar con la instalación:
Title
Title
1
Cuenta Eulerian activa (tipo Webmaster)
Necesitas acceso webmaster a tu instancia de Eulerian Marketing Platform. Si no lo tienes, contacta a tu administrador de plataforma.
Title
Title
2
Token de API de Eulerian
Es una clave secreta que Eulerian te proporciona. Guárdala en un lugar seguro, la necesitarás en el Paso 3 (o al configurar la extensión).
Title
Title
3
Python 3.10 o superior
Descárgalo en  python.org/downloads . Durante la instalación en Windows, marca «Add Python to PATH». Necesario para AMBOS métodos: el método manual (Sección 3) lo usa directamente, y la extensión .dxt (Sección 4) también se ejecuta con el Python de tu sistema.
Title
Title
4
Claude Desktop instalado
Descárgalo en  claude.ai/download . Esta guía usa Claude Desktop como cliente principal.

3. Instalación manual (terminal + archivo de configuración)

Este es el método clásico, con comandos. Si prefieres una instalación sin comandos ni Python, ve directamente a la Sección 4 (extensión de un clic); solo necesitas uno de los dos métodos.
Paso 1 Instala el paquete de Eulerian
Abre una terminal (en Windows: busca «cmd» o «PowerShell»; en Mac: busca «Terminal») y ejecuta este comando:
pip install eulerian-marketing-platform
¿Qué hace esto?Descarga e instala el conector MCP de Eulerian en tu ordenador. Es como instalar cualquier aplicación, pero desde la terminal. Al terminar verás el mensaje: Successfully installed eulerian-marketing-platform.
Paso 2 Localiza el archivo de configuración de Claude Desktop
Claude Desktop tiene un archivo de configuración donde le indicaremos que use Eulerian. Según tu sistema operativo:
Sistema
Ruta del archivo
Windows
%APPDATA%\Claude\claude_desktop_config.json
macOS
~/Library/Application Support/Claude/claude_desktop_config.json
Linux
~/.config/Claude/claude_desktop_config.json
Atajo desde Claude DesktopAbre Claude Desktop > menú Claude > Settings > Developer > Edit Config. Se abrirá el archivo directamente.
Paso 3 Añade la configuración de Eulerian
Abre el archivo claude_desktop_config.json con cualquier editor de texto (Notepad, TextEdit, VS Code…) y reemplaza su contenido con lo siguiente, sustituyendo los valores DE LOS PARÁMETROS EN MAYÚSCULAS (endpoint y token) por los tuyos:
{"mcpServers": {"eulerian-marketing-platform": {"command": "python","args": ["-m", "eulerian_marketing_platform.server"],"env": {"EMP_API_ENDPOINT": " https://TU-INSTANCIA.api.eulerian.com/mcp ","EMP_API_TOKEN": "TU_TOKEN_SECRETO_AQUI"}}}}
Importante — sustituye los valoresReemplaza  TU-INSTANCIA.api.eulerian.com  con la URL real de tu servidor Eulerian, y TU_TOKEN_SECRETO_AQUI con tu token de API. Nunca compartas este archivo con nadie.
Guarda el archivo con Ctrl+S (o Cmd+S en Mac).
Paso 4 Reinicia Claude Desktop y verifica la conexión
Cierra Claude Desktop completamente (no solo minimices la ventana) y vuelve a abrirlo.
Señal de éxitoBusca el icono de un martillo en la esquina inferior derecha del chat. Al hacer clic verás los tools (herramientas) de Eulerian disponibles. O, en su defecto, pregunta directamente a Claude si ya está conectado al MCP de Eulerian.
Para confirmar que todo funciona, escribe en Claude:
¿A qué herramientas de Eulerian Marketing Platform tienes acceso?
Claude debería responder listando las herramientas disponibles de tu plataforma. La integración está completa.

4. Alternativa: instalación en un clic con la extensión (.dxt)

Además del método manual de la Sección 3, Eulerian ofrece una extensión de un clic para Claude Desktop. Es la vía más sencilla: sin terminal, sin comandos `pip` y sin editar archivos JSON. Recomendada para usuarios no técnicos.
¿Cuál elegir?La extensión .dxt es la forma más rápida y sencilla. El método manual (Sección 3) sigue siendo válido y resulta útil si tu organización restringe la instalación de extensiones o si prefieres controlar la configuración a mano. Ambos métodos dan el mismo resultado; usa solo uno de los dos.
Necesitas lo mismo que antes — tu endpoint y tu token de Eulerian (puntos 1 y 2 de la Sección 2) — Claude Desktop instalado y Python 3.10 o superior (la extensión lo usa para ejecutarse; ver la nota siguiente).
¿Y Python?La extensión te ahorra el terminal, el comando pip install y la edición de JSON, pero necesita que Python 3.10+ esté instalado en el equipo: Claude Desktop trae su propio runtime de Node.js, pero no incluye Python, así que la extensión se ejecuta con el Python de tu sistema. Si no lo tienes, instálalo primero (punto 3 de la Sección 2; en Windows marca «Add Python to PATH»). El código del conector sí va dentro del .dxt, por lo que no necesitas ejecutar pip install.
Paso 1 Consigue el archivo de la extensión
Descarga el archivo eulerian-marketing-platform-0.2.9.dxt (te lo proporciona Eulerian; también está disponible en el repositorio de GitHub indicado en Recursos). Guárdalo en un lugar fácil de encontrar, por ejemplo la carpeta Descargas.
Sobre la versiónEl nombre del archivo incluye el número de versión (aquí 0.2.9). Si Eulerian publica una versión más reciente, actualízala instalando el nuevo archivo .dxt de la misma forma.
Paso 2 Abre Extensiones en Claude Desktop
En Claude Desktop, ve al menú Claude > Settings (Configuración) y abre la sección Extensiones. Verás el apartado «Instalado en tu computadora» y, más abajo, una zona que indica «Arrastra archivos .MCPB o .DXT aquí para instalar».
Paso 3 Instala la extensión
Arrastra el archivo eulerian-marketing-platform-0.2.9.dxt desde su carpeta hasta esa zona de instalación (o usa Configuración avanzada para seleccionarlo). Una vez instalada, aparecerá en la lista como «Eulerian Marketing Platform» con la etiqueta PERSONALIZADA y un botón Configurar.
La extensión instalada aparece como «Eulerian Marketing Platform» (PERSONALIZADA), con el botón «Configurar» y la zona para arrastrar archivos .DXT / .MCPB.
Paso 4 Configura el endpoint y el token
Pulsa Configurar (o haz clic en la extensión) para abrir sus ajustes. Activa el interruptor «Habilitada» y rellena los campos:
  • API Endpoint (obligatorio): la URL de tu servidor MCP de Eulerian, por ejemplo  https://tu-instancia.api.eulerian.com/mcp .
  • API Token (obligatorio): tu token de autenticación de Eulerian.
  • Request Timeout (seconds): tiempo máximo de espera de las respuestas. Deja 300 o auméntalo si haces consultas largas.
Pulsa Guardar.
Pantalla de configuración de la extensión: API Endpoint, API Token (oculto) y Request Timeout. Pulsa «Guardar» al terminar.
Paso 5 Verifica la conexión
La extensión debe mostrarse como «Habilitada». Abre un chat y haz clic en el icono del martillo (esquina inferior derecha) para ver las herramientas de Eulerian, o pregunta directamente a Claude:
¿A qué herramientas de Eulerian Marketing Platform tienes acceso?
Si Claude lista las herramientas disponibles, la integración está completa.
ListoHas conectado Eulerian a Claude sin terminal, sin comandos y sin editar JSON. El resultado es el mismo que con el método manual de la Sección 3.
Actualizar o quitar la extensiónPara cambiar el endpoint o el token, vuelve a Settings > Extensiones > eulerian-marketing-platform y pulsa Configurar. Para eliminarla, usa Desinstalar. El token se muestra oculto; trátalo como una contraseña.

5. Cómo usarlo — Ejemplos de preguntas

Una vez conectado (por cualquiera de los dos métodos), puedes preguntarle a Claude en lenguaje natural. Algunos ejemplos:
  • ¿Cómo han rendido nuestras campañas de paid search la semana pasada?
  • ¿Qué canales de media contribuyeron más a conversiones este mes?
  • Muéstrame el journey de cliente para nuestro segmento con mayor conversión.
  • ¿Cuántas sesiones únicas tuvimos en los últimos 7 días comparado con el mes anterior?
  • ¿Qué herramientas de Eulerian tienes disponibles?
Consejo para mejores resultadosSé específico en tus preguntas. En lugar de «¿cómo van las campañas?», prueba con «¿cuál es el CPA de nuestras campañas de display del último mes?». Cuanto más concreto, más precisa será la respuesta de Claude.

6. Seguridad y buenas prácticas

Valida con tu departamento de IT

Antes de usar datos reales de negocio, confirma con IT qué plataformas de IA están aprobadas por tu organización. Usa preferiblemente servicios enterprise como Claude Teams/Enterprise.

Verifica los datos importantes

Las IAs pueden cometer errores al formular consultas. Cruza los insights críticos con el interfaz de Eulerian directamente. En Claude, puedes hacer clic en cualquier dato para ver qué propiedades y métricas fueron consultadas realmente.

Protege tu token de API

Tu token es como una contraseña. No lo compartas, no lo subas a repositorios como GitHub, ni lo incluyas en correos electrónicos.

Precaución con múltiples MCPs

Evita usar múltiples MCPs simultáneamente a menos que confíes en todos ellos. Un MCP inseguro puede exponer datos de los demás conectores activos.

7. Problema frecuente: el archivo de configuración no existe

Este es un problema habitual en instalaciones nuevas de Claude Desktop (método manual)Al ir a Configuración > Ajustes > Desarrollador > Editar Configuración, Claude Desktop puede mostrar un error indicando que la ruta no existe. Esto ocurre porque la carpeta y el archivo no se crean automáticamente hasta que se abre por primera vez desde ese menú, o simplemente porque tu instalación no los generó. (Si usas la extensión .dxt de la Sección 4, este problema no aplica.)

Cómo solucionarlo: crear la carpeta y el archivo manualmente

Sigue estos pasos según tu sistema operativo:

En Windows

  • Abre el Explorador de archivos y en la barra de direcciones escribe exactamente: %APPDATA%\Claude
  • Si la carpeta Claude no existe, créala: clic derecho > Nueva carpeta > llámala exactamente Claude.
  • Dentro de esa carpeta, crea un archivo nuevo de texto: clic derecho > Nuevo > Documento de texto.
  • Renombra el archivo como claude_desktop_config.json (elimina la extensión .txt si aparece).
  • Abre ese archivo con el Bloc de notas y pega dentro exactamente el contenido del Paso 3 de la Sección 3.
  • Guarda con Ctrl+S y reinicia Claude Desktop.
Consejo para ver extensiones en WindowsSi no ves la extensión .txt al renombrar el archivo, ve al Explorador de archivos > menú Ver > marca «Extensiones de nombre de archivo». Así podrás renombrarlo correctamente a .json.

En macOS

Abre el Terminal (busca «Terminal» en Spotlight con Cmd+Espacio) y ejecuta estos dos comandos, uno a uno, para crear la carpeta y el archivo vacío:
mkdir -p ~/Library/Application\ Support/Claudetouch ~/Library/Application\ Support/Claude/claude_desktop_config.json
Abre el archivo con cualquier editor de texto (TextEdit, VS Code…), añade el contenido del Paso 3, guarda y reinicia Claude Desktop.

En Linux

Abre un terminal y ejecuta:
mkdir -p ~/.config/Claudetouch ~/.config/Claude/claude_desktop_config.json
Edita el archivo con nano o cualquier editor: nano ~/.config/Claude/claude_desktop_config.json. Pega el contenido del Paso 3, guarda con Ctrl+O, confirma con Enter y sal con Ctrl+X. Reinicia Claude Desktop.
Verificación finalUna vez creado el archivo y reiniciado Claude Desktop, vuelve a Configuración > Ajustes > Desarrollador > Editar Configuración. Esta vez debería abrirse sin errores y mostrarte el contenido JSON que has añadido.

8. Otros problemas frecuentes

Problema
Solución
El servidor no aparece en Claude Desktop
Cierra Claude Desktop completamente (verifica que no quede en la barra del sistema) y vuelve a abrirlo. Revisa que el archivo JSON no tenga errores de formato, o que la extensión .dxt esté «Habilitada».
Error: EMP_API_ENDPOINT variable required
La URL del servidor no está configurada correctamente. Sustituye el texto de ejemplo por tu URL real de Eulerian (o rellénala en la configuración de la extensión).
Error: EMP_API_TOKEN variable required
Tu token de API no está configurado. Reemplaza TU_TOKEN_SECRETO_AQUI con el token real proporcionado por Eulerian (o introdúcelo en la extensión).
«python» no se reconoce como comando
Afecta a AMBOS métodos: la extensión .dxt y el método manual se ejecutan con el Python de tu sistema. Instala Python 3.10+ y, en Windows, marca «Add Python to PATH»; cierra y reabre la terminal y comprueba que «python» funciona. Prueba también python3. Si Python no está instalado, la extensión tampoco arrancará.
Los datos no parecen correctos
Haz clic en el dato en Claude para ver qué métricas fueron consultadas. Reformula tu pregunta siendo más específico sobre el periodo o la métrica deseada.

9. Recursos adicionales

  • Repositorio GitHub:  github.com/EulerianTechnologies/eulerian-marketing-platform-mcp 
  • Paquete PyPI:  pypi.org/project/eulerian-marketing-platform/ 
  • Documentación oficial:  https://doc.eulerian.com/p/sbLg7nk-W2eWAl/Servidor-MCP 
  • Descarga Python:  python.org/downloads 
  • Descarga Claude Desktop:  claude.ai/download 
Guía simplificada basada en la documentación oficial de Eulerian Technologies.