Conexión de Servidores MCP en Google Antigravity

Para clonar el conector y configurar el entorno virtual de trabajo de forma automatizada, abre una conversación con tu agente en Google Antigravity y facilítale esta instrucción precisa:

Por favor, configura el servidor MCP para Google Search Console. Necesito que clones el repositorio desde esta dirección: https://github.com/AminForou/mcp-gsc. A continuación, prepara el entorno para que funcione correctamente como conector en este espacio de trabajo.

1. Inicia sesión en tu consola de Google Cloud Console con la cuenta propietaria del sitio en Search Console.
2. Crea un Proyecto Nuevo (por ejemplo, Conexion-SEO-Antigravity).
3. Busca Google Search Console API a través del buscador superior de GCP y haz clic en Habilitar.
4. En el menú lateral, ve a APIs y servicios → Pantalla de consentimiento de OAuth:
   • Selecciona el tipo de usuario (Interno o Externo) y rellena los datos mínimos obligatorios (nombre de la aplicación y tu correo).
   • Si seleccionaste "Externo", asegúrate de añadir tu propio correo en la lista de Usuarios de prueba (Test Users).
5. Dirígete a APIs y servicios → Credenciales:
   • Haz clic en + Crear credenciales y selecciona ID de cliente de OAuth.
   • En Tipo de aplicación, elige App de escritorio (Desktop app), asígnale un nombre y pulsa en Crear.
   • Descarga el archivo generado seleccionando Descargar JSON y guárdalo en tu ordenador.

Entrega el contenido de tus credenciales OAuth descargadas al agente de Antigravity (utilizando la mención @ de archivos o indicando su ruta física):

A continuación te detallo la ubicación de mis credenciales de acceso: @[Sustituya o seleccione aquí la ruta de tu archivo JSON]. Emplea este documento y sus datos para configurar la vinculación y autenticación OAuth exigida por el conector mcp-gsc.

Durante la ejecución, el asistente abrirá una ventana de autorización de Google en tu navegador. Inicia sesión, concede permisos, y copia el código resultante de vuelta en la consola del agente para completar la autenticación.

El servidor de Search Console se integra en el archivo global declarando la ruta al ejecutable de Python del entorno virtual y la variable de entorno que apunta al secreto OAuth:

"google-search-console": {
  "command": "%USERPROFILE%\\<RUTA_A_TU_WORKSPACE>\\mcp-gsc\\.venv\\Scripts\\python.exe",
  "args": [
    "-m",
    "mcp_search_console"
  ],
  "env": {
    "GSC_OAUTH_CLIENT_SECRETS_FILE": "%USERPROFILE%\\<RUTA_A_TU_WORKSPACE>\\config\\gsc_client_secrets.json"
  }
}

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).

1. Abre tu Google Cloud Console bajo la cuenta correcta que tiene acceso a tus propiedades de Analytics.
2. Asegúrate de tener seleccionado tu proyecto de GCP actual.
3. Habilita de forma obligatoria las dos APIs de Analytics a través de estos enlaces directos:
   • 👉 Habilitar Google Analytics Admin API
   • 👉 Habilitar Google Analytics Data API
4. 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_denied de Google.
5. 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.py

Esto 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>"
  }
}