Configuración de Servidores MCP en Google Antigravity
Instrucciones detalladas paso a paso para configurar e integrar los servidores de Model Context Protocol (MCP) correspondientes a Google Search Console, Google Analytics (GA4), Sistrix, Ahrefs y Semrush en tu entorno de desarrollo de Google Antigravity.
Alex Romero López
SEO & AI Automation · seoalex.es
Consultor especializado en posicionamiento orgánico y automatización de procesos con Inteligencia Artificial para el crecimiento de negocios digitales.
Archivo de configuración global de Antigravity
Toda la configuración de tus servidores MCP en Google Antigravity se almacena en el archivo de configuración del IDE. Para hacerlo portable, puedes acceder a él utilizando variables dinámicas del sistema:
Windows
%USERPROFILE%\.gemini\config\mcp_config.jsonmacOS / Linux
~/.gemini/config/mcp_config.json(Nota: En Windows, la variable de entorno %USERPROFILE% se expande automáticamente a tu directorio de usuario, por ejemplo, C:\Users\tu_nombre_usuario).
1.Google Search Console (GSC)
Este servidor MCP corre de forma local y permite al agente de Antigravity interactuar directamente con la API oficial de Search Console para consultar clics, impresiones, CTR y posiciones.
Guía de conexión dedicada
👉 Léete esta guía para la conexión MCP con Google Search Console
2.Google Analytics 4 (GA4)
Este servidor ejecuta el servidor oficial de MCP de Google Analytics a través de pipx de forma local y segura.
Repositorio de Github: google-analytics-mcp
Para ejecutar este servidor MCP de forma aislada, es necesario instalar pipx (Pídeselo a tu agente en Google Antigravity):
pip install --user pipx
pipx ensurepath(Reinicia tu terminal o IDE para que la variable de entorno PATH se active).
- Abre tu Google Cloud Console bajo la cuenta correcta que tiene acceso a tus propiedades de Analytics.
- Asegúrate de tener seleccionado tu proyecto de GCP actual.
- Habilita de forma obligatoria las dos APIs de Analytics a través de estos enlaces directos:
- Configura tu Pantalla de Consentimiento de OAuth en modo "En pruebas" y añade tu correo electrónico como usuario de prueba (Test User) bajo la sección correspondiente. Esto evitará el error
403: access_deniedde Google. - Descarga el archivo de credenciales de cliente OAuth y guárdalo en tu espacio de trabajo como
config/ga_client_secrets.json.
Ejecuta el script de generación de credenciales ADC (Application Default Credentials) provisto en tu proyecto que abrirá tu navegador para iniciar sesión y autorizar la API de Analytics (Pídeselo a tu agente en Google Antigravity):
python scripts/generate_ga_adc.pyEsto creará el archivo seguro config/ga_adc_credentials.json listo para ser consumido por el servidor.
El comando de pipx se puede llamar de forma dinámica utilizando variables de entorno de Windows para el directorio AppData local, lo cual independiza por completo la ruta de tu nombre de usuario de Windows:
"analytics-mcp": {
"command": "%APPDATA%\\..\\Local\\Programs\\Python\\Launcher\\py.exe",
"args": [
"-m",
"pipx",
"run",
"analytics-mcp"
],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "%USERPROFILE%\\<RUTA_A_TU_WORKSPACE>\\config\\ga_adc_credentials.json",
"GOOGLE_CLOUD_PROJECT": "<TU_GOOGLE_CLOUD_PROJECT_ID>"
}
}3.Sistrix
Este servidor se conecta de forma segura a través de mcp-remote en la nube utilizando tu API Key de Sistrix.
Para integrar Sistrix, añade el siguiente bloque de configuración:
"sistrix": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.sistrix.com/mcp/",
"--header",
"Authorization: Bearer ${SISTRIX_API_KEY}"
],
"env": {
"SISTRIX_API_KEY": "<TU_SISTRIX_API_KEY>"
}
}4.Ahrefs
Al igual que Sistrix, Ahrefs se integra mediante mcp-remote conectando con su endpoint de MCP seguro utilizando tu token personal de Ahrefs.
Añade el siguiente bloque a tu listado de servidores:
"Ahrefs": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.ahrefs.com/mcp/mcp",
"--header",
"Authorization: ${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer <TU_AHREFS_PERSONAL_TOKEN>"
}
}5.Semrush
Semrush ofrece un endpoint de API MCP en la nube que permite realizar análisis SEO y PPC completos de competidores e históricos.
Paso 5.1: Configuración en mcp_config.jsonDado que Semrush expone una arquitectura directa en su endpoint, su bloque de configuración requiere declarar el endpoint URL de API y las cabeceras de autorización de la siguiente forma:
"semrush": {
"serverUrl": "https://mcp.semrush.com/v1/mcp",
"headers": {
"Authorization": "Apikey <TU_SEMRUSH_API_KEY>"
}
}Solución de problemas y diagnósticos frecuentes
1Error 403: Google Analytics Data API has not been used...
Causa: La API Data no está habilitada o está activa en un proyecto de Google Cloud diferente del declarado en la configuración.
Solución: Asegúrate de abrir la consola de GCP con el ID de proyecto explícito en la URL: https://console.cloud.google.com/apis/library/analyticsdata.googleapis.com?project=<TU_PROJECT_ID> y pulsa "Habilitar". Adicionalmente, ten en cuenta que la propagación en los servidores de Google puede tardar hasta 5 minutos tras la activación.
2Error 403: access_denied en el Consentimiento OAuth (GA4)
Causa: La pantalla de consentimiento de OAuth de GCP está configurada en modo "Testing" (Pruebas) y tu correo no ha sido añadido a la lista de usuarios permitidos.
Solución: Ve a APIs y servicios → Pantalla de consentimiento de OAuth → Usuarios de prueba y añade el correo de Google con el que intentarás iniciar sesión.
3Error 404: Property Not Found en Search Console
Causa: La URL del sitio consultado no coincide exactamente con el tipo de propiedad en GSC.
Solución: Recuerda que las propiedades con prefijo de URL (https://example.com/) no son equivalentes a las propiedades de dominio (sc-domain:example.com). Ejecuta la herramienta list_properties para ver y copiar el string de propiedad exacto registrado en tu cuenta de GSC.
Conclusión
Una vez que guardes tu archivo mcp_config.json con estas configuraciones, tu Agente AI de Google Antigravity podrá acceder de forma simultánea a todas las herramientas. Podrás pedirle comandos directos combinados, tales como:
"Extrae el tráfico de Search Console de dominio.com de los últimos 6 meses excluyendo marca, obtén las sesiones y leads convertidos desde Google Analytics para ese mismo periodo, compáralo con el Índice de Visibilidad de Sistrix y el DR de Ahrefs, y generame un reporte HTML interactivo con los estilos de mi manual de marca."
El agente llamará de manera inteligente a cada servidor de forma aislada, unificará las respuestas y compilará interfaces de impacto ejecutivo de forma 100% automatizada.