Guía de integración de Eulerian MCP con Visual Studio Code y GitHub Copilot
EULERIAN MCP
- Guía de instalación — para principiantes
- Conectar Eulerian a VS Code + GitHub Copilot
- Un paso a paso sin tecnicismos — partiendo de un equipo sin nada instalado
Esta guía te muestra, paso a paso, cómo conectar el MCP de Eulerian Marketing Platform a GitHub Copilot dentro de VS Code. VS Code es una aplicación gratuita de Microsoft; Copilot es su asistente de IA. Empezamos desde cero — instalar VS Code, crear una cuenta gratuita — y terminamos con Copilot respondiendo preguntas sobre tus datos reales de Eulerian.
Lo que necesitarás:
Un equipo donde puedas instalar software
Tu URL de endpoint y tu token de API de Eulerian (de tu contacto de Eulerian)
Un correo electrónico para crear una cuenta gratuita de GitHub.
No hace falta experiencia previa.
Paso 1 Instala VS Code
Entra en https://code.visualstudio.com , pulsa el botón grande de descarga para tu sistema, ejecuta el instalador y acepta los valores por defecto. Abre VS Code al terminar — verás una pantalla de bienvenida como esta:
La pantalla de bienvenida de VS Code, que invita a iniciar sesión y empezar.
Paso 2 Añade GitHub Copilot y crea una cuenta gratuita
Pulsa el icono Extensiones de la barra izquierda (cuatro cuadraditos), busca GitHub Copilot y pulsa Instalar. Copilot te pedirá iniciar sesión. Si no tienes cuenta de GitHub, elige Registrarte — en la página de registro, deja marcada la casilla «Sign up for Copilot Free» para tener Copilot sin coste:
Creación de una cuenta gratuita de GitHub con «Copilot Free» activado.
Paso 3 Ya estás dentro
Una vez dentro, VS Code se abre con el panel Copilot Chat a la derecha. Ahí es donde hablarás con el asistente.
VS Code con sesión iniciada y el panel Copilot Chat abierto a la derecha.
Paso 4 Instala Python y el puente de Eulerian
Copilot llega a Eulerian a través de un pequeño «puente» que se ejecuta en tu equipo. Instala Python 3.10+ desde https://www.python.org/downloads/ (marca «Add Python to PATH» en Windows), luego abre un terminal (Windows: Inicio → escribe cmd → Intro) y ejecuta:
pip install eulerian-marketing-platform
Paso 5 Dile a VS Code dónde está Eulerian
Abre la paleta de comandos con Ctrl+Mayús+P (macOS: Cmd+Mayús+P), escribe MCP: Open User Configuration y pulsa Intro. Se abre un archivo mcp.json. Pega esto y sustituye el endpoint y el token por los tuyos:
{"servers": {"eulerian-marketing-platform": {"type": "stdio","command": "C:/Users/tu-usuario/AppData/Local/Programs/Python/Python312/python.exe","args": ["-m", "eulerian_marketing_platform.server"],"env": {"EMP_API_ENDPOINT": " https://tu-instancia-eulerian.com/mcp ","EMP_API_TOKEN": "pega-aqui-tu-token-de-eulerian"}}}}
Lo que hace tropezar a todo el mundo: VS Code usa la clave "servers" — no "mcpServers" como la mayoría de las apps. Para la ruta command en Windows puedes usar barras normales / (como arriba) o barras invertidas escapadas \\; ambas funcionan. Localiza tu Python con python -c "import sys; print(sys.executable)".
Aparece un pequeño botón Start justo encima de la línea "eulerian-marketing-platform" — púlsalo. Tras unos segundos, VS Code muestra el servidor en ejecución con sus herramientas:
mcp.json con el servidor «Running · 134 tools» (el token está oculto por privacidad).
Paso 6 Cambia Copilot a modo Agent
Las herramientas MCP solo funcionan en modo Agent. En la parte inferior del cuadro de Copilot Chat, abre el desplegable de modo y elige Agent. Puedes revisar qué herramientas están activas con el botón herramientas (
) — las de Eulerian aparecen en la lista:
) — las de Eulerian aparecen en la lista:
El selector de herramientas en modo Agent, mostrando las herramientas MCP de Eulerian disponibles para Copilot.
Útil: para forzar que Copilot use una herramienta concreta de Eulerian, escribe # seguido del nombre de la herramienta en tu mensaje (por ejemplo #getallowedwebsite_account).
Paso 7 Pruébalo — pide tus datos
En el chat (modo Agent), haz una pregunta en lenguaje natural, por ejemplo una evolución semanal de visitas. Copilot llama a las herramientas de Eulerian y devuelve cifras reales:
Copilot devolviendo una evolución de visitas día a día desde Eulerian (nombre del cliente redactado).
Esa es toda la instalación. Ya puedes hacer preguntas de negocio en lenguaje natural y Copilot buscará las respuestas en Eulerian.
Conviene saber (y lo que verificamos)
Si un informe sale primero «inválido»: en un primer intento de reporting, Copilot puede mostrar reports definition is invalid — ocurre cuando la pregunta no tiene dimensión temporal. El agente suele corregirlo solo (añade una dimensión diaria date_day y reintenta), y devuelve los datos. No es un problema de conexión ni de protocolo.
Nota de validación (para el registro): VS Code + GitHub Copilot se probó de extremo a extremo y funcionó de fábrica — conexión, 134 herramientas descubiertas y reporting correctos.
Si algo no funciona
No aparece el comando MCP: Open User Configuration
Actualiza VS Code (necesita 1.101+) y comprueba que la extensión GitHub Copilot está instalada.
El servidor no arranca / muestra 0 herramientas
Comprueba que la clave es "servers" y que command apunta a tu ruta real de Python (Paso 5).
Copilot ignora las herramientas de Eulerian
No estás en modo Agent. Cambia el modo en la parte inferior del chat, o fuerza una herramienta con #nombre_herramienta.
Un informe sale «inválido»
Suele autocorregirse (ver arriba). Si no, pide un desglose «diario» para añadir una dimensión temporal.