Cómo configurar un servidor MCP en Antigravity IDE

Qué hace un servidor MCP en Antigravity IDE

Model Context Protocol, o MCP, proporciona una forma estándar de ofrecer herramientas y contexto externo a un agente. Un servidor puede exponer el esquema de una base de datos, documentación, incidencias, recursos de nube, un analizador de archivos o una API remota. Antigravity inicia el proceso configurado o se conecta al endpoint declarado, descubre sus herramientas y las presenta al agente dentro de los permisos que apruebes.

Instalar un servidor MCP no equivale a instalar un tema visual. Un servidor local por stdio ejecuta un comando en tu equipo. Un servidor remoto recibe solicitudes y puede necesitar OAuth o un token. Antes de añadirlo, identifica al editor, los datos que puede leer, las operaciones que puede realizar y si realmente necesita salir del repositorio activo.

El proceso de esta página sigue la documentación actual de Google y distingue el IDE de Antigravity de la CLI. El IDE ofrece una tienda y edición de JSON. La CLI dispone del administrador interactivo /mcp, pero ese comando no sustituye la comprobación del servidor dentro del producto que utilizarás.

Elegir configuración MCP global o por proyecto

Utiliza el alcance más estrecho que resuelva la necesidad. La entrada global es cómoda para herramientas personales repetidas; la entrada del proyecto es más fácil de revisar, compartir y eliminar con el repositorio.

Instalar un servidor desde la tienda MCP

Abre un proyecto real, espera a que finalicen el inicio de sesión y la inicialización y pulsa el menú de tres puntos en la parte superior del panel del agente. Selecciona MCP Servers. Pasa el cursor por una integración compatible y elige Install, o abre primero sus detalles. Completa el flujo oficial de autenticación y vuelve a la lista para confirmar que aparece.

Empieza con un único servidor. Si instalas muchos a la vez será difícil saber qué proceso, credencial o definición causó un fallo. Además, demasiadas herramientas aumentan las opciones que el agente debe interpretar. Una prueba limpia tiene un editor conocido, un método de acceso y una solicitud concreta.

1. Paso 1 — Abre el panel del agente y pulsa el menú de tres puntos.
2. Paso 2 — Elige MCP Servers y revisa editor, origen y acceso solicitado.
3. Paso 3 — Instala un servidor, completa su autenticación oficial y recarga.
4. Paso 4 — Solicita una lectura segura y revisa el resultado y los permisos.

Añadir un servidor personalizado con mcp_config.json

Si el servidor no está en la tienda, abre MCP Servers, selecciona Manage MCP Servers y View raw config. La ubicación global documentada es ~/.gemini/config/mcp_config.json; el archivo local puede estar en .agents/mcp_config.json. Conserva un solo objeto mcpServers en la raíz. El comando, los argumentos, el endpoint y la autenticación deben proceder de la documentación oficial del servidor.

El ejemplo es intencionadamente inerte. En un servidor stdio, command y args inician el proceso. Para conexiones remotas actuales, la documentación de Google usa serverUrl; los campos antiguos url o httpUrl pueden no funcionar. No adivines rutas por el nombre de un CDN y no escribas claves privadas en un archivo que se va a confirmar en Git.

{
  "mcpServers": {
    "servidor-ejemplo": {
      "command": "COMANDO_OFICIAL",
      "args": ["ARGUMENTO_OFICIAL"]
    },
    "remoto-ejemplo": {
      "serverUrl": "https://ENDPOINT_OFICIAL_DE_EJEMPLO/mcp"
    }
  }
}

Es una muestra de estructura, no un servidor funcional. Copia ejecutable, paquete, URL, cabeceras y OAuth únicamente de la fuente oficial elegida.

Recargar y verificar el servidor MCP

Guarda un JSON válido, regresa a la lista y recarga la configuración. Una carga correcta debe mostrar el servidor y permitir inspeccionar sus herramientas o recursos. No empieces con una acción destructiva: pide la lista de recursos, la lectura de un documento de prueba o solo los nombres de las herramientas.

Si existe autenticación, confirma cuenta y alcance. Un indicador verde solo prueba una conexión, no que el servicio sea apropiado para datos confidenciales. Revisa el nombre de la herramienta, sus argumentos y la fuente devuelta antes de memorizar un permiso.

• Cargado — Aparece el nombre esperado y se puede inspeccionar la lista de herramientas.
• Autorizado — La cuenta y el alcance concedido coinciden con el proyecto previsto.
• Fundamentado — La prueba de lectura devuelve la fuente esperada y no datos inventados.
• Reversible — Sabes desactivar la entrada, revocar el token y borrar la configuración.

Seguridad y permisos de MCP

Trata cada servidor como código que cruza un límite de datos. Prefiere una implementación del proveedor original o un repositorio que puedas inspeccionar. Fija versiones cuando sea posible y evita ejecutar instaladores de shell de tutoriales sin verificar. Para nube o bases de datos, utiliza una cuenta de desarrollo con privilegios mínimos en lugar de un propietario de producción.

El alcance del proyecto no crea por sí solo un sandbox. El proceso puede leer lo permitido por la cuenta del sistema operativo. Mantén secretos fuera de prompts y JSON confirmado. Revisa siempre operaciones de escritura, borrado, despliegue, pagos, mensajería y administración de cuentas hasta que exista una política documentada.

Solucionar errores MCP en Antigravity IDE y WSL

Los fallos suelen proceder del alcance equivocado, JSON inválido, PATH, autenticación o rutas mezcladas entre Windows y WSL. Cambia una variable cada vez.

El servidor no aparece tras recargar

Valida JSON, confirma que mcpServers está en la raíz y edita el archivo que muestra Manage MCP Servers. Comprueba si existe otro archivo local o global. Reinicia el IDE solo después de que falle una recarga normal.

El comando funciona en una terminal, pero no en el IDE

El proceso gráfico puede usar otro PATH, directorio personal, shell o variables. Usa una ruta absoluta si el proveedor la admite y reinicia Antigravity después de cambiar variables del sistema.

El servidor se ejecuta mal desde WSL

Decide qué sistema inicia el proceso. Un IDE de Windows suele necesitar wsl.exe explícito y rutas Linux dentro de ese comando. Un proceso de WSL no debe recibir C:\ como si fuera una ruta Linux. Prueba exactamente el mismo comando fuera del IDE.

El remoto conecta pero no muestra herramientas

Revisa el endpoint oficial, la autenticación y el transporte. La configuración actual usa serverUrl. No pegues la URL de una página de producto o panel cuando se requiere el endpoint MCP real.

El servidor se inicia y se detiene

Ejecuta el proceso directamente e inspecciona stderr sin publicar secretos. Busca un runtime ausente, versión no compatible, logs enviados por stdout o credenciales caducadas.

Comprobación de versión y fuente de descarga

Este es un sitio de descarga de software, por lo que se completó la comprobación antes de publicar. El 24 de julio de 2026, el changelog oficial de Google mostraba la versión 2.2.1 con fecha 25 de junio de 2026. El sitio ya indicaba v2.2.1, así que no fue necesario cambiar el número. Esta página no afirma un tamaño, checksum, análisis de seguridad ni URL permanente de paquete que no estén verificados.

El botón lleva a la página oficial como alternativa comprobada. Verifícala de nuevo antes de instalar porque Google indica que el despliegue puede ser gradual. Los menús MCP también pueden cambiar; utiliza la documentación oficial enlazada como autoridad final para rutas y esquemas remotos.