Google Search Console

1. En Google Cloud Console, ve a APIs y servicios → Credenciales → Crear credenciales → Cuenta de servicio. Ponle un nombre y finaliza la creación; puedes omitir los pasos opcionales de roles/accesos.
2. Abre la cuenta de servicio, luego Claves → Agregar clave → Crear clave nueva → JSON para descargar una clave.
3. En Search Console, abre la Configuración → Usuarios y permisos → Agregar usuario de cada propiedad. Agrega el correo de la cuenta de servicio con acceso Restringido.

[!CAUTION] Guarda la clave fuera de tu repositorio y nunca la subas. Usa su ruta absoluta en la configuración de tu cliente a continuación.

Si Search Console rechaza el correo con "No se pudo agregar el usuario: correo no encontrado", inicia sesión como tú mismo; consulta solución de problemas.

El servidor verifica GOOGLE_APPLICATION_CREDENTIALS antes de la ADC local. Si cambias a ADC, elimina una configuración antigua de ruta de clave de tu configuración de cliente y del entorno.

git clone https://github.com/sarahpark/google-search-console-mcp.git
cd google-search-console-mcp
npm install
npm run build

En los comandos del cliente a continuación, reemplaza npx -y @sarahpark/google-search-console-mcp@1.1.0 con node "/absolute/path/to/google-search-console-mcp/build/index.js". En Claude Desktop, establece command a node y args a un arreglo que contenga esa ruta absoluta. Ejecuta npm test para verificaciones de autenticación sin conexión.

Después de completar la autenticación, pega esto en tu agente:

Agrega npx -y @sarahpark/google-search-console-mcp@1.1.0 como gsc en la configuración MCP a nivel de usuario de este cliente, conservando los servidores existentes. Usa mis Credenciales predeterminadas de la aplicación locales. Dime cuando la configuración esté completa y si necesito reiniciar el cliente.

Para una cuenta de servicio, reemplaza "Usa mis Credenciales predeterminadas de la aplicación locales" con "Establece GOOGLE_APPLICATION_CREDENTIALS a /path/to/service-account-key.json" y usa tu ubicación real del archivo.

Una vez configurado, salta al paso 5.

Inicia sesión como tú mismo (ADC):

codex mcp add gsc -- npx -y @sarahpark/google-search-console-mcp@1.1.0

Paquete npm con una cuenta de servicio:

codex mcp add gsc \
  --env "GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/service-account-key.json" \
  -- npx -y @sarahpark/google-search-console-mcp@1.1.0

Para configuración manual en ~/.codex/config.toml, consulta la documentación de MCP de Codex.

Inicia sesión como tú mismo (ADC):

claude mcp add gsc --scope user -- npx -y @sarahpark/google-search-console-mcp@1.1.0

Paquete npm con una cuenta de servicio:

claude mcp add gsc --scope user \
  --env "GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/service-account-key.json" \
  -- npx -y @sarahpark/google-search-console-mcp@1.1.0

--scope user hace que el servidor esté disponible en todos tus proyectos. Usa --scope project para compartir la configuración a través del .mcp.json del proyecto en su lugar.

Agrega la entrada apropiada a claude_desktop_config.json, fusionándola en cualquier objeto mcpServers existente.

Inicia sesión como tú mismo (ADC):

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "@sarahpark/google-search-console-mcp@1.1.0"]
    }
  }
}

Paquete npm con una cuenta de servicio:

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "@sarahpark/google-search-console-mcp@1.1.0"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account-key.json"
      }
    }
  }
}

Lista todos los sitios (propiedades) a los que tienes acceso en Google Search Console.

No se requieren parámetros.

Consulta datos de análisis de búsqueda: clics, impresiones, CTR y posición.

Verifica el estado de indexación, la información de rastreo y la usabilidad móvil de una URL.

Lista todos los sitemaps enviados y su estado para un sitio.

Si el error dice que la API "requiere un proyecto de cuota", vuelve a ejecutar:

gcloud auth application-default set-quota-project YOUR_PROJECT_ID

Tu cuenta necesita serviceusage.services.use en ese proyecto. Si se deniega el permiso, pide a un administrador del proyecto que lo otorgue o usa un proyecto donde lo tengas, con la API de Search Console habilitada.

Los intentos de inicio de sesión adjuntan tu proyecto configurado automáticamente, pero pueden omitirlo cuando no tienes permiso. Establecerlo explícitamente hace visible ese fallo. El alcance cloud-platform en el comando de configuración permite adjuntar el proyecto de cuota.

Se confirmó que el cliente gcloud integrado otorga webmasters.readonly con Google Cloud SDK 557.0.0. Si no funciona en tu versión, sigue la guía de gcloud para alcances adicionales para crear tu propio cliente OAuth, luego inicia sesión con su archivo de cliente descargado:

gcloud auth application-default login \
  --client-id-file=client_id.json \
  --scopes=https://www.googleapis.com/auth/webmasters.readonly,https://www.googleapis.com/auth/cloud-platform
gcloud auth application-default set-quota-project YOUR_PROJECT_ID

Mantén los archivos de credenciales fuera de tu repositorio.

Esto se ha reportado al agregar cuentas de servicio recién creadas y motivó la opción de ADC. Inicia sesión como tú mismo o usa una cuenta de servicio existente que ya tenga acceso a la propiedad.

• Usando npm 1.0.1 o anterior: actualiza el comando de tu cliente a la versión 1.1.0 o posterior para usar la ADC local de gcloud.
• Usando ADC: asegúrate de que una configuración antigua de GOOGLE_APPLICATION_CREDENTIALS no esté anulando tu inicio de sesión. La cuenta de Google con la que iniciaste sesión debe tener acceso a la propiedad.
• Usando una cuenta de servicio: establece GOOGLE_APPLICATION_CREDENTIALS a la ruta absoluta de la clave y confirma que su correo se agregó a cada propiedad que quieras leer.