Guía de integración de Eulerian MCP con Gemini CLI

Guía de integración de Eulerian MCP con Gemini CLI

EULERIAN MCP
Guía de integración con Gemini CLI
Paso a paso, sin experiencia previa | ~15–20 minutos | Gemini CLI

1. Qué es el MCP de Eulerian

El MCP de Eulerian es un conector que permite a tu asistente de IA leer directamente tus datos de Eulerian Marketing Platform. En lugar de abrir cuadros de mando o exportar archivos, simplemente haces preguntas en lenguaje natural. Esta guía lo instala con Gemini CLI, un asistente gratuito de Google que funciona en una ventana «terminal».
¿No quieres usar un terminal? Claude Desktop ofrece un instalador en un clic, sin ningún comando. Si no te sientes cómodo escribiendo comandos, puede que sea la opción más sencilla. Esta guía es específica para Gemini CLI.

2. Antes de empezar

Necesitarás estas cinco cosas. No te preocupes por las técnicas — los pasos de abajo te muestran exactamente qué hacer.
  • 1 · Una cuenta de Eulerian (tipo Webmaster). Si no tienes una, pídesela a tu administrador de la plataforma.
  • 2 · Tu token de API de Eulerian. Una cadena de texto secreta que proporciona Eulerian. Guárdala en un lugar seguro; la pegarás en el Paso 4.
  • 3 · Tu URL de endpoint de Eulerian. Es del estilo  https://something.api.eulerian.com/mcp . También la proporciona Eulerian.
  • 4 · Python y Node.js instalados. Descargas gratuitas: Python desde  python.org/downloads  (en Windows, marca «Add Python to PATH» durante la instalación), y Node.js desde  nodejs.org .
  • 5 · Una cuenta de Google gratuita, para crear una clave API de Gemini en el Paso 5.

3. Cómo abrir el terminal (lo usarás varias veces)

El «terminal» es una ventana donde escribes comandos. Para abrirlo:
  • Windows: pulsa la tecla Windows, escribe cmd y pulsa Intro. Se abre una ventana negra — ese es el terminal.
  • macOS: pulsa Cmd + Espacio, escribe Terminal, Intro.
  • Linux: abre tu aplicación Terminal.
Cómo usarlo: haz clic dentro de la ventana, escribe (o pega) un comando y pulsa Intro para ejecutarlo. Para pegar en el terminal de Windows, usa el clic derecho (puede que Ctrl+V no funcione). Puedes dejar esta ventana abierta y reutilizarla en cada paso.

4. Instalación paso a paso

Paso 1 Instala Gemini CLI
Abre el terminal (sección 3). Escribe esta línea y pulsa Intro (puede tardar un minuto):
npm install -g @google/gemini-cli
Cuando termine, comprueba que funcionó escribiendo:
gemini --version
Si ves un número de versión, todo bien. (Si dice «not recognised», cierra el terminal, abre uno nuevo e inténtalo de nuevo.)
Paso 2 Instala el conector de Eulerian
En el mismo terminal, escribe:
pip install eulerian-marketing-platform
Deberías terminar con una línea del tipo «Successfully installed eulerian-marketing-platform».
Paso 3 Encuentra tu ruta de Python (anótala)
Gemini necesita la ubicación exacta de Python en tu equipo. En el terminal, escribe:
python -c "import sys; print(sys.executable)"
Imprime una línea, por ejemplo:
C:\Users\tu-usuario\AppData\Local\Programs\Python\Python312\python.exe
Copia esa línea completa y tenla a mano — la pegarás en el Paso 4. Para copiar en el terminal de Windows: selecciona el texto con el ratón y pulsa Intro. (Si la línea contiene WindowsApps, instala Python desde  python.org  y vuelve a ejecutar esto.)
Paso 4 Crea y edita el archivo de configuración
Este archivo le dice a Gemini que use Eulerian. Se llama settings.json y está en una carpeta llamada .gemini. Aquí tienes exactamente cómo encontrarlo o crearlo.
4a. Abre la carpeta.
    Abre el Explorador de archivos (el icono de carpeta amarilla, o pulsa Tecla Windows + E).
    Haz clic en la barra de direcciones de arriba, escribe exactamente %USERPROFILE%\.gemini y pulsa Intro.
    Si dice que la carpeta no existe: escribe %USERPROFILE% en su lugar, pulsa Intro, luego clic derecho → Nuevo → Carpeta y nómbrala exactamente .gemini, y ábrela.
4b. Activa las extensiones de archivo (para que el archivo no sea en secreto un .txt).
    En el Explorador, abre el menú Vista → Mostrar → marca Extensiones de nombre de archivo. Ahora los archivos muestran su terminación real, como .json o .txt.
4c. Crea el archivo (sáltatelo si ya hay un settings.json).
    Clic derecho en una zona vacía → Nuevo → Documento de texto.
    Renómbralo exactamente a settings.json (borra la terminación .txt). Pulsa Sí en el aviso.
