Join Médicis
Serveurs MCP

MCP Google Search Console

Pose tes questions SEO en langage courant et ton IA va chercher la réponse dans Google Search Console : requêtes, clics, positions, indexation des pages et sitemaps.

  • Communautaire
  • Gratuit (serveur open source, API Search Console sans frais)
  • Lecture et écriture
  • Installation : Avancé
  • 30 min
InstallerDocumentation du serveur ↗GitHub ↗

✓ Fiche vérifiée par Join Médicis le 13 octobre 2026, d'après la documentation et le code du serveur.

Comment ça marche

Un MCP est un pont entre ton IA et un outil. Ici, en trois temps :

  1. I

    Tu poses ta question : « Quelles requêtes m'apportent le plus de clics ce mois-ci ? »

  2. II

    Ton IA appelle le serveur MCP, qui interroge l'API Search Console avec ton compte Google.

  3. III

    Elle reçoit les chiffres et te répond en clair, avec les pistes d'optimisation.

Ce que tu peux lui demander

Copie une de ces demandes dans ta conversation une fois le MCP installé.

  • « Liste mes propriétés Search Console. »

    Le bon premier test : vérifie que la connexion marche.

  • « Donne-moi le top 20 de mes requêtes sur les 28 derniers jours pour mon-site.fr, et signale celles dont le CTR est sous 2 %. »

    Repère les titres et descriptions à retravailler.

  • « Quelles requêtes sont en position 11 à 20 avec beaucoup d'impressions ? Classe-les par potentiel. »

    Tes gains rapides : la page 2 de Google.

  • « Compare mes performances de septembre et d'août : quelles requêtes ont le plus progressé ou reculé ? »

    Ton bilan mensuel en une question.

  • « Sur quelles requêtes plusieurs de mes pages se font-elles concurrence ? »

    Détecte la cannibalisation de mots-clés.

  • « Inspecte ces pages et dis-moi lesquelles ne sont pas indexées, et pourquoi : mon-site.fr/offre, mon-site.fr/blog/guide »

    Le diagnostic d'indexation, page par page.

  • « Mes sitemaps ont-ils des erreurs ou des avertissements ? »

    Un contrôle technique en 10 secondes.

Indique l'adresse du site telle qu'elle apparaît dans Search Console (avec https:// ou en « sc-domain:mon-site.fr » pour une propriété de domaine). En cas de doute, demande d'abord la liste de tes propriétés.

Avant de commencer

Google ne publie pas de serveur MCP pour Search Console : ce guide utilise le serveur communautaire le plus complet, open source (licence MIT). Il faut un projet Google Cloud, un identifiant OAuth et l'outil uv. Compte 20 à 30 minutes la première fois.

  • Un accès à une propriété Search Console

    Avec le compte Google que tu utiliseras pour te connecter.

  • Un projet Google Cloud avec l'API Search Console activée

    Console Google Cloud → Bibliothèque d'API → Google Search Console API → Activer.

  • Un identifiant OAuth de type application de bureau

    Téléchargé en fichier JSON (client_secrets.json). Pas besoin de l'outil gcloud : la connexion se fait dans ton navigateur au premier lancement.

  • L'outil uv

    Il télécharge et lance le serveur tout seul, avec la bonne version de Python. Voir docs.astral.sh/uv pour l'installer.

Installer, selon ton interface

Étape 0, commune à toutes les interfacesPréparer ton accès Google (une seule fois)

Cette étape est commune à toutes les interfaces. Elle crée le fichier qui permet au serveur de se connecter à ton compte Google.

  1. 1

    Dans la console Google Cloud, crée un projet (ou choisis-en un) et active la Google Search Console API.

  2. 2

    Configure l'écran de consentement OAuth : type « Externe », laisse l'application en mode test et ajoute ton adresse Gmail dans les utilisateurs test.

  3. 3

    Crée un identifiant OAuth de type « Application de bureau », télécharge le fichier JSON et range-le dans un dossier permanent (par exemple Documents).

  4. 4

    Installe uv, puis repère le chemin complet de uvx (à coller dans la configuration) :

    # Mac / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
which uvx

# Windows (PowerShell)
Get-Command uvx | Select-Object -ExpandProperty Source

Tu utilises quoi ?

Installer sur Claude Desktop

Sur ton ordinateur
  1. 1

    Termine la préparation ci-dessus.

  2. 2

    Dans l'application Claude Desktop : Réglages → Développeur → Modifier la configuration.

  3. 3

    Colle ce bloc (remplace le chemin de uvx et celui du fichier JSON par des chemins complets), puis enregistre :

    {
  "mcpServers": {
    "gscServer": {
      "command": "/CHEMIN/COMPLET/VERS/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/chemin/complet/vers/client_secrets.json"
      }
    }
  }
}
  4. 4

    Quitte complètement Claude Desktop (Cmd+Q sur Mac) et relance-le.

  5. 5

    À la première question, une fenêtre Google s'ouvre : connecte-toi. Si Google affiche « Application non validée », clique sur Paramètres avancés puis Accéder : c'est normal, l'application est la tienne.

