¿Dónde guarda Antigravity mcp_config.json y por qué a veces tu edición no cambia nada? Consulta las rutas global y de workspace en Windows, macOS y Linux, las tres formas de abrir el archivo, cómo la MCP Store añade servidores, un ejemplo de JSON que funciona y soluciones para los errores más comunes.
Pegas un servidor nuevo en Antigravity, pulsas Refresh y la lista de herramientas sigue vacía. Muchas veces el servidor está bien. El problema está en el archivo: cuál mcp_config.json lee la app, dónde está en tu disco y si el JSON usa los nombres de campo que espera Antigravity. Las páginas de Google apuntan a dos rutas distintas, los foros muestran a gente editando la copia equivocada, y los mensajes de error son tan cortos que parecen adivinanzas.
Este artículo fija los hechos. Obtienes la ubicación exacta del archivo en Windows, macOS y Linux, tres formas de abrirlo desde la app, un recorrido por la MCP Store, una configuración que funciona y una solución sencilla para cada error habitual. Cuando las fuentes no coinciden, el texto lo dice en lugar de adivinar.
Antigravity guarda la definición de cada servidor MCP en un único archivo JSON llamado mcp_config.json. La página oficial de MCP describe un archivo global, que se aplica a todos los proyectos, y un archivo de workspace, que se aplica a un solo repositorio.
| Sistema | Ruta global |
|---|---|
| Windows | %USERPROFILE%\.gemini\config\mcp_config.json |
| macOS | ~/.gemini/config/mcp_config.json |
| Linux | ~/.gemini/config/mcp_config.json |
En Windows, %USERPROFILE% se expande a algo como C:\Users\YourName. La carpeta .gemini empieza por un punto, así que Finder y la mayoría de gestores de archivos de Linux la ocultan. En Finder pulsa Cmd+Shift+. para mostrar los elementos ocultos; en el explorador de Windows marca Elementos ocultos en el menú Ver, o sáltate la navegación y pega la ruta completa en la barra de direcciones o en el cuadro Ir a la carpeta.
Dentro de un repositorio, la documentación indica .agents/mcp_config.json como ubicación del workspace. Encaja con los servidores que solo tienen sentido para una base de código, como un servidor de base de datos apuntado al esquema de desarrollo de ese proyecto. Una guía japonesa de resolución de problemas indica que los ajustes del workspace pueden sobrescribir el archivo global, así que revisa primero esta ruta cuando un servidor se comporte distinto dentro de un repositorio concreto.
💡 Tip: Si un archivo de workspace contiene tokens, añade
.agents/mcp_config.jsona.gitignoreantes de tu próximo commit.
La documentación actual y la página de configuración de CloudBees Unify usan ~/.gemini/config/mcp_config.json. Los tutoriales antiguos, muchos READMEs de servidores y el informe de error de PATH en macOS usan ~/.gemini/antigravity/mcp_config.json. El archivo de tokens OAuth también está en la carpeta antigravity, y eso explica en parte por qué ese nombre de carpeta aparece tanto.
Ninguna página dice qué archivo prevalece cuando existen los dos. Resuélvelo con una prueba: añade una entrada inofensiva a un archivo, pulsa Refresh y comprueba si aparece en la lista de servidores. Si no aparece, editaste el archivo equivocado. Después mantén un único archivo activo y renombra la copia sobrante a mcp_config.json.bak para que nunca se desincronicen. Abrir el archivo mediante View raw config en el IDE es la forma más rápida de ver cuál usa tu versión.
No tienes que buscar entre carpetas ocultas. Cada superficie de Antigravity tiene su propia vía de acceso a la misma configuración.
En el IDE de Antigravity, haz clic en el menú … en la parte superior del panel lateral del agente y elige MCP Servers, después Manage MCP Servers y luego View raw config. El archivo se abre en el editor. Guárdalo, vuelve a la pantalla Manage MCP Servers y pulsa Refresh. Ese último clic es el paso que los hilos de resolución de problemas recomiendan una y otra vez.
En Antigravity 2.0 la ruta es Settings (abajo a la izquierda), luego Customizations y después Installed MCP Servers. Cada servidor tiene un interruptor, un icono de papelera y un botón Refresh compartido. La herramienta de línea de comandos tiene su propia puerta: escribe /mcp en el panel de prompts para abrir el MCP Manager interactivo. También muestra los registros de conexión, incluidos códigos de respuesta como 401, 403 y 404 y los tiempos de espera, lo que lo convierte en el mejor lugar para leer qué salió mal de verdad.
La MCP Store es una lista buscable de servidores listos para usar. La documentación describe 76 o más integraciones en bases de datos, herramientas para desarrolladores, plataformas de diseño, seguridad y analítica. Se accede desde Installed MCP Servers haciendo clic en Add MCP, o desde el menú MCP Servers del panel del agente del IDE.
Abre la configuración en bruto una vez tras tu primera instalación desde la MCP Store. La entrada que escribió la Store es una plantilla lista para las entradas que escribas a mano más adelante.
💡 Tip: Usa la MCP Store para los servidores que necesitan OAuth, porque gestiona la pantalla de inicio de sesión. Usa JSON escrito a mano para scripts locales, servidores privados y cualquier cosa que necesite cabeceras personalizadas.
Según la documentación, los tokens OAuth se guardan en ~/.gemini/antigravity/mcp_oauth_tokens.json. Trata ese archivo como una caja fuerte de contraseñas: mantenlo fuera de repositorios de dotfiles y de carpetas de sincronización en la nube. Cuando un inicio de sesión sigue fallando, usa primero el botón Sign out del IDE, o revisa el estado Authed en la vista /mcp de la CLI. Borrar el archivo de tokens es el último recurso, y puede cerrar tu sesión en todos los servidores remotos a la vez.
El archivo tiene un objeto de nivel superior, mcpServers, y cada servidor es una entrada con nombre dentro de él. Los nombres no deben llevar espacios. Un hilo del foro sobre el servidor de Figma descubrió que un nombre sugerido como "Figma Desktop" tenía que convertirse en FigmaDesktop, y que el campo de URL debía ser serverUrl, no url.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "C:/Users/you/projects"],
"env": { "NODE_ENV": "production" },
"cwd": "C:/Users/you/projects"
}
}
}
En Windows, escribe las rutas con barras diagonales normales o duplica las barras invertidas (C:\\Users\\you), porque una barra invertida sencilla es un carácter de escape en JSON. Esto es lo que hace cada campo:
| Campo | Función | Notas |
|---|---|---|
command | Programa que arranca un servidor local | Debe estar en PATH, o usa una ruta absoluta |
args | Argumentos de ese programa | Una cadena por argumento |
env | Variables de entorno | Pon los tokens aquí en lugar de en args |
cwd | Directorio de trabajo | Opcional |
serverUrl | Endpoint de un servidor remoto | Sustituye a command en servidores HTTP |
headers | Cabeceras HTTP enviadas a un servidor remoto | Los bearer tokens van aquí |
oauth | Ajustes del cliente, como clientId | Necesario en algunos servidores remotos |
disabledTools | Nombres de herramientas ocultas para el modelo | Ayuda con el límite de 100 herramientas |
{
"mcpServers": {
"remote-example": {
"serverUrl": "https://api.example.com/mcp/",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}
La documentación dice que los campos url simples no se admiten en servidores remotos, así que un fragmento copiado de otro editor necesita ese único cambio de nombre. Los servidores que usan OAuth reciben un bloque oauth en lugar de una cabecera: la página de CloudBees muestra "oauth": { "clientId": "public-mcp-client" }. Para los servidores de Google Workspace creas un cliente OAuth de tipo Web application en Google Cloud Console, añades https://antigravity.google/oauth-callback como URI de redirección y pones el clientId y el clientSecret en la sección oauth. Los servidores que aceptan las credenciales predeterminadas de aplicación de Google usan "authProviderType": "google_credentials".
Antes de guardar, revisa tres cosas que rompen el JSON más a menudo que cualquier error de Antigravity: las comas finales, los comentarios (JSON no admite ninguno) y las comillas tipográficas copiadas desde una página web.
| Mensaje | Causa probable | Primera solución |
|---|---|---|
context deadline exceeded o [MCP Proxy] Socket connection error: connect ENOENT | Falló la inicialización al arrancar el IDE | Manage MCP Servers y luego Refresh |
exec: "npx": executable file not found in $PATH | La app se abrió desde el Dock o Spotlight sin tu PATH del shell | Ábrela con agy desde una terminal, o usa una ruta absoluta |
calling 'initialize': sending 'initialize': Unauthorized | Falta el token en la primera petición a un servidor remoto | Actualiza la app e inicia sesión de nuevo |
enabled tools would exceed max limit of 100 | Demasiadas herramientas habilitadas entre todos los servidores | Desactiva servidores o lista disabledTools |
connection closed: calling 'initialize': client is closing: EOF | El proceso del servidor terminó durante el handshake | Ejecuta el mismo comando en una terminal y lee su salida |
Esto aparece al arrancar, junto con el mensaje de socket ENOENT, cuando un servidor no termina de inicializarse a tiempo. La solución que se ha informado es sencilla: abre Manage MCP Servers y pulsa Refresh. Si vuelve a aparecer en cada reinicio, una alternativa práctica es instalar el paquete del servidor de forma global y apuntar command al binario instalado, así no hay que descargar nada mientras el IDE se inicia.
Mensajes como exec: "npx": executable file not found in $PATH aparecen cuando Antigravity se inicia desde el Dock o Spotlight de macOS. La app hereda el PATH escaso del sistema (/usr/bin:/bin:/usr/sbin:/sbin) en lugar del que aparece en tu perfil de shell. El hilo lo informa en la versión 1.22.2 y propone estas alternativas:
agy.command. Ejecuta which npx y pega el resultado, por ejemplo /opt/homebrew/bin/npx en una configuración típica de Homebrew con Apple Silicon.Los usuarios de Windows deben ejecutar primero where npx en una terminal. Si no imprime nada, el problema está en la instalación de Node, no en la configuración.
Un error Unauthorized en initialize significa que un servidor remoto recibió la primera petición sin un token utilizable. Actualiza Antigravity, cierra la sesión del servidor e inicia sesión de nuevo. Si usas un token en una cabecera, confirma que el campo se llama Authorization, que el valor empieza por Bearer y que el token no ha caducado. El código de estado en los registros de la vista /mcp de la CLI ayuda a acotarlo: 401 indica credenciales ausentes o incorrectas, 403 un token sin los permisos adecuados y 404 una ruta de URL incorrecta.
Antigravity se niega a conectarse cuando las herramientas habilitadas en todos los servidores superarían las 100. Los servidores grandes de GitHub o de bases de datos pueden exponer decenas de herramientas cada uno, así que con tres o cuatro de ellos basta para chocar con el límite. Desactiva los servidores que no uses u oculta herramientas concretas con la propiedad disabledTools que aparece en la documentación.
Hay otro patrón que conviene conocer. Un informe del foro de desarrolladores de Google AI describe un servidor de Roblox Studio, iniciado mediante un archivo batch, que falló con el mensaje EOF en Hub 2.4.3, 2.5.0 y 2.8.0 y solo volvió a funcionar tras revertir a Hub 2.2.1. Cuando un servidor local falla así, ejecuta su comando exacto en una terminal. Si también falla ahí, la configuración está bien y el problema es el servidor. Si funciona, sospecha de una regresión de versión y revisa el foro antes de cambiar tu JSON.
Cuando el JSON no se comporta, un modelo de lenguaje es un corrector rápido. Gemini 3.1 Pro funciona en el navegador en PicassoIA, acepta texto y hasta 10 imágenes y te permite decidir cuánto razona el modelo antes de responder.
YOUR_TOKEN antes de pegar nada.high. Déjalo para una configuración larga con muchos servidores. low basta para una comprobación de sintaxis sencilla.El modelo no puede ver tu disco, así que trata cualquier ruta que sugiera como una suposición y compárala con la tabla anterior de este artículo. Para una segunda opinión sobre el mismo prompt, pásalo también por Claude Sonnet 4.6 y compara las dos respuestas.
Repasa esta lista antes de culpar al servidor:
serverUrl, y los locales usan command con args.command contiene una ruta absoluta.env o headers, y el archivo queda fuera del control de versiones si contiene secretos./mcp de la CLI.💡 Tip: Un servidor que funciona en tu terminal pero falla dentro de Antigravity suele apuntar a una diferencia de entorno, sobre todo en PATH. Compara la salida de
whichowherecon lo que ve la app.
Una vez conectados tus servidores, tu agente puede construir más rápido, y cualquier proyecto que se publica también necesita imágenes: banners de README, cabeceras de documentación, cabeceras de blog y vistas previas para redes sociales. Picasso IA reúne los modelos de imagen en un solo lugar, así que puedes probar un prompt, cambiar la lente o la luz y generar de nuevo en segundos.
Empieza con Seedream 4.5 para escenas fotorrealistas detalladas o con P-Image para borradores rápidos. Describe el sujeto, el escenario, la dirección de la luz y la lente de la cámara, igual que explicarías el encargo a un fotógrafo. Explora la lista completa de modelos, elige uno que encaje con tu próximo proyecto y crea tu primera imagen hoy mismo.
Elige tu idioma
