Guía de integración de Eulerian MCP con Antigravity

Guía de integración de Eulerian MCP con Antigravity

EULERIAN MCP
  • Guía de integración con Google Antigravity
  • Para usuarios sin conocimientos técnicos avanzados
  • Conector remoto con OAuth 2.1 · App de escritorio · mcp_config.json

1. Qué es y en qué se diferencia de las otras versiones

Esta guía conecta Google Antigravity con el servidor MCP remoto de Eulerian. Antigravity es la aplicación de escritorio de Google (un IDE con agente); 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. La diferencia principal frente a Claude, ChatGPT o Mistral es que aquí el conector se configura desde un archivo de configuración y el inicio de sesión 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 Antigravity 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 exportar datos manualmente.

2. Antes de empezar

Necesitas estos cuatro elementos antes de continuar:
Title
Title
1
La app de Antigravity
Descarga e instala Antigravity para tu sistema (Windows, macOS o Linux) desde  antigravity.google/download . Esta guía usa Antigravity 2.0 (app de escritorio).
Title
Title
2
Una cuenta de Google
Antigravity se inicia con «Continue with Google», así que necesitas una cuenta de Google para usar la aplicación.
Title
Title
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».
Title
Title
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 la app de escritorio, 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
Ve a  antigravity.google/download  y descarga Antigravity para tu sistema (Windows, macOS o Linux). Instálalo como cualquier aplicación de escritorio. Esta guía usa Antigravity 2.0.
Página de descarga oficial de Google Antigravity, con versiones para macOS, Windows y Linux.
Paso 2 Ábrelo e inicia sesión con Google
Al abrir Antigravity por primera vez, pulsa Continue with Google y sigue el asistente de bienvenida hasta llegar a la ventana principal, donde tienes New Conversation y, abajo a la izquierda, Settings.
Pantalla de bienvenida: inicia sesión con «Continue with Google».
La ventana principal de Antigravity, con «New Conversation» y «Settings» abajo a la izquierda.
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 los ajustes de MCP en Antigravity
En Antigravity, abre Settings (abajo a la izquierda) y ve a Customizations. En el bloque Installed MCP Servers verás los botones Add MCP, Refresh y Open MCP Config.
Settings → Customizations: el bloque «Installed MCP Servers» con «Open MCP Config».
Paso 5 Añade el servidor de Eulerian en mcp_config.json
Pulsa Open MCP 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:
{"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 6 Pulsa Refresh y luego Authenticate
Vuelve a Customizations y pulsa Refresh. Aparecerá el servidor Eulerian con un botón Authenticate. Púlsalo para iniciar el inicio de sesión OAuth.
Tras «Refresh», el conector «Eulerian» muestra el botón «Authenticate».
Estado de error: si ves «initialize: Unauthorized» sin botón «Authenticate», revisa la Sección 7.
Si no aparece el botón «Authenticate»Si en su lugar ves «Error: initialize Unauthorized», el servidor MCP no está anunciando correctamente el OAuth. Espera unos segundos y pulsa «Refresh» de nuevo; si persiste, contacta con Eulerian (ver Sección 7).
Paso 7 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. Antigravity nunca ve tu contraseña.
Pantalla de inicio de sesión de Eulerian.
Paso 8 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 9 Copia el código y pégalo en Antigravity
Tras aprobar, Antigravity muestra un código de un solo uso. Pulsa Copy to Clipboard, vuelve a Antigravity y pega el código en el campo «Paste auth code»; después pulsa Submit.
Antigravity muestra un código de un solo uso: cópialo con «Copy to Clipboard» (código ocultado).
En Antigravity, pega el código en «Paste auth code» y pulsa «Submit».
Paso 10 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» en Antigravity o desde tu cuenta de Eulerian.
Paso 11 Úsalo
Abre una conversación nueva y pregunta en lenguaje natural. Antigravity 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?
Antigravity responde usando el MCP de Eulerian, listando las herramientas 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 local; puedes tener varios servidores MCP a la vez.
  • 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 Antigravity o revocarlo desde tu cuenta de Eulerian en cualquier momento.

5. Otros clientes y notas

Como la autenticación se hace con OAuth 2.1 y queda delegada en el cliente MCP, el mismo endpoint remoto de Eulerian funciona con otros clientes compatibles con MCP (Claude, ChatGPT, Mistral, etc.). La parte de Eulerian — URL del endpoint, inicio de sesión OAuth y autorización — es siempre la misma; lo que cambia es dónde añade cada plataforma el conector.
App de escritorio frente a Antigravity CLIEsta guía cubre la app de escritorio (Antigravity 2.0), que se configura desde Settings → Customizations con OAuth. Antigravity también ofrece una CLI y un IDE; la forma de añadir el servidor MCP puede variar, 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: Claude (web y escritorio), 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 Antigravity 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.

Permisos explícitos y mínimos

Revisa los permisos que aparecen en la pantalla de autorización de Eulerian (por ejemplo eulerian:reports.read) antes de pulsar «Approve». Concede solo lo necesario y 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.

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

Problema
Solución
El conector muestra «initialize: Unauthorized» y no aparece «Authenticate»
El servidor MCP no está anunciando bien el OAuth. Pulsa «Refresh» de nuevo tras unos segundos; si persiste, contacta con Eulerian para que revisen el descubrimiento OAuth del endpoint.
No encuentro dónde añadir el conector
En Settings → Customizations, bloque «Installed MCP Servers», usa «Open MCP Config» para editar mcp_config.json.
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.
La conexión no llega al servidor
El endpoint debe ser accesible desde tu equipo por internet. Si está tras un firewall o VPN corporativo, puede que no conecte.
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 asistente dice que no tiene acceso al MCP
Comprueba que el conector está en verde («Sign out») y activado (interruptor). 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 
  • 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