Connecter GSC à Gemini

Comment connecter les données Google Search Console à Gemini ?

Gemini lit vos données Search Console via le même point de terminaison MCP que tous les autres assistants. Collez mcp.gscwizard.com dans l'app Gemini (États-Unis, comptes personnels), Antigravity CLI, Gemini Enterprise ou l'API Gemini, et Gemini travaille à partir de vrais clics, impressions, positions et CTR.

Point de terminaison : https://mcp.gscwizard.com/mcp

La réponse courte

Ajoutez le serveur MCP de GSC Wizard à l'interface Gemini que vous utilisez :

  1. L'app Gemini : Paramètres → Applications connectées → Ajouter une app personnalisée, puis collez https://mcp.gscwizard.com/mcp. Google propose cette option aux adultes aux États-Unis disposant d'un compte Google personnel.
  2. Antigravity CLI (le successeur de Gemini CLI pour les comptes individuels) : une seule entrée serverUrl dans mcp_config.json.
  3. Gemini Enterprise : ajoutez un serveur MCP personnalisé avec OAuth 2.0. Il n'accepte pas de clé API.
  4. L'API Gemini : transmettez une session client MCP dans tools avec le SDK Google Gen AI, ou appelez directement l'interface REST sur /v1.

Vous ne savez pas laquelle utiliser ? Le tableau ci-dessous indique à qui s'adresse chaque voie.

Quelle voie Gemini pouvez-vous utiliser ?

C'est Google qui décide qui a accès à quelle interface, pas GSC Wizard. Les conditions ci-dessous proviennent des pages d'aide de Google.

VoieQui peut l'utiliserConnexionMise en place
App GeminiAdultes (18 ans et plus) aux États-Unis, compte Google personnel, en anglais, avec l'option Conserver l'activité activée. Pas les comptes professionnels ni scolaires.OAuth, automatique. Aucune clé à copier.Collez une URL. Environ une minute.
Antigravity CLI et IDEDéveloppeurs, partout dans le monde. Gemini CLI lui-même ne sert plus que les clients enterprise et les utilisateurs payants avec clé API.En-tête avec clé API, ou OAuth.Une entrée JSON.
Gemini EnterpriseOrganisations. Un administrateur d'équipe ou du cloud ajoute le serveur.OAuth 2.0 uniquement. Les clés API ne sont pas acceptées.Créez un client OAuth, puis remplissez le formulaire du connecteur.
API GeminiDéveloppeurs qui créent leur propre agent.En-tête avec clé API.Quelques lignes avec le SDK Gen AI.
Vidéo

La configuration de bout en bout en vidéo

Un pas-à-pas du même serveur MCP auquel Gemini se connecte : l'ajouter, s'authentifier et demander une vraie analyse Search Console en langage naturel.

Option 1 : la plus simple

L'app Gemini

Gemini permet désormais d'ajouter votre propre serveur MCP comme app personnalisée. GSC Wizard prend en charge l'enregistrement dynamique de client : Gemini s'enregistre lui-même et il n'y a ni clé API ni secret client à copier.

Vérifiez que Google vous propose cette option

Selon la page d'aide de Google sur les apps personnalisées, vous devez avoir 18 ans ou plus et être aux États-Unis, connecté avec un compte Google personnel (les comptes professionnels et scolaires ne sont pas pris en charge pour l'instant), utiliser Gemini en anglais, avec l'option Conserver l'activité activée. Vous ajoutez l'app dans l'application web sur gemini.google.com, et elle fonctionne ensuite aussi dans l'app mobile. Si vous ne voyez pas Ajouter une app personnalisée, l'une de ces conditions n'est pas remplie : utilisez Antigravity CLI, Gemini Enterprise ou l'API ci-dessous.

  1. 1

    Connectez vos propriétés dans GSC Wizard

    Connectez-vous sur tool.gscwizard.com avec le compte Google qui a accès à vos propriétés Search Console. Gemini lira exactement les propriétés que vous y connectez.

  2. 2

    Ajouter une app personnalisée dans Gemini

    Rendez-vous sur gemini.google.com depuis un ordinateur, cliquez sur Paramètres en bas, puis sur Applications connectées. Sous Apps personnalisées, cliquez sur Ajouter une app personnalisée et saisissez https://mcp.gscwizard.com/mcp. Gardez le /mcp à la fin : le domaine seul ne répond pas aux requêtes MCP.

  3. 3

    Connectez-vous et validez

    Cliquez sur Suivant et suivez les étapes. Gemini vous redirige vers un écran de connexion et de consentement de GSC Wizard. Vous pouvez laisser vides les identifiants sous Fonctionnalités avancées, car ils ne concernent que les serveurs qui ne peuvent pas enregistrer un client automatiquement.

  4. 4

    Posez vos questions avec @

    Dans une nouvelle conversation, tapez @, choisissez l'app GSC Wizard et posez une question comme « Quelles pages de example.com ont perdu le plus de clics ces 28 derniers jours ? ». Gemini vous demande de confirmer avant toute action d'écriture.

