Guía de integración de Eulerian MCP con Antigravity CLI
EULERIAN MCP
- Guía de integración con Antigravity CLI
- Para usuarios sin conocimientos técnicos avanzados
- Conector remoto con OAuth 2.1 · Terminal (agy) · mcp_config.json
1. Qué es y en qué se diferencia de las otras versiones
Esta guía conecta Antigravity CLI con el servidor MCP remoto de Eulerian. La CLI (comando agy) es la versión de terminal de Google: un agente con el que trabajas escribiendo en la consola, sin interfaz gráfica. Admite servidores MCP remotos con autenticación OAuth 2.1. No pegas ningún token de API: el conector se añade en el archivo mcp_config.json y te identificas con tu propia cuenta de Eulerian. Frente a Antigravity 2.0 y al IDE, aquí todo se hace desde la terminal: se abre el gestor con el comando /mcp y el login OAuth se completa pegando un código en la propia consola.
El principio, en una fraseEndpoint remoto + inicio de sesión OAuth: no guardas tokens de API y la CLI nunca ve tu contraseña. Eulerian solo entrega un acceso limitado y revocable.
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 salir de la terminal.
2. Antes de empezar
Necesitas estos cuatro elementos antes de continuar:
1
La CLI de Antigravity (agy)
Se instala con un comando (ver Paso 1). Funciona en Windows, macOS y Linux. Comparte cuenta y configuración con Antigravity 2.0 y el IDE.
2
Una cuenta de Google
La CLI se identifica con tu cuenta de Google la primera vez que la arrancas (o reutiliza la sesión ya iniciada si usas Antigravity 2.0/IDE).
3
La URL del endpoint MCP de Eulerian
Es tu endpoint de API de Eulerian con /mcp añadido al final. Lo encuentras en la interfaz de Eulerian, dentro de tu cuenta, en el apartado «Eulerian API».
4
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.
Requisitos del endpointEl endpoint debe ser accesible por internet y por HTTPS con un certificado TLS válido: la conexión parte de tu equipo. Si tienes acceso a varias grids, usa el endpoint de la que corresponda.
3. Instalación paso a paso
Paso 1 Instala la CLI (agy)
Abre una terminal y ejecuta el instalador de tu sistema. En Windows, abre PowerShell (tecla Windows → escribe «powershell» → Enter) y pega:
Otras plataformasWindows (CMD): curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd · macOS y Linux: curl -fsSL https://antigravity.google/cli/install.sh | bash. Tras instalar, cierra y vuelve a abrir la terminal para que reconozca el comando agy.
Paso 2 Arranca «agy» y completa la bienvenida
En una terminal nueva, escribe agy y pulsa Enter. La primera vez, la CLI puede abrir el navegador para que inicies sesión con tu cuenta de Google (o reutiliza la sesión ya iniciada). Después completa el asistente: elige un tema de color (flechas ↑/↓ + Enter), acepta las condiciones de uso ([Done]) y, cuando pregunte, confía en la carpeta («Yes, I trust this folder»).
Primer arranque de la CLI: elige un tema de color con las flechas y pulsa Enter.
La CLI pide confiar en la carpeta desde la que la abres; deja «Yes, I trust this folder» y pulsa Enter.
Login la primera vezPuede pedirte iniciar sesión en el navegador con tu cuenta de Google, o usar directamente la sesión ya iniciada si compartes credenciales con Antigravity 2.0/IDE.
Paso 3 Localiza tu endpoint MCP en Eulerian
En la interfaz de Eulerian, dentro de tu cuenta, abre el apartado Eulerian API. Ahí aparece tu API Endpoint. La URL del servidor MCP es ese mismo endpoint con /mcp al final:
Apartado «Eulerian API»: tu API Endpoint (valores de demostración). No necesitas el API token para este método.
https://<tu-endpoint-de-API-de-Eulerian>/mcp
No necesitas el token de APIAquí no copias el API token. Solo necesitas la URL del endpoint con /mcp; te identificarás con tu usuario y contraseña durante el paso de OAuth.
Paso 4 Abre el archivo de configuración mcp_config.json
El conector se define en un archivo de texto que la CLI comparte con Antigravity 2.0 y el IDE. Ábrelo con el Bloc de notas. En Windows (en PowerShell):
notepad $env:USERPROFILE\.gemini\config\mcp_config.json
Dónde está el archivoWindows: C:\Users\<tu-usuario>\.gemini\config\mcp_config.json · macOS y Linux: ~/.gemini/config/mcp_config.json. Si el Bloc de notas pregunta si crear el archivo, di que sí. También puedes usarlo por proyecto en .agents/mcp_config.json.
Paso 5 Añade el servidor de Eulerian y guarda
Pega este contenido en el archivo (sustituye por tu endpoint con /mcp al final) y guarda (Archivo → Guardar):
{"mcpServers": {"eulerian": {"serverUrl": "https://<tu-endpoint-de-API-de-Eulerian>/mcp"}}}
Si ya lo añadiste en 2.0 o en el IDEComo las tres superficies comparten este archivo, es posible que Eulerian ya esté ahí. En ese caso no tienes que volver a añadirlo: pasa directo al Paso 6.
Paso 6 Abre el gestor de MCP con /mcp
En la caja de prompt de la CLI, escribe /mcp y pulsa Enter. Se abre el gestor MCP Servers, donde verás Eulerian. Como aún no te has identificado, aparecerá [Auth Needed] con un aviso «Unauthorized» (es normal, lo arreglamos en el paso siguiente).
El gestor «MCP Servers» muestra Eulerian con «[Auth Needed]»: falta autenticar.
Paso 7 Lanza la autenticación
Con Eulerian seleccionado (la flecha `>` a su izquierda), pulsa Enter para abrir las acciones. Verás Restart, Disable y [Authenticate]. Muévete hasta Authenticate y pulsa Enter.
Con Eulerian seleccionado, pulsa Enter y elige «Authenticate».
Paso 8 Inicia sesión y autoriza en el navegador
La CLI abre tu navegador con el login de Eulerian. Introduce tu usuario y contraseña de Eulerian, y en la pantalla de permisos pulsa «Approve» (la CLI nunca ve tu contraseña).
Pantalla de inicio de sesión de Eulerian.
Autorización en Eulerian: revisa los permisos y pulsa «Approve».
Concede solo lo necesarioRevisa los permisos antes de aprobar. Para solo lectura de informes basta con eulerian:reports.read; concede escritura únicamente si tu caso lo requiere.
Paso 9 Copia el código y pégalo en la terminal
El navegador muestra un código de un solo uso (pulsa Copy to Clipboard). Vuelve a la terminal: la CLI está esperando en «Paste the authorization code below». Pega el código y pulsa Enter. Verás «Authentication successful!».
Antigravity muestra un código de un solo uso: cópialo con «Copy to Clipboard» (código ocultado).
La CLI pide pegar el código de autorización (la URL se ha ocultado); pégalo y pulsa Enter.
Si el navegador no se abre soloLa terminal imprime una URL de autorización: cópiala y ábrela a mano en el navegador para iniciar sesión, y luego pega aquí el código.
Paso 10 Conector conectado
Pulsa Enter para volver al panel de MCP. Ahora Eulerian aparece como ✓ [Authed] con la lista de herramientas disponibles. Ya está conectado.
Eulerian conectado: «✓ Eulerian [Authed]» con sus herramientas (eulerian_tool_invoke, …).
Conexión completadaSin pegar tokens. Puedes cerrar la sesión de la CLI en cualquier momento con el comando /logout, o revocar el acceso desde tu cuenta de Eulerian.
Paso 11 Úsalo
Pulsa Esc para salir del panel de MCP y volver a la caja de prompt. Ahí escribe tu pregunta en lenguaje natural y pulsa Enter; la CLI llamará a las herramientas de Eulerian. Por ejemplo:
¿A qué herramientas de Eulerian tienes acceso?
La CLI responde usando el MCP de Eulerian, listando las herramientas disponibles.
4. Equipos y organizaciones
La configuración de MCP vive en el archivo mcp_config.json de tu equipo, y la autenticación es individual: cada usuario inicia sesión con su propia cuenta de Eulerian.
- El conector se define en tu mcp_config.json (global en ~/.gemini/config/mcp_config.json o por proyecto en .agents/mcp_config.json).
- Cada usuario se conecta con su propia cuenta de Eulerian, de modo que solo accede a los datos que su cuenta puede ver.
- En entornos corporativos, confirma con tu departamento de IT qué herramientas de IA están aprobadas para tratar datos de negocio.
El acceso concedido es limitado y revocable: usa el comando /logout en la CLI para cerrar sesión, o revócalo desde tu cuenta de Eulerian en cualquier momento.
5. Otros clientes y notas
Antigravity 2.0, el IDE y la CLI comparten el mismo archivo de configuración MCP (~/.gemini/config/mcp_config.json) y la misma sesión. Si ya añadiste Eulerian en otra superficie, la CLI lo detecta. Y como la autenticación es OAuth 2.1 delegada en el cliente, el mismo endpoint funciona también con Claude, ChatGPT o Mistral: la parte de Eulerian es siempre la misma; solo cambia dónde se añade el conector.
CLI frente a Antigravity 2.0 y IDEEsta guía cubre la terminal (Antigravity CLI, comando agy). Antigravity 2.0 es la app de agente y el IDE es el editor de código; cada uno tiene su propia guía, pero la parte de Eulerian (endpoint + OAuth) es idéntica.
- OAuth 2.1 de Eulerian (integraciones de terceros): doc.api.eulerian.com/#section/Introduction/OAuth-2.1-for-third-party-integrations
- Guías específicas: Antigravity 2.0, Antigravity IDE, Claude, ChatGPT, Mistral y «Otros clientes».
6. Seguridad y buenas prácticas
OAuth en lugar de tokens
No se guarda ningún token de API en tu equipo. Te autenticas con tu cuenta de Eulerian y Eulerian entrega a la CLI un acceso limitado (por ejemplo, solo lectura de informes) y revocable en cualquier momento.
El código de autorización es de un solo uso
El código que pegas en la terminal es temporal y de un solo uso: sirve solo para completar la autenticación y caduca enseguida. No es un token que debas guardar ni compartir.
Permisos explícitos y mínimos
Revisa los permisos en la pantalla de autorización de Eulerian (por ejemplo eulerian:reports.read) antes de pulsar «Approve». Evita los 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.
Cierra sesión cuando termines
Usa /logout para desconectar tu cuenta y borrar las credenciales guardadas en el equipo. Antes de usar datos reales, confirma con IT qué plataformas de IA están aprobadas.
7. Si algo no funciona
«agy» no se reconoce como comando
Cierra y vuelve a abrir la terminal para que tome el nuevo PATH tras instalar. Si sigue, reinstala con el comando del Paso 1.
No veo Eulerian al abrir /mcp
Falta añadirlo al archivo de configuración: ábrelo con notepad (Paso 4) y pega el bloque del Paso 5, guarda y vuelve a abrir /mcp.
Eulerian sale como «[Auth Needed]» / «Unauthorized»
Es normal antes de identificarte. Selecciona Eulerian, pulsa Enter y elige «Authenticate» (Paso 7). Si persiste tras autenticarte, contacta con Eulerian.
El navegador no se abre en el paso de login
La terminal imprime una URL: cópiala y ábrela a mano en el navegador. Tras aprobar, copia el código y pégalo en la terminal.
Eulerian rechaza el inicio de sesión
Usa tus credenciales de Eulerian (no las de Google). Si tienes acceso a varias grids, usa el endpoint de la que corresponda.
Pegué el código pero no conecta
Copia el código completo con «Copy to Clipboard» y pégalo antes de que caduque; si expira, vuelve a lanzar «Authenticate».
Quiero empezar de cero la sesión
Ejecuta /logout en la CLI para borrar las credenciales guardadas y volver a autenticarte.
8. Recursos adicionales
- Tu endpoint de API: en la interfaz de Eulerian, apartado «Eulerian API» (añade /mcp).
- Documentación del Servidor MCP de Eulerian: doc.eulerian.com/p/sbLg7nk-W2eWAl/Servidor-MCP
- Antigravity CLI — instalación y uso (doc oficial): antigravity.google/docs/cli/install
- MCP en Antigravity CLI (doc oficial): antigravity.google/docs/cli/mcp
- OAuth 2.1 de Eulerian (integraciones de terceros): doc.api.eulerian.com/#section/Introduction/OAuth-2.1-for-third-party-integrations
- Repositorio GitHub: github.com/EulerianTechnologies/eulerian-marketing-platform-mcp