Guía de integración de Eulerian MCP con OpenAI Codex CLI
Guía de instalación — para principiantes
Conectar Eulerian a OpenAI Codex CLI
Un paso a paso sin tecnicismos — desde un equipo en blanco hasta datos de Eulerian en directo
Esta guía te muestra, paso a paso, cómo conectar el MCP de Eulerian Marketing Platform a OpenAI Codex CLI (el asistente de OpenAI que funciona en una ventana de terminal). Al terminar podrás preguntar a Codex sobre tus datos de Eulerian en lenguaje natural. Buena noticia: Codex inicia sesión con tu cuenta de ChatGPT — sin clave API.
Lo que necesitarás (5 minutos):
Un equipo donde puedas instalar software
Tu URL de endpoint de Eulerian y tu token de API (pídeselos a tu contacto de Eulerian, son del estilo https://<tu>.api.eulerian.com/mcp y una cadena secreta larga)
Una cuenta de ChatGPT (gratuita o de pago)
Eso es todo.
Paso 1 Instala las dos cosas que Codex necesita
Codex CLI necesita Node.js (para instalar y ejecutar Codex) y Python 3.10+ (para ejecutar el pequeño «puente» de Eulerian). Instala ambos si aún no los tienes:
- Node.js: entra en https://nodejs.org , descarga la versión «LTS», ejecuta el instalador y pulsa Siguiente.
- Python: entra en https://www.python.org/downloads/ , descarga la 3.10 o más reciente. En Windows, marca «Add Python to PATH» en la primera pantalla del instalador.
Después instala el puente de Eulerian. Abre un terminal (Windows: botón Inicio, escribe cmd, Intro — se abre una ventana negra; macOS: abre la app Terminal) y escribe:
pip install eulerian-marketing-platform
Paso 2 Instala Codex CLI
En el mismo terminal, escribe esto y pulsa Intro:
npm install -g @openai/codex
Cuando termine, comprueba que está:
codex --version
Deberías ver un número de versión (lo probamos con codex-cli 0.142.5).
Paso 3 Inicia sesión (con tu cuenta de ChatGPT — sin clave API)
Escribe:
codex login
Se abre el navegador. Inicia sesión con tu cuenta de ChatGPT y aprueba. Vuelve al terminal — ya has iniciado sesión.
Por qué esto está bien: a diferencia de otros asistentes de terminal, Codex no te pide crear y pegar una clave API. Basta con tu inicio de sesión habitual de ChatGPT.
Paso 4 Dile a Codex dónde está Eulerian (edita un archivo de configuración)
Codex guarda su configuración en un archivo config.toml. Su ubicación:
Windows
%USERPROFILE%\.codex\config.toml
macOS / Linux
~/.codex/config.toml
Lo más rápido en Windows: en el terminal escribe notepad %USERPROFILE%\.codex\config.toml y pulsa Intro (haz clic en «Sí» si te ofrece crear el archivo). Pega el bloque de abajo y sustituye el endpoint y el token por los tuyos:
[mcp_servers.eulerian-marketing-platform]command = "C:/Users/tu-usuario/AppData/Local/Programs/Python/Python312/python.exe"args = ["-m", "eulerian_marketing_platform.server"]startup_timeout_sec = 60[mcp_servers.eulerian-marketing-platform.env]EMP_API_ENDPOINT = " https://tu-instancia-eulerian.com/mcp "EMP_API_TOKEN = "pega-aqui-tu-token-de-eulerian"
Dos cosas en las que la gente tropieza: (1) el nombre de la sección es mcp_servers con guion bajo. (2) En Windows, apunta command a la ruta completa de tu Python. ¿No sabes dónde está? Ejecuta python -c "import sys; print(sys.executable)" y copia lo que muestre. Guarda el archivo.
Paso 5 Comprueba la conexión
Inicia Codex escribiendo codex y pulsando Intro. Luego escribe /mcp y pulsa Intro. Deberías ver el servidor de Eulerian con sus herramientas — unas 134 herramientas — lo que significa que la conexión funciona.
Codex CLI tras escribir /mcp: el servidor de Eulerian está conectado y hay 134 herramientas disponibles.
Consejo: si ejecutas codex mcp list, puede que veas Auth: Unsupported junto al servidor. Es normal e inocuo — se refiere al sistema de inicio de sesión opcional propio de Codex, no a Eulerian, que usa tu token.
Paso 6 Pruébalo — pide tus datos
Ahora solo tienes que preguntar, en lenguaje natural. Una buena primera pregunta:
¿A qué sitios puedo consultar con mi cuenta de Eulerian?
Codex llama a la herramienta de Eulerian y lista tus sitios — datos reales, directamente de tu cuenta:
Codex respondiendo con la lista real de sitios de la cuenta de Eulerian (nombre del cliente redactado).
Esa es toda la instalación. A partir de aquí puedes hacer preguntas de negocio en lenguaje natural — por ejemplo «muéstrame las visitas de la semana pasada» o «compara coste e ingresos este mes».
Un paso más — reporting real (y lo que verificamos)
Codex no solo lista sitios; también ejecuta consultas de reporting completas. Al pedirle una evolución diaria de visitas, lee la guía de consultas de Eulerian, descubre los campos correctos y devuelve una tabla limpia día a día:
Codex devolviendo una evolución de visitas día a día de los últimos 7 días (nombre del cliente redactado).
Nota de validación (para el registro): Codex CLI se probó de extremo a extremo en Windows y funcionó de fábrica — conexión, descubrimiento de herramientas (134) y reporting multi-paso, sin clave API (inicio de sesión con cuenta de ChatGPT).
Si algo no funciona
«codex no se reconoce»
Node.js no está instalado o no reabriste el terminal tras instalarlo. Instala Node.js y abre un terminal nuevo.
El servidor aparece pero sin herramientas / se queda colgado al primer arranque
El primer descubrimiento puede tardar 20–30 s. Mantén startup_timeout_sec = 60 en la config y espera un momento.
«No se encuentra Python»
Usa la ruta completa de python.exe en command (ver Paso 4).
Auth: Unsupported me preocupa
Ignóralo — esperado e inocuo (ver Paso 5).