Google précise qu'il ne contrôle, ne surveille ni ne sécurise les serveurs MCP tiers, et que Gemini peut partager le contenu de la conversation avec une app connectée. GSC Wizard ne renvoie que les données Search Console, GA4 et Bing que vous avez connectées à votre propre compte. Vous pouvez désactiver l'app, la dissocier ou la supprimer à tout moment dans Paramètres → Applications connectées.

Option 2 : développeurs

Antigravity CLI et IDE

Antigravity est l'environnement d'agents de Google et le successeur de Gemini CLI pour les comptes individuels. Il lit les serveurs MCP distants depuis un fichier JSON et fonctionne partout où Antigravity est disponible, sans restriction aux États-Unis côté MCP.

  1. 1

    Créer une clé API dans GSC Wizard

    Connectez-vous sur tool.gscwizard.com, connectez vos propriétés Search Console, puis créez une clé dans Compte → Clés API. Vous préférez OAuth à une clé stockée ? Passez cette étape et consultez la note sous la configuration.

  2. 2

    Ajouter le serveur à mcp_config.json

    Modifiez ~/.gemini/config/mcp_config.json pour tous vos projets, ou .agents/mcp_config.json dans un dépôt pour limiter la portée à ce dépôt. Les serveurs distants utilisent la clé serverUrl : d'après la documentation de Google, les anciennes clés url et httpUrl n'y sont pas prises en charge.

  3. 3

    Vérifier et poser vos questions

    Tapez /mcp dans le panneau de saisie pour confirmer que le serveur est connecté et voir ses outils, puis interrogez-le sur votre site en langage naturel.

~/.gemini/config/mcp_config.json

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

Pour vous connecter au lieu de stocker une clé, omettez le bloc headers. Comme GSC Wizard prend en charge l'enregistrement dynamique de client, Antigravity lance le flux OAuth quand vous cliquez sur Authenticate à côté du serveur, sous Agent settings → Customizations.

Vous utilisez encore Gemini CLI ?

Google a cessé de proposer Gemini CLI aux comptes individuels gratuits, Google AI Pro et Ultra le 18 juin 2026 et oriente ces utilisateurs vers Antigravity CLI. Les clients enterprise et les utilisateurs payants avec clé API conservent Gemini CLI, et pour eux le point de terminaison s'intègre avec un en-tête bearer.

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

Ou ajoutez une entrée dans ~/.gemini/settings.json avec "httpUrl": "https://mcp.gscwizard.com/mcp" et le même objet headers. Référencez une variable d'environnement comme $GSCW_KEY plutôt que de coller la clé, pour qu'elle reste hors du contrôle de version.

Option 3 : organisations

Gemini Enterprise

Gemini Enterprise prend en charge les serveurs MCP personnalisés : un administrateur peut donc mettre les données Search Console à disposition des agents de toute l'organisation. Google ne documente que deux modes de connexion pour ces serveurs, Aucune authentification et OAuth 2.0, donc un en-tête avec clé API statique ne fonctionne pas ici. GSC Wizard se connecte via OAuth 2.0 avec un client que vous créez vous-même.

  1. 1

    Créer un client OAuth pour Gemini Enterprise

    Gemini Enterprise renvoie toujours les utilisateurs vers https://vertexaisearch.cloud.google.com/oauth-redirect : enregistrez donc un client pour cette URL de redirection. La réponse contient un client ID (commençant par gscwc_) et un secret client qui n'est affiché qu'une seule fois, alors conservez-le avant de continuer.

  2. 2

    Ouvrir le formulaire de serveur MCP personnalisé

    Dans l'édition Business, connectez-vous sur business.gemini.google, ouvrez Paramètres & aide, choisissez votre équipe, puis Gérer l'équipe → Applications connectées → Ajouter un serveur MCP. Avec la console Google Cloud, ouvrez Gemini Enterprise, allez dans Data stores → Create data store, cherchez Custom MCP Server et cliquez sur Add MCP server.

  3. 3

    Saisir les valeurs OAuth 2.0

    Choisissez OAuth 2.0, remplissez le tableau ci-dessous et cliquez sur Verify Auth. Choisissez ensuite un emplacement, nommez le connecteur et créez-le.

  4. 4

    Activer le connecteur et ses outils

    Google laisse les nouvelles connexions MCP personnalisées désactivées. Dans l'édition Business, activez la connexion sur la page Connecteurs. Dans la console Cloud, ouvrez le data store, choisissez Actions → Reload custom actions, sélectionnez les outils voulus et cliquez sur Enable actions.

