Errores al configurar el MCP de Search Console
Soluciones a los errores de los servidores MCP de Search Console: API no activada, permiso 403, sc-domain, acceso bloqueado, invalid_grant, spawn uvx ENOENT.
Por Denis Veisllari
La mayoría de los errores de los MCP de Google Search Console vienen de cinco sitios: el proyecto de Google Cloud, la propiedad de Search Console, la pantalla de consentimiento de OAuth, el archivo de credenciales y la configuración del cliente de IA. Busca abajo tu mensaje de error, corrige ese paso y reinicia el cliente. Si prefieres saltarte Google Cloud por completo, la última sección explica la opción que solo necesita iniciar sesión con Google.
Google no ha publicado un servidor MCP oficial de Search Console. Su repositorio de MCP cubre Google Analytics, BigQuery, Maps y otros productos, pero no Search Console, así que todos los servidores de Search Console que puedes instalar son proyectos de la comunidad. Los dos más usados son mcp-gsc (se instala como mcp-search-console) y mcp-server-gsc. Los errores de abajo valen para los dos y para la mayoría de los demás.
Consulta rápida
| Lo que ves | Causa probable | Ir a |
|---|---|---|
| "has not been used in project ... before or it is disabled" | La API de Search Console está desactivada en ese proyecto de Cloud | API no activada |
| 403 "User does not have sufficient permission for site" | La cuenta de servicio no está añadida a la propiedad, o la URL es incorrecta | Errores de permisos |
| "is not a verified Search Console site in this account" | Confusión entre propiedad de dominio y de prefijo de URL | Formato de propiedad incorrecto |
| "Failed to add user: email not found" en Search Console | Fallo de Google con las cuentas de servicio nuevas | Email no encontrado |
| "Access blocked" o "Error 403: access_denied" en la pantalla de Google | App de OAuth en modo Testing y no eres usuario de prueba | Errores en la pantalla de OAuth |
invalid_grant más o menos una semana después de que funcionara | Los tokens de actualización en modo Testing caducan a los 7 días | Funciona y luego deja de funcionar |
| "Error 400: redirect_uri_mismatch" | Se usó un cliente web donde hace falta un cliente de escritorio | Errores en la pantalla de OAuth |
| "Service account credentials file not found" | Ruta relativa o paquete equivocado | Archivo de credenciales |
spawn uvx ENOENT o spawn npx ENOENT | El cliente no encuentra el comando | Errores del cliente |
| No aparece ninguna herramienta y no se escribe ningún log | Python anterior a la 3.11 | Errores del cliente |
| Las cifras no coinciden con el panel de Search Console | Retraso de datos, límites de filas, consultas anonimizadas | Las cifras no coinciden |
La API no está activada
El error es un 403 que dice que la Google Search Console API "has not been used in project" seguido de un número de proyecto, a menudo con un enlace para activarla.
La API tiene que estar activada en el mismo proyecto de Cloud al que pertenece tu cliente OAuth o tu cuenta de servicio. El fallo habitual es activarla en otro proyecto.
- Compara el número de proyecto del error con el proyecto de tu JSON de credenciales.
- En Google Cloud, abre APIs & Services > Library en ese proyecto y activa Google Search Console API.
- Espera unos minutos y vuelve a probar. Google indica que los cambios de configuración pueden tardar un poco en llegar a sus sistemas.
Errores de permisos
El error es un 403 "User does not have sufficient permission for site". En la inspección de URLs aparece en su lugar "The caller does not have permission".
Crear una cuenta de servicio no le da ningún acceso a Search Console. Su email tiene que añadirse a la propiedad exacta que consultas.
- Abre la clave JSON de la cuenta de servicio y copia el valor de
client_email. - En Search Console, abre Settings > Users and permissions > Add user, pega el email y dale permiso completo (Full).
- Si inicias sesión con OAuth, usa una cuenta de Google que ya vea la propiedad en Search Console.
Si la cuenta tiene acceso y sigues recibiendo un 403, lo más probable es que la cadena de la propiedad esté mal. Lee la siguiente sección.
El formato de la propiedad es incorrecto
El error es "'sc-domain:example.com' is not a verified Search Console site in this account", o el mismo 403 de antes.
Search Console tiene dos tipos de propiedad, y la API quiere la cadena exacta de la que tienes:
- Propiedad de dominio:
sc-domain:example.com - Propiedad de prefijo de URL: la URL completa con protocolo y barra final, como
https://www.example.com/
http y https son propiedades distintas, y también lo son www y el dominio sin www. No lo adivines. Pide al agente que ejecute la herramienta del servidor que lista los sitios y copia la URL del sitio exactamente como aparece.
Search Console dice que no encuentra el email de la cuenta de servicio
Cuando añades la cuenta de servicio como usuario, Search Console responde "Failed to add user: email not found."
Es un problema de Google con las cuentas de servicio recién creadas, no algo que hayas hecho mal. Se informó por primera vez hacia abril de 2026, volvió en septiembre de 2026 y también afecta a Google Analytics. Google lo ha reconocido, pero no ha dado fecha de solución. Los usuarios cuentan tres formas de sortearlo:
- Esperar entre unas horas y un día y volver a añadir el usuario.
- Añadir el usuario a través de la API en lugar de la pantalla de Search Console.
- Usar OAuth en lugar de una cuenta de servicio, si tu servidor lo admite.
Errores en la pantalla de OAuth
"Access blocked" con "Error 403: access_denied". Tu pantalla de consentimiento está en modo Testing y la cuenta de Google con la que iniciaste sesión no es usuario de prueba. En Google Cloud, abre Google Auth Platform > Audience > Test users y añade tu propia dirección.
"Google hasn't verified this app". Aparece cuando una app sin verificar pide acceso a Search Console. Si creaste tú el proyecto de Cloud y solo lo usas tú, puedes continuar pese al aviso. La verificación solo importa si le das la app a otras personas.
"Error 400: redirect_uri_mismatch". Creaste un cliente OAuth de tipo "Web application", pero los servidores locales inician sesión a través de una dirección de loopback como http://localhost con un puerto aleatorio. Crea un cliente OAuth nuevo de tipo Desktop app, descarga su JSON y apunta el servidor a él. En mcp-gsc es el ajuste GSC_OAUTH_CLIENT_SECRETS_FILE.
Funcionaba y dejó de funcionar a la semana
El error es invalid_grant, normalmente "Token has been expired or revoked."
Google caduca los tokens de actualización a los 7 días cuando la pantalla de consentimiento de una app externa sigue en modo Testing. Los tokens también dejan de valer si revocas el acceso o si pasan seis meses sin usarse.
- En Google Cloud, cambia el estado de publicación de la pantalla de consentimiento a In production. Para uso personal puede quedarse sin verificar.
- Borra el archivo de token que guardó el servidor.
- Vuelve a iniciar sesión.
Si usas mcp-gsc, actualízalo también. Las versiones anteriores a la 0.4.2 podían fallar al renovar tokens de solo lectura y borrar el archivo de token.
No encuentra el archivo de credenciales
El error es "Service account credentials file not found."
- Ruta relativa. Herramientas como uvx ejecutan el servidor desde una carpeta de caché, así que una ruta como
./key.jsonno apunta a ningún sitio. Usa la ruta completa en la configuración del cliente. En Windows, duplica las barras invertidas:C:\\Users\\you\\key.json. - Paquete equivocado. Para mcp-gsc, instala
mcp-search-console, no el paquetemcp-gscde PyPI, que no tiene nada que ver. Ejecútalo comouvx mcp-search-console@latestpara tener la versión actual. - Archivo equivocado en el ajuste equivocado. Una clave de cuenta de servicio contiene
"type": "service_account"y unclient_email. Un archivo de cliente OAuth empieza con una claveinstalledoweb. Cada uno va en su propio ajuste: mcp-gsc usaGSC_CREDENTIALS_PATHpara el primero yGSC_OAUTH_CLIENT_SECRETS_FILEpara el segundo, y mcp-server-gsc usaGOOGLE_APPLICATION_CREDENTIALS.
El cliente no puede iniciar el servidor
spawn uvx ENOENT o spawn npx ENOENT. Las aplicaciones de escritorio no cargan el PATH de tu terminal, así que no encuentran el comando. Pon la ruta completa en "command". La obtienes con which uvx en macOS o Linux, o con where uvx en Windows. Para npx en Windows, usa "command": "cmd" con los argumentos ["/c", "npx", "-y", ...].
Ni herramientas ni archivo de log. mcp-gsc necesita Python 3.11 o posterior y falla sin avisar en versiones más antiguas. Ejecútalo con uvx, que elige un Python adecuado por ti, o instala Python 3.12.
Los cambios de configuración no hacen nada. Revisa el JSON en busca de comas finales y barras invertidas sin escapar, y luego cierra la aplicación por completo y vuelve a abrirla. En un Mac no basta con cerrar la ventana; usa Cmd+Q.
Dónde están los logs:
- Claude Desktop en macOS:
~/Library/Logs/Claude.mcp.logrecoge los fallos de conexión, ymcp-server-<name>.loglos errores propios de ese servidor. - Claude Desktop en Windows:
%APPDATA%\Claude\logs. - Claude Code: ejecuta
claude mcp get <name>para ver el error, o/mcpdentro de una sesión. - Cursor: abre el panel Output y elige MCP Logs.
Un límite más: los servidores locales solo funcionan en aplicaciones de escritorio y de terminal. No funcionan en claude.ai desde el navegador ni en ChatGPT, que necesitan un servidor remoto.
Las cifras no coinciden con el panel
No son errores, pero explican la mayoría de los casos de "el agente se ha equivocado".
- Retraso. Los datos de Search Console suelen llegar con dos o tres días de retraso, y los días más recientes todavía pueden cambiar. Algunos servidores piden solo datos definitivos, así que sus últimos días aparecen vacíos.
- Límites de filas. Una petición a la API devuelve como máximo 25.000 filas, y Google expone como máximo 50.000 filas al día por tipo de búsqueda. En un sitio grande se cortan las consultas de cola larga.
- Consultas que faltan. Las consultas raras y personales se dejan fuera, así que las filas de consultas nunca suman el total de clics. Para totales exactos, pide los datos sin la dimensión de consulta ni la de página.
- Totales distintos. El gráfico suma por propiedad y la tabla por página, así que los dos pueden no coincidir. Revisa también el rango de fechas; los datos por hora usan la hora del Pacífico.
- Cuotas. La inspección de URLs permite 2.000 comprobaciones al día por sitio, así que las inspecciones por lotes en un sitio grande se paran a medias. Search Analytics permite 1.200 consultas por minuto por sitio.
Sáltate Google Cloud por completo
Todos los errores anteriores, salvo los de la última sección, vienen de gestionar tu propio proyecto de Google Cloud. El MCP de Google Search Console de zaDojo ya está alojado: conectas Search Console en un proyecto de zaDojo con un inicio de sesión normal de Google, y tu agente lo lee en https://app.zadojo.com/mcp. No hay proyecto de Cloud, API que activar, cuenta de servicio, pantalla de consentimiento ni archivo de credenciales, y funciona en claude.ai y ChatGPT además de en los clientes de escritorio.
Las lecturas de Search Console, la inspección de URLs y la cobertura del índice son gratis con el plan gratuito de zaDojo, que no pide tarjeta. También lo son las lecturas de Google Analytics y las auditorías de hasta 50 páginas. Los datos de palabras clave, competidores y visibilidad en IA usan créditos. Para compararlo con las demás opciones gratuitas, consulta servidores MCP de SEO gratuitos.
Preguntas frecuentes
¿Existe un servidor MCP oficial de Google Search Console? No. Google publica servidores MCP para Google Analytics y otros productos, pero no para Search Console. Todos los servidores de Search Console son proyectos de la comunidad o servicios alojados.
¿Uso una cuenta de servicio u OAuth? Una cuenta de servicio va bien para un servidor que funciona sin supervisión, pero tienes que añadir su email a cada propiedad. OAuth usa tu propia cuenta de Google y ve todas las propiedades que ya tienes, pero en modo Testing tienes que volver a iniciar sesión cada 7 días hasta que lo pases a In production.
¿Por qué mi agente solo ve algunos de mis sitios? La cuenta o la cuenta de servicio que usa solo ve las propiedades a las que se añadió. Pide al agente que liste los sitios y compara esa lista con Search Console.
¿Puede un servidor MCP de Search Console cambiar mi sitio? No. Estos servidores leen y gestionan datos de Search Console. Ninguno edita tus páginas.