Connecter GSC via MCP

Comment connecter les données Google Search Console via un MCP ?

Pointez n'importe quel assistant compatible MCP vers https://mcp.gscwizard.com/mcp, authentifiez-vous par une connexion ou une clé API, et il lit vos vraies données Search Console. Les analyses s'exécutent côté serveur : l'assistant reçoit donc des réponses finalisées plutôt que des lignes brutes.

Fonctionne avec ChatGPT, Claude, Grok, Gemini CLI, Cursor, VS Code, Windsurf et tout autre client MCP.

La réponse courte

Trois choses suffisent pour vous connecter, quel que soit le client :

  1. Connectez Search Console une seule fois dans GSC Wizard. L'autorisation se trouve là, pas dans l'assistant.
  2. Ajoutez le point de terminaison https://mcp.gscwizard.com/mcp à votre client.
  3. Authentifiez-vous : connectez-vous avec OAuth 2.1 si le client le permet, ou envoyez Authorization: Bearer gscw_live_...

Le serveur parle HTTP en streaming : la plupart des clients n'ont donc besoin d'aucune installation locale, d'aucun processus Node ni d'aucun pont stdio.

Point de terminaison HTTP en streaming

https://mcp.gscwizard.com/mcp

Connexion OAuth 2.1

Pour ChatGPT, l'interface Connecteurs de Claude, les connecteurs Grok et Gemini CLI. Le client s'enregistre lui-même et vous guide dans une connexion Google. Rien à copier ni à stocker.

En-tête avec clé API

Pour les clients à fichier de configuration comme Claude Code, Cursor, VS Code et Windsurf, et pour Meta Muse : envoyez Authorization: Bearer gscw_live_...

Vidéo

La configuration de bout en bout en vidéo

La configuration et une première question, de bout en bout : le connecteur ajouté, la connexion faite, et une analyse finalisée qui revient à la place de lignes brutes.

Mise en place

Trois étapes pour se connecter