Étape 1 : enregistrer le client

curl -X POST https://tool.gscwizard.com/api/oauth/register \
  -H "Content-Type: application/json" \
  -d '{
    "client_name": "Gemini Enterprise",
    "redirect_uris": ["https://vertexaisearch.cloud.google.com/oauth-redirect"],
    "token_endpoint_auth_method": "client_secret_post",
    "grant_types": ["authorization_code", "refresh_token"]
  }'

Étape 3 : les valeurs

Champ Gemini EnterpriseValeur
URL du serveur MCPhttps://mcp.gscwizard.com/mcp
AuthentificationOAuth 2.0
URL d'autorisationhttps://tool.gscwizard.com/oauth/authorize
URL du jetonhttps://tool.gscwizard.com/api/oauth/token
Client ID et secretIssus de la réponse de l'étape 1 (gscwc_ et le secret)
Scopesmcp:read pour un accès en lecture seule, ou mcp:read mcp:write
PKCEActivez-le partout où le formulaire propose l'option : le serveur d'autorisation de GSC Wizard exige PKCE

L'URL d'autorisation ne contient pas /api/ alors que l'URL du jeton en contient : les deux sont correctes. Par la console Cloud, un administrateur a aussi besoin du rôle Discovery Engine Editor, doit lever la politique d'organisation qui bloque par défaut les data stores MCP personnalisés, et doit autoriser les domaines mcp.gscwizard.com et tool.gscwizard.com. Les pages de configuration de Google couvrent les deux voies : le guide de la console Cloud et le guide de l'édition Business.

Option 4 : développeurs

L'API Gemini et vos propres agents

Vous créez un agent plutôt que de discuter ? Le SDK Google Gen AI peut transmettre une session client MCP directement dans la liste des outils, de sorte que Gemini appelle directement les outils de GSC Wizard.

Python : google-genai avec une session MCP

from google import genai
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

URL = "https://mcp.gscwizard.com/mcp"
HEADERS = {"Authorization": "Bearer gscw_live_..."}
MODEL = "gemini-3.1-pro"  # or whichever Gemini model you use

async with streamablehttp_client(URL, headers=HEADERS) as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()
        response = await genai.Client().aio.models.generate_content(
            model=MODEL,
            contents="Which pages on example.com lost the most clicks in the last 28 days?",
            config=genai.types.GenerateContentConfig(tools=[session]),
        )
        print(response.text)

Si vous préférez ne pas parler MCP du tout, les mêmes clés, scopes et limites de débit alimentent une interface REST classique sur https://mcp.gscwizard.com/v1, avec un document OpenAPI 3,1 généré sur /v1/openapi.json que vous pouvez fournir à Gemini comme spécification de function calling.

Hors des États-Unis, ou avec un compte professionnel ?

Google ne propose actuellement les apps personnalisées dans l'app Gemini qu'aux adultes aux États-Unis disposant d'un compte Google personnel : l'option peut donc ne pas apparaître chez vous. Antigravity CLI, Gemini Enterprise et l'API Gemini ne sont pas soumis à cette règle. Si vous voulez simplement transmettre les chiffres à un collègue, un lien de rapport partagé ou un export CSV depuis GSC Wizard fonctionne dans n'importe quelle conversation.

Les plateformes de connecteurs comme Windsor.ai et Supermetrics

Demandez à Gemini comment connecter Search Console et il cite souvent des plateformes de connecteurs de données comme Windsor.ai et Supermetrics. Elles résolvent un autre problème : le choix dépend donc de votre besoin.

Une plateforme de connecteurs convient quand

  • Search Console est l'une des dizaines de sources publicitaires et marketing que vous centralisez déjà au même endroit.
  • Vous voulez un reporting unifié entre plateformes publicitaires, analytics et Search Console.
  • Votre équipe vit dans des tableurs ou un outil de BI, et Gemini n'est qu'un complément.

GSC Wizard convient quand

  • Vous voulez de l'analyse SEO, comme le déclin, la cannibalisation, les courbes de CTR et la notation des opportunités, pas seulement des lignes brutes.
  • Vous voulez que l'analyse s'exécute côté serveur sur l'ensemble des données Search Console, afin que Gemini lise un résultat finalisé.
  • Vous voulez une seule URL MCP qui fonctionne aussi dans ChatGPT, Claude, Grok et Copilot Studio.

Pour comparer côte à côte les outils de reporting et de pipeline, consultez mon comparatif des meilleurs outils de reporting SEO et le guide des connecteurs pour les données Search Console.

Une question en langage naturel, une réponse finalisée

Ce que vous pouvez demander une fois connecté

Chaque analyse tourne côté serveur sur l'entrepôt de données : l'assistant lit un résultat finalisé au lieu de faire des calculs sur des lignes brutes.