4d. Abre el archivo y pega el contenido.
    Clic derecho en settings.json → Abrir con → Bloc de notas.
    Borra todo lo que haya dentro y pega exactamente esto:
{"mcpServers": {"eulerian-marketing-platform": {"command": "PASTE-YOUR-PYTHON-PATH-HERE","args": ["-m", "eulerian_marketing_platform.server"],"timeout": 600000,"env": {"EMP_API_ENDPOINT": "PASTE-YOUR-EULERIAN-URL-HERE","EMP_API_TOKEN": "PASTE-YOUR-TOKEN-HERE"}}}}
4e. Sustituye los tres marcadores PASTE-… por tus propios valores (mantén las comillas "" alrededor de cada uno):
  • "command": tu ruta de Python del Paso 3.
  • "EMP_API_ENDPOINT": tu URL de Eulerian (punto 3 de «Antes de empezar»).
  • "EMP_API_TOKEN": tu token de Eulerian (punto 2).
Windows — muy importante sobre la ruta de Python: cambia cada barra invertida simple \ por una doble barra invertida \\. Por ejemplo, esto:C:\Users\tu-usuario\...\python.exedebe escribirse como:C:\\Users\\tu-usuario\\...\\python.exe
Después guarda el archivo: pulsa Ctrl+S. Ubicación del archivo de configuración, como referencia:
Tu equipo
Ubicación del archivo de configuración
Windows
%USERPROFILE%\.gemini\settings.json
macOS
~/.gemini/settings.json
Linux
~/.gemini/settings.json
Paso 5 Obtén y define tu clave API de Gemini
Es una clave gratuita que permite a Gemini responder (es distinta de tu token de Eulerian).
    En un navegador, abre  https://aistudio.google.com/apikey  e inicia sesión con Google.
    Pulsa Create API key, luego Copy (empieza por AIza o similar).
    De vuelta en el terminal, escribe set GEMINI_API_KEY= y luego clic derecho para pegar tu clave justo después del =, y pulsa Intro:
set GEMINI_API_KEY=tu-clave-pegada-aqui
(macOS/Linux: usa export GEMINI_API_KEY=tu-clave.)
Paso 6 Inicia Gemini y comprueba la conexión
    En el mismo terminal, escribe gemini y pulsa Intro.
    Si pregunta si confías en la carpeta, elige «Trust folder». Si pregunta cómo autenticarte, elige «Use Gemini API key».
    Escribe /mcp list y pulsa Intro. Tras unos segundos, el servidor de Eulerian debería aparecer como Ready, con una lista de herramientas:
Así se ve el éxito: el servidor de Eulerian está «Ready» con sus herramientas listadas.
Paso 7 Pruébalo
Pregúntale a Gemini en lenguaje natural, por ejemplo: «¿A qué sitios puedo consultar con mi cuenta de Eulerian?» La primera vez, pedirá permiso para ejecutar una herramienta — di que sí. Cuando veas tus datos reales, has terminado.

5. Cómo usarlo — ejemplos de preguntas

  • ¿Cómo funcionaron nuestras campañas de search de pago la semana pasada?
  • ¿Qué canales contribuyeron más a las conversiones este mes?
  • Compara el coste y los ingresos de las campañas este mes vs el mes pasado.
  • ¿Qué herramientas de Eulerian tienes disponibles?
Consejo: sé específico. «¿Cuál es el CPA de nuestras campañas de display el mes pasado?» funciona mucho mejor que «¿cómo van las campañas?».

6. Seguridad

  • Mantén tu token y tu clave en privado. Son como contraseñas — no los compartas, no los pongas en capturas de pantalla ni en correos. Si alguien más los ve alguna vez, crea unos nuevos.
  • Consulta con tu equipo de IT antes de usar datos de negocio reales con cualquier herramienta de IA.
  • Vuelve a comprobar las cifras importantes en la interfaz de Eulerian; la IA puede formular ocasionalmente una consulta de forma imperfecta.

7. Si algo no funciona

Si ves esto
Haz esto
«gemini» no se reconoce
Cierra el terminal y abre uno nuevo. ¿Sigue fallando? Escribe npx @google/gemini-cli en lugar de gemini.
«python» no se reconoce
Reinstala Python desde  python.org  marcando «Add Python to PATH». Luego abre un terminal nuevo.
El servidor muestra «Disconnected» al primer intento
El descubrimiento de herramientas puede tardar 20–30 segundos. Espera un momento y vuelve a ejecutar /mcp list. La línea "timeout" del Paso 4 también ayuda.
Sigue «Disconnected» y sospechas de la ruta de Python
Revisa el Paso 4: el command debe ser tu ruta exacta de Python con dobles barras invertidas (\\).
«Usage limit reached»
Es la cuota de tu modelo Gemini, no de Eulerian. Escribe /model para cambiar de modelo, o espera a que se reinicie.
El inicio de sesión dice «no longer supported / Antigravity»
Usa una clave API de Gemini en su lugar (Paso 5). El inicio de sesión gratuito de Google ya no funciona en el CLI.

8. Enlaces útiles

  • Conector de Eulerian (GitHub):  github.com/EulerianTechnologies/eulerian-marketing-platform-mcp 
  • Claves API de Gemini:  aistudio.google.com/apikey 
  • Instalar Python:  python.org/downloads 
  • Instalar Node.js:  nodejs.org