Erreurs de configuration du MCP Search Console

Solutions aux erreurs des serveurs MCP Search Console communautaires : API non activée, 403, sc-domain, accès bloqué, invalid_grant, spawn uvx ENOENT.

Par Denis Veisllari

La plupart des erreurs d'un MCP Google Search Console viennent de cinq endroits : le projet Google Cloud, la propriété Search Console, l'écran de consentement OAuth, le fichier d'identifiants et la configuration du client IA. Trouvez votre message d'erreur ci-dessous, corrigez cette étape et redémarrez le client. Si vous préférez éviter Google Cloud entièrement, la dernière section présente la solution qui ne demande qu'une connexion Google.

Google n'a pas publié de serveur MCP Search Console officiel. Son dépôt MCP couvre Google Analytics, BigQuery, Maps et d'autres produits, mais pas Search Console, donc chaque serveur Search Console que vous pouvez installer est un projet communautaire. Les deux plus utilisés sont mcp-gsc (installé sous le nom mcp-search-console) et mcp-server-gsc. Les erreurs ci-dessous s'appliquent aux deux, et à la plupart des autres.

Recherche rapide

Ce que vous voyezCause probableAller à
"has not been used in project ... before or it is disabled"L'API Search Console est désactivée dans ce projet CloudAPI non activée
403 "User does not have sufficient permission for site"Compte de service non ajouté à la propriété, ou mauvaise URLErreurs d'autorisation
"is not a verified Search Console site in this account"Confusion entre propriété de domaine et préfixe d'URLMauvais format de propriété
"Failed to add user: email not found" dans Search ConsoleBug Google avec les nouveaux comptes de serviceE-mail introuvable
"Access blocked" ou "Error 403: access_denied" sur l'écran GoogleApplication OAuth en mode Test, et vous n'êtes pas utilisateur testErreurs de l'écran OAuth
invalid_grant environ une semaine après que cela a fonctionnéLes jetons d'actualisation en mode Test expirent après 7 joursÇa marche, puis ça s'arrête
"Error 400: redirect_uri_mismatch"Client Web utilisé là où il faut un client DesktopErreurs de l'écran OAuth
"Service account credentials file not found"Chemin relatif, ou mauvais paquetFichier d'identifiants
spawn uvx ENOENT ou spawn npx ENOENTLe client ne trouve pas la commandeErreurs du client
Aucun outil n'apparaît et aucun journal n'est écritPython antérieur à 3.11Erreurs du client
Les chiffres ne correspondent pas au tableau de bord Search ConsoleDélai des données, limites de lignes, requêtes anonymiséesChiffres différents

L'API n'est pas activée