C'est bon si… Demande : « Liste mes propriétés Search Console ». Si rien ne vient, demande : « Appelle get_capabilities » pour voir l'état de la connexion.

Ce que ton IA peut faire avec

  • Lecture

    Lister tes propriétés

    Retrouve les sites Search Console auxquels tu as accès, avec leur niveau de permission.

  • Lecture

    Analyser tes performances

    Clics, impressions, CTR et position par requête, page, pays ou appareil, sur la période de ton choix, avec filtres et jusqu'à 25 000 lignes.

  • Lecture

    Comparer deux périodes

    Ce qui progresse et ce qui recule entre deux mois, deux trimestres ou avant et après une refonte.

  • Lecture

    Diagnostiquer l'indexation

    Statut d'indexation, dernière exploration, URL canonique retenue par Google et erreurs de résultats enrichis, jusqu'à 10 pages à la fois.

  • Lecture

    Suivre tes sitemaps

    Liste, détails, erreurs et avertissements de tes sitemaps.

  • Écriture

    Soumettre un sitemap

    Envoie ou renvoie un sitemap à Google. Actif par défaut.

  • Écriture

    Ajouter ou supprimer un site ou un sitemap

    Désactivé par défaut : il faut ajouter GSC_ALLOW_DESTRUCTIVE=true à la configuration pour l'autoriser.

Ce qu'il ne fait pas

  • C'est un serveur communautaire : il n'est ni publié ni garanti par Google. Il est maintenu par Amin Foroutan, consultant SEO, et mis à jour régulièrement (version 0.4.1, septembre 2026).
  • Il demande l'accès complet à Search Console (périmètre « webmasters ») et peut soumettre un sitemap. Les suppressions restent désactivées tant que tu ne les autorises pas.
  • L'inspection d'URL se fait par lots de 10 pages au plus, et l'API Search Console limite le nombre d'inspections par jour.
  • Il ne voit que les propriétés auxquelles ton compte Google a déjà accès.

Les outils du serveur