Les trois mêmes étapes s'appliquent à chaque client. Seule la syntaxe de configuration change.

  1. 1

    Connectez vos propriétés

    Connectez-vous sur tool.gscwizard.com avec Google et choisissez les propriétés Search Console que vous voulez rendre disponibles. C'est le seul endroit où l'autorisation est accordée.

  2. 2

    Créez une clé API, ou prévoyez de vous connecter

    Créez une clé dans Compte → Clés API pour les clients à fichier de configuration. Les clients qui prennent en charge OAuth à distance (ChatGPT, l'interface Connecteurs de Claude, les connecteurs Grok, Gemini CLI) n'ont besoin que de l'URL.

  3. 3

    Ajoutez le serveur à votre client

    Pointez le client vers https://mcp.gscwizard.com/mcp. Les noms des clés diffèrent selon les clients, mais l'URL et l'en-tête bearer ne changent jamais.

À copier-coller

La configuration pour chaque client

Remplacez gscw_live_... par la clé que vous avez créée dans Compte → Clés API.

Claude Code

Une commande, en-tête avec clé API.

claude mcp add --transport http gsc-wizard \
  https://mcp.gscwizard.com/mcp \
  --header "Authorization: Bearer gscw_live_..."

Claude web et desktop

Paramètres → Connecteurs → Ajouter un connecteur personnalisé. Collez l'URL et laissez vides le client ID et le secret OAuth : Claude s'enregistre lui-même et vous connecte.

https://mcp.gscwizard.com/mcp

ChatGPT

Paramètres → Apps, mode développeur, ajoutez une app avec l'authentification réglée sur OAuth. Nécessite une formule payante. Il n'y a pas de champ pour une clé API : ChatGPT ne peut pas envoyer de jetons bearer statiques. Ou évitez tout cela et installez l'app GSC Wizard depuis l'App Store de ChatGPT.

https://mcp.gscwizard.com/mcp

Grok

Rendez-vous sur grok.com/connectors, cliquez sur New Connector et choisissez Custom. Collez l'URL et terminez la connexion : Grok s'enregistre lui-même via OAuth 2.1, donc il n'y a ni client ID ni secret à renseigner. Grok découvre ensuite les outils et les propose dans vos conversations. Pas-à-pas complet : connecter GSC à Grok.

https://mcp.gscwizard.com/mcp

Microsoft Copilot Studio

Ajoutez à votre agent un outil Model Context Protocol avec OAuth 2.0 et le type de configuration Manual. Créez le client ID et le secret dans Compte → Clés API MCP → Microsoft Copilot Studio, qui liste aussi toutes les URL à coller, puis enregistrez l'URL de redirection que Copilot Studio vous donne sur cette connexion. Pas-à-pas complet : les données SEO dans Microsoft Copilot Studio.

https://mcp.gscwizard.com/mcp

Meta Muse

Muse n'a pas d'écran de paramètres pour les connecteurs personnalisés : demandez-lui dans une conversation de créer une intégration personnalisée vers l'URL ci-dessous, en HTTP distant avec authentification par jeton Bearer. Créez une clé API en lecture seule et collez-la dans l'invite sécurisée d'identifiants de Muse, jamais dans la conversation. Pas-à-pas complets : le connecteur Muse SEO pour Search Console et le connecteur Muse pour Google Analytics.

URL:  https://mcp.gscwizard.com/mcp
Auth: Bearer gscw_live_... (read-only key)

Gemini CLI

À ajouter dans ~/.gemini/settings.json. Gemini CLI utilise httpUrl pour le HTTP en streaming.

{
  "mcpServers": {
    "gsc-wizard": {
      "httpUrl": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer gscw_live_..." }
    }
  }
}

OpenAI Codex

À ajouter dans ~/.codex/config.toml (partagé par la CLI Codex, l'extension d'IDE et l'app) avec la clé dans une variable d'environnement, ou lancez codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcp puis connectez-vous avec codex mcp login gsc-wizard. Guide complet : le MCP GSC pour Codex.

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"

Cursor

À ajouter dans ~/.cursor/mcp.json (global) ou .cursor/mcp.json dans un projet.

{
  "mcpServers": {
    "gsc-wizard": {
      "url": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer gscw_live_..." }
    }
  }
}

VS Code (mode agent de Copilot)

À ajouter dans .vscode/mcp.json. VS Code utilise servers, pas mcpServers, et peut demander la clé à la saisie pour qu'elle reste hors du contrôle de version.

{
  "inputs": [
    { "id": "gscw-key", "type": "promptString", "description": "GSC Wizard MCP key", "password": true }
  ],
  "servers": {
    "gsc-wizard": {
      "type": "http",
      "url": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer ${input:gscw-key}" }
    }
  }
}

Windsurf

À ajouter dans ~/.codeium/windsurf/mcp_config.json. Windsurf utilise serverUrl pour les serveurs distants.

{
  "mcpServers": {
    "gsc-wizard": {
      "serverUrl": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer gscw_live_..." }
    }
  }
}

Tout autre client MCP

Pointez-le vers le point de terminaison HTTP streamable et envoyez votre clé comme jeton bearer. Le nom des clés varie (transport ou type, url ou serverUrl), mais l'URL et l'en-tête restent les mêmes.

URL:    https://mcp.gscwizard.com/mcp
Header: Authorization: Bearer gscw_live_...

Guides pas à pas : ChatGPT, Claude, Gemini, Grok, Meta Muse. ChatGPT a ses propres contraintes (serveurs distants uniquement, OAuth au lieu de clés API, mode développeur réservé aux formules payantes), toutes détaillées dans ChatGPT connectors for Search Console data in 2026. Pour Claude en particulier, la référence du serveur MCP Search Console pour Claude détaille le protocole que cette page résume.

Authentification et périmètres

Chaque clé porte un périmètre choisi à sa création : c'est vous qui décidez de ce que l'assistant peut faire.

Lecture seule

Interroger les données et lancer des rapports. Une clé en lecture ne peut physiquement pas appeler un outil d'écriture : la connexion est donc en lecture seule par construction. C'est le bon choix pour un agent partagé ou un déploiement exposé aux clients.

Lecture et écriture

Tout ce que fait une clé en lecture, plus les modifications : ajouter des sites, soumettre des URL à IndexNow, gérer les clusters thématiques, les groupes de contenu et les annotations. Chaque modification est consignée dans le journal d'audit de votre compte.

Les clés ne sont affichées qu'une fois, à la création. Elles sont révocables à tout moment et n'accèdent qu'aux propriétés Search Console déjà connectées à votre compte GSC Wizard.

Ce qui distingue ce MCP

L'analyse est faite avant que le modèle ne voie les données

La plupart des serveurs MCP SEO renvoient les lignes brutes à l'assistant. Or les modèles de langage ne sont pas faits pour calculer sur de gros tableaux : c'est lent, cela consomme des tokens et les erreurs sont difficiles à repérer.

Beaucoup moins de tokens

Un seul appel d'outil renvoie une réponse compacte et finalisée, au lieu de dizaines de milliers de lignes que le modèle doit lire, garder en contexte et que vous payez.

Beaucoup plus rapide

Les agrégations s'exécutent dans l'entrepôt en quelques millisecondes : un rapport SEO complet sur un jeu de données de 4 GB en environ 4,4 secondes, au lieu de paginer l'API GSC lot par lot.

Peu sujet aux erreurs

Les calculs sont déterministes. Les chiffres viennent de vraies requêtes : le modèle ne risque ni de mal compter ni d'inventer des totaux.

Des jeux de données plus volumineux

Comme le gros du travail n'entre jamais dans la fenêtre de contexte, le serveur peut analyser des mois de données et des millions de lignes qui ne tiendraient jamais dans un prompt.

Ce que l'assistant peut appeler

Le catalogue complet, avec des exemples d'arguments pour chaque outil, est disponible sur mcp.gscwizard.com.

Analyse de la recherche Principales requêtes & pages Évolutions de positions Cannibalisation de mots-clés Détection du déclin de contenu Striking distance / page poaching Analyse de la courbe de CTR Notation des opportunités Inspection d'URL en masse Suivi de l'indexation Soumissions IndexNow Groupes de contenu & clusters thématiques Ventilation par pays & appareil Performances des sitemaps Rapports SEO automatisés Répartition marque vs hors marque Distribution des positions Comparaison de migration Rapports clients partageables Google Analytics 4 Core Web Vitals (CrUX) Prévisions & détection d'anomalies Bing Webmaster Tools

Si la connexion échoue

Les outils n'apparaissent jamais

La plupart des clients ne lisent les paramètres MCP qu'au démarrage. Quittez complètement l'application (pas seulement la fenêtre), puis rouvrez-la après avoir modifié un fichier de configuration.

401 non autorisé

Vérifiez que l'en-tête est exactement Authorization: Bearer gscw_live_..., que la clé n'a pas été révoquée et que le compte a toujours un abonnement ou un essai actif.

Claude Desktop juge la configuration invalide

Son fichier de configuration ne lance que des serveurs stdio locaux : une entrée "type": "http" est donc rejetée. Utilisez l'interface Connecteurs, ou passez par mcp-remote : consultez le guide Claude, ou la référence du MCP Search Console pour Claude pour comprendre pourquoi le fichier de configuration refuse une entrée HTTP.

Un outil d'écriture renvoie 403

La clé est en lecture seule. Créez une clé en lecture et écriture si l'assistant doit vraiment modifier des données, ou gardez la clé en lecture et faites la modification dans l'application.

Une propriété est introuvable

Le MCP ne voit que les propriétés déjà connectées dans GSC Wizard. Ajoutez-la d'abord dans l'application, puis demandez à l'assistant de lister à nouveau les sites. Les propriétés de domaine portent le préfixe sc-domain:.

Mêmes données, autres assistants

Vous connectez un autre outil d'IA ?

Une seule connexion Search Console, tous les assistants. Choisissez votre client et suivez le guide pas à pas.

Voir aussi la présentation du MCP Google Search Console, le MCP GA4, le MCP Yandex Webmaster, le MCP Merchant Center, l'app ChatGPT (à installer dans ChatGPT), les connecteurs Meta Muse pour Search Console et Google Analytics, notre sélection des meilleurs serveurs MCP SEO, et les raisons pour lesquelles GSC Wizard est le meilleur MCP Search Console en 2026.

Questions fréquentes

Qu'est-ce qu'un serveur MCP ?

Un serveur MCP (Model Context Protocol) est un connecteur standard qui permet à un assistant IA de lire des données en direct et d'appeler des outils. Un MCP Google Search Console expose vos propriétés Search Console à l'assistant, qui peut ainsi récupérer les vrais chiffres de clics, d'impressions, de position et de CTR au lieu de les inventer.

Quels clients peuvent se connecter ?

Tout client qui prend en charge les serveurs MCP distants : ChatGPT, Claude et Claude Code, Grok, Gemini CLI, Cursor, VS Code en mode agent Copilot, Windsurf, Gemini Enterprise, ainsi que les agents personnalisés construits avec les SDK d'OpenAI, d'Anthropic ou de Google. Le point de terminaison parle HTTP streamable.

Clé API ou OAuth : laquelle choisir ?

Les clients configurés par fichier (Claude Code, Cursor, VS Code, Windsurf, Gemini CLI) envoient une clé API dans un en-tête Authorization: Bearer. Les clients dotés d'une interface de connecteurs (ChatGPT, l'app web et desktop de Claude, Grok) utilisent OAuth 2.1 et l'enregistrement dynamique de client : il suffit de vous connecter, en laissant vide l'identifiant et le secret client.

Puis-je rendre la connexion en lecture seule ?

Oui. Chaque clé API porte un périmètre choisi à la création. Une clé en lecture seule ne peut appeler aucun outil d'écriture : la connexion est donc en lecture seule par construction. Les clés en lecture et écriture ajoutent des modifications, comme l'ajout de sites, la soumission d'URL à IndexNow et la gestion des clusters, et chacune d'elles est consignée dans le journal d'audit.

Quelle est la fraîcheur des données ?

Les lectures issues de l'entrepôt ont environ deux jours de retard sur Search Console elle-même, et chaque réponse indique la date jusqu'à laquelle les données sont consolidées. Les requêtes que l'entrepôt ne peut pas servir basculent automatiquement sur l'API GSC en direct, et chaque réponse précise la source utilisée.

Pourquoi ne pas laisser le modèle lire directement l'API GSC brute ?

La plupart des MCP Search Console parcourent l'API GSC lot après lot, lentement, et déversent des lignes brutes dans le contexte du modèle : c'est lent, on se heurte à l'échantillonnage et aux limites de lignes, et cela laisse la place aux hallucinations. GSC Wizard calcule chaque analyse en SQL côté serveur et renvoie le résultat finalisé : un rapport SEO complet sur un jeu de données de 4 GB en environ 4,4 secondes.

Un outil n'apparaît pas dans mon client. Que faire ?

Redémarrez complètement le client après avoir modifié sa configuration, car la plupart ne lisent les paramètres MCP qu'au démarrage. Vérifiez ensuite que la clé est toujours valide et non révoquée, que vous avez bien utilisé le chemin /mcp dans l'URL, et que l'outil voulu n'est pas un outil d'écriture bloqué par une clé en lecture seule.

Existe-t-il une option HTTP classique ?

Oui. Le même serveur expose une interface REST sur https://mcp.gscwizard.com/v1, avec les mêmes clés, périmètres, limites de débit et journal d'audit, ainsi qu'un document OpenAPI 3,1 sur /v1/openapi.json, généré à partir des schémas mêmes que le serveur utilise pour valider les requêtes.

Connectez vos données Search Console à n'importe quel client IA

Un seul point de terminaison, deux modes d'authentification, et des réponses finalisées au lieu de lignes brutes. Comptez environ deux minutes pour la mise en place.

Des astuces Search Console dans votre boîte mail

Des méthodes concrètes pour GSC et GA4, les nouveautés du produit et des expériences SEO. Pas de spam, désinscription à tout moment.