« Donne-moi une synthèse des performances de example.com » « Quelles sont mes principales requêtes et pages ce mois-ci ? » « Quelles requêtes ont gagné ou perdu des positions par rapport au mois dernier ? » « Trouve les pages en déclin » « Où est-ce que je cannibalise des mots-clés ? » « Montre ma courbe de CTR selon la position » « Génère un rapport SEO complet » « Inspecte https://example.com/pricing dans Google » « Quelles pages sont proches de la première page ? » « Soumets ces URL à IndexNow »
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.

Consultez aussi la présentation du MCP Google Search Console, le MCP GA4, le MCP Yandex Webmaster, le MCP Merchant Center, l'app ChatGPT (l'installer dans ChatGPT), les connecteurs Meta Muse pour Search Console et Google Analytics, notre sélection des meilleurs serveurs MCP SEO et le guide 2026 des connecteurs ChatGPT pour les données Search Console.

Questions fréquentes

L'app Gemini peut-elle se connecter à Google Search Console ?

Oui, si vous remplissez les conditions de Google : avoir 18 ans ou plus et être aux États-Unis, connecté avec un compte Google personnel (pas un compte professionnel ou scolaire), en anglais, avec l'option Conserver l'activité activée. Ouvrez gemini.google.com, allez dans Paramètres, puis Applications connectées, cliquez sur Ajouter une app personnalisée et saisissez https://mcp.gscwizard.com/mcp. Gemini s'enregistre auprès du serveur et vous fait passer par une connexion GSC Wizard. Si vous ne remplissez pas ces conditions, utilisez Antigravity CLI, Gemini Enterprise ou l'API Gemini.

Pourquoi je ne vois pas « Ajouter une app personnalisée » dans mon app Gemini ?

Google ne propose actuellement les apps personnalisées qu'aux adultes aux États-Unis, uniquement avec un compte Google personnel, uniquement en anglais et uniquement avec l'option Conserver l'activité activée, et vous les ajoutez dans l'application web sur gemini.google.com. Si vous êtes hors des États-Unis ou sur un compte professionnel ou scolaire, l'option n'apparaît pas. Utilisez plutôt Antigravity CLI, Gemini Enterprise ou l'API Gemini.

Gemini Enterprise accepte-t-il une clé API ?

Non. Google documente deux modes d'authentification pour un serveur MCP personnalisé dans Gemini Enterprise, aucune authentification et OAuth 2.0, et aucun n'accepte d'en-tête Authorization statique. Connectez GSC Wizard avec OAuth 2.0, en utilisant un client ID et un secret créés pour l'URL de redirection de Gemini Enterprise.

Antigravity CLI prend-il en charge les serveurs MCP distants avec authentification ?

Oui. Ajoutez une entrée avec serverUrl et un objet headers dans ~/.gemini/config/mcp_config.json (ou .agents/mcp_config.json dans un projet). Pour les serveurs qui prennent en charge l'enregistrement dynamique de client, comme GSC Wizard, vous pouvez omettre les headers et vous authentifier avec OAuth depuis les paramètres de l'agent.

Gemini CLI reste-t-il une option ?

Seulement pour certains comptes. Google a cessé de proposer Gemini CLI aux comptes individuels gratuits, Google AI Pro et Ultra le 18 juin 2026 et oriente ces utilisateurs vers Antigravity CLI. Gemini CLI reste disponible pour les clients enterprise et les utilisateurs payants avec clé API, et pour eux gemini mcp add avec --transport http et --header permet toujours d'enregistrer GSC Wizard.

Les données sont-elles échantillonnées ou plafonnées comme un export Search Console ?

Non. Les lectures proviennent d'un entrepôt ClickHouse qui contient l'ensemble des lignes : il n'y a donc ni plafond de lignes d'export ni pagination de l'API GSC. L'entrepôt a environ deux jours de retard, et chaque réponse indique la date jusqu'à laquelle les données sont stabilisées.

Que peut faire Gemini une fois connecté ?

Tout ce que le MCP expose : analyse de la recherche, principales requêtes et pages, évolutions de positions, déclin et cannibalisation, courbes de CTR, notation des opportunités, inspection d'URL en masse, suivi de l'indexation, soumissions IndexNow, données Bing Webmaster, métriques GA4 et rapports SEO complets.

Est-ce payant ?

Les clés API sont gratuites pour tous les comptes GSC Wizard, et l'offre gratuite passe par l'API GSC. Les abonnés bénéficient des requêtes rapides sur l'entrepôt de données, ce qui rend l'analyse de l'ensemble des données praticable. Voir la page des tarifs pour les détails.

Connectez Gemini à vos données Search Console

Créez une clé API gratuite, ajoutez une entrée à votre configuration Gemini et interrogez-le sur votre site en langage naturel.

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.