Guía de integración de Eulerian MCP con Antigravity IDE
EULERIAN MCP
- Guía de integración con Antigravity IDE
- Para usuarios sin conocimientos técnicos avanzados
- Conector remoto con OAuth 2.1 · Editor de código · mcp_config.json
1. Qué es y en qué se diferencia de las otras versiones
Esta guía conecta Antigravity IDE con el servidor MCP remoto de Eulerian. Antigravity IDE es el editor de código de Google (basado en VS Code) con un agente integrado; admite servidores MCP remotos con autenticación OAuth 2.1. No instalas ningún servidor local ni 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, aquí el conector se gestiona desde el panel del agente del editor (menú de MCP Servers) y, como en la 2.0, el login OAuth incluye un paso de copiar y pegar un código.
El principio, en una fraseEndpoint remoto + inicio de sesión OAuth: no instalas servidores locales, no guardas tokens de API y el IDE 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 del editor ni exportar datos manualmente.
2. Antes de empezar
Necesitas estos cuatro elementos antes de continuar:
1
Antigravity IDE
Descarga e instala Antigravity IDE para tu sistema (Windows, macOS o Linux) desde antigravity.google/download (sección «Antigravity IDE»).
2
Una cuenta de Google
Antigravity se inicia con tu cuenta de Google, así que necesitas una para usar el editor.
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: en el IDE, 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 Descarga e instala Antigravity IDE
Ve a antigravity.google/download , baja hasta la sección Antigravity IDE y descarga la versión para tu sistema (Windows, macOS o Linux). Instálalo como cualquier aplicación de escritorio.
Sección «Antigravity IDE» de la página de descarga oficial, con versiones para macOS, Windows y Linux.
Paso 2 Ábrelo
Abre Antigravity IDE. Verás el editor con su panel del agente a la derecha (donde pone «Ask anything…»). Desde ahí gestionaremos el conector.
La ventana principal de Antigravity IDE, con el editor y el panel del agente a la derecha.
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 APIA diferencia de otros métodos, aquí 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 «MCP Servers» desde el panel del agente
En el panel del agente (a la derecha), pulsa el botón de tres puntos «…» (Additional options) de la parte superior. Se despliegan las opciones de personalización; elige MCP Servers.
En el panel del agente, pulsa los tres puntos «…» (Additional options) y elige «MCP Servers».
Paso 5 Pulsa «Manage MCP Servers»
Por defecto se abre el MCP Store (un catálogo de conectores). Como Eulerian no está en el catálogo, pulsa arriba a la derecha «Manage MCP Servers» para añadirlo manualmente.
El MCP Store se abre por defecto; pulsa «Manage MCP Servers» (arriba a la derecha).
Paso 6 Abre «View raw config» y añade el servidor
En Manage MCP servers, pulsa arriba a la derecha «View raw config» para abrir el archivo mcp_config.json. Añade el servidor de Eulerian con tu endpoint y /mcp al final, y guarda el archivo:
En «Manage MCP servers», pulsa «View raw config» (arriba a la derecha) para editar el archivo.
{"mcpServers": {"eulerian": {"serverUrl": "https://<tu-endpoint-de-API-de-Eulerian>/mcp"}}}
mcp_config.json con el servidor «eulerian» y su serverUrl terminado en /mcp (endpoint de demostración).
Paso 7 Fuerza el Refresh y aparecerá «Authenticate»
Tras guardar, el botón Refresh puede quedarse girando (las dos flechas en círculo no paran). Fuérzalo pulsándolo. Junto a Eulerian aparecerá el aviso «Error: calling initialize... Unauthorized» y el botón Authenticate.
Tras forzar «Refresh», aparece el aviso «Unauthorized» junto al botón «Authenticate».
El «Unauthorized» aquí es normalEs el estado previo a identificarte: aún no has hecho el login OAuth. Desaparece en cuanto completes la autenticación de los pasos siguientes.
Paso 8 Pulsa «Authenticate» (dos veces)
Pulsa Authenticate. Te llevará a Settings → Customizations, donde verás de nuevo el conector Eulerian con su botón Authenticate: púlsalo otra vez para lanzar el inicio de sesión OAuth en el navegador.
El botón «Authenticate» te lleva a Settings → Customizations; vuelve a pulsar «Authenticate» ahí.
Paso 9 Inicia sesión en Eulerian
Se abrirá la pantalla de inicio de sesión de Eulerian en tu navegador. Introduce tu usuario (Identifiant) y continúa con tu contraseña de Eulerian. El IDE nunca ve tu contraseña.
Pantalla de inicio de sesión de Eulerian.
Paso 10 Autoriza el acceso (Approve)
Eulerian mostrará los permisos que solicita antigravity-client (por ejemplo eulerian:reports.read). Revísalos y pulsa «Approve» para autorizar (o «Deny» para cancelar).
Pantalla de autorización de Eulerian: revisa los permisos y pulsa «Approve».
Concede solo lo necesarioRevisa siempre los permisos antes de aprobar. Para solo lectura de informes basta con eulerian:reports.read; concede permisos de escritura únicamente si tu caso de uso lo requiere.
Paso 11 Copia el código y pégalo en el IDE
El navegador muestra un código de un solo uso. Pulsa Copy to Clipboard, vuelve al IDE y pega el código en el campo «Paste auth code» (es la misma caja que en Antigravity 2.0, con el fondo oscuro del editor); después pulsa Submit.
Antigravity muestra un código de un solo uso: cópialo con «Copy to Clipboard» (código ocultado) y pégalo en el IDE.
Paso 12 Conector conectado
El conector Eulerian pasa a verde con el botón Sign out y muestra el número de herramientas activadas (por ejemplo «133 tools enabled»). Ya está conectado.
Conector «Eulerian» conectado (punto verde, «Sign out») con las herramientas activadas.
Conexión completadaSin instalar servidores locales y sin guardar tokens de API. Puedes revocar el acceso en cualquier momento con «Sign out» o desde tu cuenta de Eulerian.
Paso 13 Elige qué herramientas activar (opcional)
Desde Manage MCP servers → Configure, el IDE te permite activar o desactivar cada una de las 134 herramientas de Eulerian con su interruptor. Es útil para limitar el conector solo a lo que necesites (por ejemplo, dejar activas las de informes y desactivar el resto).
En «Configure» puedes activar/desactivar cada una de las 134 herramientas de Eulerian de forma individual.
Paso 14 Úsalo
En el panel del agente, pregunta en lenguaje natural. El IDE llamará a las herramientas de Eulerian según lo que pidas, por ejemplo:
¿A qué herramientas de Eulerian tienes acceso y qué websites hay en mi cuenta?
El agente del IDE responde usando el MCP de Eulerian, listando las herramientas y los websites disponibles.
4. Equipos y organizaciones
Antigravity guarda la configuración de MCP 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: puedes desconectarlo con «Sign out» en el IDE o revocarlo 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). Si ya añadiste el servidor de Eulerian en una superficie, las demás lo detectan. Y como la autenticación es OAuth 2.1 delegada en el cliente, el mismo endpoint remoto 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.
IDE frente a Antigravity 2.0 y CLIEsta guía cubre el editor de código (Antigravity IDE). Antigravity 2.0 es la app de agente sin editor, y la CLI (agy) se maneja desde la terminal con el comando /mcp; cada una 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 CLI, 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 al IDE 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 copias y pegas durante el login 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.
Activa solo las herramientas que uses
En «Manage MCP servers → Configure» puedes desactivar las herramientas que no necesites. Reducir la superficie activa es una buena práctica de mínimos privilegios.
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.
Valida con tu departamento de IT
Antes de usar datos reales de negocio, confirma con IT qué plataformas de IA están aprobadas para tratar datos de la empresa.
7. Si algo no funciona
No encuentro dónde añadir el conector
En el panel del agente, pulsa los tres puntos «…» (Additional options) → «MCP Servers» → «Manage MCP Servers» → «View raw config».
El botón «Refresh» se queda girando
Es habitual tras editar el archivo: pulsa «Refresh» para forzarlo. Aparecerá el estado del conector (y el botón «Authenticate» si aún no te has identificado).
Veo «Unauthorized» y el botón «Authenticate»
Es normal antes de iniciar sesión. Pulsa «Authenticate», y de nuevo «Authenticate» en Settings → Customizations, y completa el login. Si el «Unauthorized» persiste tras autenticarte, contacta con Eulerian.
La conexión no se establece o se marca inválida
Revisa la URL: debe ser tu endpoint de API de Eulerian con /mcp al final, por HTTPS y con un certificado TLS válido.
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 sigue sin conectar
Copia el código completo con «Copy to Clipboard» y pégalo en «Paste auth code» antes de que caduque; si expira, repite desde «Authenticate».
El agente dice que no tiene acceso al MCP
Comprueba que el conector está en verde («Sign out») y que las herramientas que necesitas están activadas en «Configure». Abre una conversación nueva y vuelve a preguntar.
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
- MCP en Antigravity (doc oficial): antigravity.google/docs/mcp
- OAuth 2.1 de Eulerian (integraciones de terceros): doc.api.eulerian.com/#section/Introduction/OAuth-2.1-for-third-party-integrations
- Descarga de Antigravity: antigravity.google/download
- Repositorio GitHub: github.com/EulerianTechnologies/eulerian-marketing-platform-mcp