L'erreur est un 403 indiquant que l'API Google Search Console "has not been used in project" (n'a jamais été utilisée dans le projet), suivi d'un numéro de projet, souvent avec un lien pour l'activer.

L'API doit être activée dans le même projet Cloud que celui qui possède votre client OAuth ou votre compte de service. L'erreur habituelle est de l'activer dans un autre projet.

  1. Comparez le numéro de projet de l'erreur avec le projet de votre fichier JSON d'identifiants.
  2. Dans Google Cloud, ouvrez APIs & Services > Library dans ce projet et activez Google Search Console API.
  3. Attendez quelques minutes et réessayez. Google précise que les nouveaux réglages peuvent mettre un moment à atteindre ses systèmes.

Erreurs d'autorisation

L'erreur est un 403 "User does not have sufficient permission for site". L'inspection d'URL affiche plutôt "The caller does not have permission".

Créer un compte de service ne lui donne aucun accès à Search Console. Son adresse e-mail doit être ajoutée à la propriété exacte que vous interrogez.

  1. Ouvrez la clé JSON du compte de service et copiez la valeur client_email.
  2. Dans Search Console, ouvrez Paramètres > Utilisateurs et autorisations > Ajouter un utilisateur, collez l'adresse et donnez-lui l'autorisation Totale.
  3. Si vous vous connectez plutôt avec OAuth, utilisez un compte Google qui voit déjà la propriété dans Search Console.

Si le compte a accès et que vous obtenez toujours un 403, la chaîne de propriété est probablement fausse. Lisez la section suivante.

Le format de la propriété est faux

L'erreur est "'sc-domain:example.com' is not a verified Search Console site in this account", ou le même 403 que ci-dessus.

Search Console a deux types de propriété, et l'API veut la chaîne exacte de celle que vous avez :

  • Propriété de domaine : sc-domain:example.com
  • Propriété avec préfixe d'URL : l'URL complète avec protocole et barre oblique finale, par exemple https://www.example.com/

http et https sont des propriétés différentes, tout comme www et le domaine nu. Ne devinez pas. Demandez à l'agent de lancer l'outil de liste des sites du serveur et copiez l'URL du site exactement telle qu'elle est renvoyée.

Search Console dit que l'e-mail du compte de service est introuvable

Quand vous ajoutez le compte de service comme utilisateur, Search Console répond "Failed to add user: email not found".

C'est un problème de Google avec les comptes de service récemment créés, pas une erreur de votre part. Il a été signalé pour la première fois vers avril 2026, est revenu en septembre 2026 et touche aussi Google Analytics. Google l'a reconnu mais n'a pas donné de date de correction. Les utilisateurs signalent trois solutions de contournement :

  • Attendre de quelques heures à une journée et ajouter l'utilisateur à nouveau.
  • Ajouter l'utilisateur via l'API plutôt que via l'écran de Search Console.
  • Utiliser OAuth plutôt qu'un compte de service, si votre serveur le permet.

Erreurs de l'écran OAuth

"Access blocked" avec "Error 403: access_denied". Votre écran de consentement est en mode Test et le compte Google avec lequel vous vous êtes connecté n'est pas utilisateur test. Dans Google Cloud, ouvrez Google Auth Platform > Audience > Test users et ajoutez votre propre adresse.

"Google hasn't verified this app". Ce message s'affiche quand une application non validée demande l'accès à Search Console. Si vous avez créé le projet Cloud vous-même et que vous êtes seul à l'utiliser, vous pouvez passer l'avertissement. La validation ne compte que si vous confiez l'application à d'autres personnes.

"Error 400: redirect_uri_mismatch". Vous avez créé un client OAuth de type "Web application", alors que les serveurs locaux se connectent via une adresse de bouclage comme http://localhost avec un port aléatoire. Créez un nouveau client OAuth de type Desktop app, téléchargez son JSON et indiquez-le au serveur. Pour mcp-gsc, c'est le réglage GSC_OAUTH_CLIENT_SECRETS_FILE.

Ça a marché, puis ça s'est arrêté une semaine plus tard

L'erreur est invalid_grant, en général "Token has been expired or revoked".

Google fait expirer les jetons d'actualisation après 7 jours quand l'écran de consentement d'une application externe est encore en mode Test. Les jetons cessent aussi de fonctionner si vous révoquez l'accès ou les laissez inutilisés pendant six mois.

  1. Dans Google Cloud, passez le statut de publication de l'écran de consentement à In production. Pour un usage personnel, il peut rester non validé.
  2. Supprimez le fichier de jeton enregistré par le serveur.
  3. Reconnectez-vous.

Si vous utilisez mcp-gsc, mettez-le aussi à jour. Les versions antérieures à 0.4.2 pouvaient échouer à actualiser les jetons en lecture seule et supprimer le fichier de jeton.

Le fichier d'identifiants est introuvable

L'erreur est "Service account credentials file not found".

  • Chemin relatif. Des outils comme uvx lancent le serveur depuis un dossier de cache, donc un chemin comme ./key.json ne mène nulle part. Utilisez le chemin complet dans la configuration du client. Sous Windows, doublez les barres obliques inverses : C:\\Users\\you\\key.json.
  • Mauvais paquet. Pour mcp-gsc, installez mcp-search-console, pas le paquet mcp-gsc sans rapport sur PyPI. Lancez-le avec uvx mcp-search-console@latest pour obtenir la version actuelle.
  • Mauvais fichier dans le mauvais réglage. Une clé de compte de service contient "type": "service_account" et un client_email. Un fichier de client OAuth commence par une clé installed ou web. Chacun va dans son propre réglage ; mcp-gsc utilise GSC_CREDENTIALS_PATH pour le premier et GSC_OAUTH_CLIENT_SECRETS_FILE pour le second, et mcp-server-gsc utilise GOOGLE_APPLICATION_CREDENTIALS.

Le client ne parvient pas à lancer le serveur

spawn uvx ENOENT ou spawn npx ENOENT. Les applications de bureau ne chargent pas le PATH de votre terminal, donc elles ne trouvent pas la commande. Mettez le chemin complet dans "command". Obtenez-le avec which uvx sous macOS ou Linux, ou where uvx sous Windows. Pour npx sous Windows, utilisez "command": "cmd" avec les arguments ["/c", "npx", "-y", ...].

Aucun outil, aucun fichier journal. mcp-gsc demande Python 3.11 ou plus récent et échoue sans rien dire sur les versions plus anciennes. Lancez-le via uvx, qui choisit un Python adapté pour vous, ou installez Python 3.12.

Les changements de configuration ne font rien. Vérifiez qu'il n'y a pas de virgules finales ni de barres obliques inverses non échappées dans le JSON, puis quittez complètement l'application et rouvrez-la. Sur Mac, fermer la fenêtre ne suffit pas ; utilisez Cmd+Q.

Où se trouvent les journaux :

  • Claude Desktop sous macOS : ~/Library/Logs/Claude. mcp.log contient les échecs de connexion, et mcp-server-<name>.log les erreurs propres à ce serveur.
  • Claude Desktop sous Windows : %APPDATA%\Claude\logs.
  • Claude Code : lancez claude mcp get <name> pour voir l'erreur, ou /mcp dans une session.
  • Cursor : ouvrez le panneau Output et choisissez MCP Logs.

Une limite de plus : les serveurs locaux ne tournent que dans les applications de bureau et de terminal. Ils ne fonctionnent pas sur claude.ai dans le navigateur ni dans ChatGPT, qui demandent un serveur distant.

Les chiffres ne correspondent pas au tableau de bord

Ce ne sont pas des erreurs, mais elles sont à l'origine de la plupart des signalements du type « l'agent s'est trompé ».

  • Délai. Les données Search Console arrivent en général après deux à trois jours, et les jours les plus récents peuvent encore changer. Certains serveurs ne demandent que les données définitives, donc leurs derniers jours paraissent vides.
  • Limites de lignes. Une requête API renvoie au maximum 25 000 lignes, et Google expose au maximum 50 000 lignes par jour et par type de recherche. Les requêtes de longue traîne d'un grand site sont coupées.
  • Requêtes manquantes. Les requêtes rares et personnelles sont exclues, donc les lignes de requêtes n'atteignent jamais le total des clics. Pour des totaux exacts, demandez des données sans la dimension requête ou page.
  • Totaux différents. Le graphique totalise par propriété et le tableau par page, donc les deux peuvent différer. Vérifiez aussi la période ; les données horaires utilisent l'heure du Pacifique.
  • Quotas. L'inspection d'URL autorise 2 000 vérifications par jour et par site, donc les inspections groupées sur un grand site s'arrêtent en cours de route. Search Analytics autorise 1 200 requêtes par minute et par site.

Se passer complètement de Google Cloud

Toutes les erreurs ci-dessus, sauf la dernière section, viennent du fait de gérer votre propre projet Google Cloud. Le MCP Google Search Console de zaDojo est hébergé pour vous : vous connectez Search Console dans un projet zaDojo avec une connexion Google normale, et votre agent le lit à l'adresse https://app.zadojo.com/mcp. Pas de projet Cloud, d'API à activer, de compte de service, d'écran de consentement ni de fichier d'identifiants, et cela fonctionne dans claude.ai et ChatGPT comme dans les clients de bureau.

Les lectures Search Console, l'inspection d'URL et la couverture de l'index sont gratuites avec l'offre Free de zaDojo, sans carte bancaire. Les lectures Google Analytics et les audits de site jusqu'à 50 pages le sont aussi. Les données de mots-clés, de concurrents et de visibilité IA consomment des crédits. Pour comparer avec les autres options gratuites, voir serveurs MCP SEO gratuits.

Questions fréquentes

Existe-t-il un serveur MCP Google Search Console officiel ? Non. Google publie des serveurs MCP pour Google Analytics et d'autres produits, mais pas pour Search Console. Chaque serveur Search Console est un projet communautaire ou un service hébergé.

Faut-il utiliser un compte de service ou OAuth ? Un compte de service convient à un serveur qui tourne sans surveillance, mais vous devez ajouter son adresse à chaque propriété. OAuth utilise votre propre compte Google et voit toutes les propriétés auxquelles vous avez déjà accès, mais en mode Test vous devez vous reconnecter tous les 7 jours tant que vous ne le passez pas en production.

Pourquoi mon agent ne voit-il qu'une partie de mes sites ? Le compte ou le compte de service qu'il utilise ne voit que les propriétés auxquelles il a été ajouté. Demandez à l'agent de lister les sites et comparez cette liste avec Search Console.

Un serveur MCP Search Console peut-il modifier mon site ? Non. Ces serveurs lisent et gèrent les données Search Console. Aucun ne modifie vos pages.