21 outils et ressources, que ton IA découvre et appelle toute seule.

  • Démarrage et compte (5)

    • get_capabilitiesListe les outils disponibles et l'état de la connexion. À appeler en cas de doute.
    • list_propertiesListe les propriétés Search Console accessibles.
    • get_site_detailsDétails d'une propriété : permission, vérification.
    • reauthenticateRelance la connexion Google (pour changer de compte).
    • get_creator_infoPrésente l'auteur du serveur.

  • Performances (5)

    • get_search_analyticsRequêtes ou pages principales avec clics, impressions, CTR et position (jusqu'à 500 lignes).
    • get_performance_overviewSynthèse des performances et tendance jour par jour.
    • get_advanced_search_analyticsAnalyse filtrée par pays, appareil, requête ou page, avec tri et pagination (jusqu'à 25 000 lignes).
    • compare_search_periodsCompare deux périodes, requête par requête.
    • get_search_by_page_queryLes requêtes qui amènent du trafic sur une page donnée.

  • Indexation (3)

    • inspect_url_enhancedInspection détaillée d'une URL : indexation, exploration, canonique, résultats enrichis.
    • batch_url_inspectionInspecte jusqu'à 10 URL d'un coup.
    • check_indexing_issuesRepère les problèmes d'indexation sur une liste d'URL.

  • Sitemaps (5)

    • get_sitemapsListe les sitemaps d'une propriété.
    • list_sitemaps_enhancedSitemaps avec erreurs et avertissements détaillés.
    • get_sitemap_detailsDétails d'un sitemap précis.
    • submit_sitemapSoumet ou renvoie un sitemap à Google.
    • manage_sitemapsTout-en-un : lister, détailler, soumettre (et supprimer si autorisé).

  • Désactivés par défaut (3)

    • add_siteAjoute une propriété à ton compte.
    • delete_siteRetire une propriété de ton compte.
    • delete_sitemapRetire un sitemap de Search Console.

21 outils dans le code (le README n'en détaille que 15). Les trois derniers ne s'activent qu'avec GSC_ALLOW_DESTRUCTIVE=true. Par défaut, les chiffres correspondent à ceux du tableau de bord Search Console (GSC_DATA_STATE=all) ; « final » ne garde que les données consolidées, avec 2 à 3 jours de décalage.

Sécurité et données

  • Le fichier client_secrets.json et le jeton de connexion fonctionnent comme un mot de passe : garde-les hors des dossiers partagés ou synchronisés, et ne les publie jamais.
  • Les données récupérées sont transmises à l'IA que tu connectes (Claude, ChatGPT…) : vérifie ses règles de confidentialité avant d'y brancher des sites clients.
  • Laisse GSC_ALLOW_DESTRUCTIVE désactivé, sauf besoin précis.
  • Le code est open source et lisible sur GitHub. Tu peux révoquer l'accès à tout moment depuis les autorisations de ton compte Google.

Ça ne marche pas ?

« spawn uvx ENOENT » ou le serveur n'apparaît pas

Ton application ne trouve pas uvx. Remplace « uvx » par son chemin complet (commande which uvx sur Mac, Get-Command uvx sous Windows), puis quitte et relance complètement l'application.

« invalid_grant » au bout d'une semaine

En mode test, Google fait expirer la connexion après 7 jours. Demande à ton IA « Appelle reauthenticate », ou passe l'application en production dans l'écran de consentement OAuth.

Aucune propriété n'apparaît

Tu t'es sans doute connecté avec un autre compte Google que celui de Search Console. Demande « Appelle reauthenticate » et choisis le bon compte.

Erreur 404 sur un site pourtant présent

Utilise l'adresse exacte de la propriété : « sc-domain:mon-site.fr » pour une propriété de domaine, ou l'URL complète avec https:// et la barre finale pour une propriété de préfixe.

Fichier d'identifiants introuvable

Indique un chemin complet vers client_secrets.json (pas seulement le nom du fichier), puis relance l'application.

Toujours bloqué ? Tutoriel vidéo d'installation (auteur du serveur) · Signaler un bug (GitHub) · Guide en français pas à pas (Nelly Kempf) · Alternative en lecture seule : mcp-server-gsc

MCP Google Search Console : questions fréquentes

Existe-t-il un MCP officiel de Google pour Search Console ?

Non, pas à ce jour. Le serveur « Developer Knowledge » de Google ne donne accès qu'à sa documentation pour développeurs, pas à tes données. Les serveurs MCP Search Console disponibles sont communautaires ou proposés par des services tiers.

Pourquoi ce serveur plutôt qu'un autre ?

C'est le plus complet : performances, comparaison de périodes, inspection d'URL par lots et sitemaps, avec une connexion par le navigateur sans l'outil gcloud. Il est sous licence MIT, testé et mis à jour régulièrement. Si tu veux un accès strictement en lecture seule, mcp-server-gsc (ahonn) est une alternative, plus limitée.

Est-ce que c'est gratuit ?

Oui. Le serveur est open source et l'API Search Console n'est pas facturée. Tu paies seulement ton abonnement à l'IA que tu utilises. Les versions hébergées proposées par des tiers sont, elles, payantes.

Peut-il modifier mon site ou ma Search Console ?

Il ne touche jamais à ton site. Dans Search Console, il peut soumettre un sitemap ; ajouter ou supprimer une propriété ou un sitemap reste désactivé tant que tu n'ajoutes pas GSC_ALLOW_DESTRUCTIVE=true.

Mes données Search Console sont-elles partagées ?

Elles sont transmises à l'IA que tu connectes, le temps de répondre à ta question. Avec l'installation locale, Join Médicis ne voit rien et aucun service tiers non plus : tout se passe entre ton ordinateur, Google et ton IA.

Une erreur, un lien cassé, un souci de sécurité ? Dis-le-nous, on corrige.