Accueil › SEO & IA › Connecter Google Search Console à Claude : le guide pas à pas

Analiza tus búsquedas, tus clics y tus posiciones en lenguaje natural, directamente en Claude. Sin exportar, sin tablas cruzadas, sin programar.

Le MCP (Model Context Protocol), c’est la prise standard qui relie Claude à un outil extérieur. Le serveur MCP Search Console est open source, et tu n’as pas une ligne de code à écrire pour t’en servir.

Connecter ta Google Search Console à Claude tient en quatre étapes : créer un projet Google Cloud, activer l’API Search Console, générer un identifiant OAuth, puis brancher le serveur MCP à Claude. Ça va te prendre 15 minutes. Tu ne le fais qu’une seule fois et c’est gratuit.

4 pasos
por orden
15 minutos
una sola vez
0 €
En Google todo es gratis
Solo lectura
Claude está leyendo, no toca nada

Los datos de Search Console, en formato de conversación

Al conectarla con Claude, tu Search Console se lee en lenguaje natural. Solo tienes que hacer una pregunta y Claude te muestra tus consultas, clics y posiciones ya ordenados, sin necesidad de exportar ni de tablas cruzadas.

Avant, il fallait ouvrir la Search Console, régler la plage de dates, filtrer par page, exporter en CSV, puis batailler avec un tableau croisé pour sortir trois chiffres. La corvée du vendredi soir, tu connais, et c’est fini !

Là, tu écris une phrase. « Donne-moi mes 10 requêtes qui ont pris le plus de clics ce mois-ci. » La réponse arrive dans Claude, déjà mâchée. Tu enchaînes : « Lesquelles sont coincées en page 2 ? », « Compare à l’an dernier », « Quelles pages perdent des positions ? ».

Son tus datos de Search Console, en modo análisis. Los utilizo antes de cada auditoría y ya no voy a dejar de hacerlo. Poder consultar rápidamente las cifras reales es lo que te mantiene lúcido cuando la SERP cambia, el tema central del estado de las búsquedas en 2026.

Pour que la magie opère, Claude a juste besoin de lire ta Search Console. C’est tout ce que ce guide connecte. Et on reste en lecture seule : il regarde tes chiffres, il ne publie rien, n’efface rien, ne touche à aucun réglage.

Pourquoi on branche ton propre compte Google à Claude ?

En lugar de una «cuenta de servicio» (un bot que invitas a tus herramientas), se accede directamente a través de tu cuenta de Google. Es la forma que recomienda Google para este tipo de acceso, y la más sencilla de mantener a largo plazo. Claude ve lo mismo que tú en Search Console, ni más ni menos.

La Search Console, c’est le tableau de bord gratuit de Google sur ta visibilité : requêtes, clics, positions. Branchée à Claude, tu l’interroges en français, sans export.

Lo que hay que instalar antes de empezar

Deux outils gratuits à installer une seule fois pour connecter Claude et la Search Console : Node et le gcloud CLI.

Le pas à pas ci-dessous utilise Claude Code sur Mac, la version de Claude qui vit dans le Terminal. Sous Windows ou sur Claude Desktop, toute la partie Google est identique : file à la section Comment connecter Claude à la Search Console sans Terminal, ou sous Windows ? pour le branchement.

Sur Mac, deux petits outils à installer si tu ne les as pas. Ouvre l’app Terminal et colle ces lignes une par une :

# Homebrew, le gestionnaire d'installation du Mac (saute si tu l'as déjà)
# instructions sur https://brew.sh

brew install node                # pour faire tourner le serveur Search Console
brew install --cask gcloud-cli   # l'outil de connexion Google

Eso es todo en cuanto a la interfaz gráfica. El resto se hace en el navegador y en el Terminal, pantalla a pantalla.

Étape 1 : préparer le projet Google Cloud

Crée un projet Google Cloud gratuit, puis active l’API Search Console. C’est l’espace et la porte par lesquels Claude viendra lire tes données. Rien de payant, rien de risqué. Je t’explique :

Crea el proyecto de Google Cloud

Va sur console.cloud.google.com et connecte-toi avec le compte Google qui a accès à ta Search Console. C’est le point le plus important du guide : ce compte-là, et pas un autre.

Si Google te propone crear un proyecto, acéptalo. El nombre no tiene ninguna importancia. Si ya tienes un proyecto, puedes volver a utilizarlo. No pierdas de vista elID del proyecto que aparece en la página de inicio, algo así como mon-projet-123, lo necesitaremos al final.

Activa la API de Search Console

Una API es una puerta a través de la cual dos programas se comunican entre sí. Por defecto, está cerrada. En la barra de búsqueda situada en la parte superior de la consola, busca «Google Search Console API» y haz clic en el botón azul «Activar». Solo hay que activar una API para esta guía.

Étape 2 : créer la clé de connexion (OAuth)

Génère un identifiant OAuth : le laissez-passer qui autorise Claude à lire ta Search Console en ton nom. Ça se fait en deux sous-étapes, et un fichier à télécharger.

Configura la pantalla de autorización de OAuth

Dans le menu de gauche, va dans Google Auth Platform (ou cherche « OAuth » dans la barre du haut). Configure-le ainsi :

  • Type d’utilisateur : Externe.
  • Deja el estado en «Prueba», es perfecto para uso personal.
  • En «Usuarios de prueba», haz clic en «Añadir usuarios» e introduce tu propia dirección de Gmail, la del paso 1.

À quoi sert de t’ajouter en utilisateur test ?

Mientras tu aplicación esté en modo de prueba, solo las direcciones que aparecen aquí tienen permiso para utilizarla. Al añadirte, te autorizas a ti mismo. Esto también te permitirá pasar sin problemas la pantalla «aplicación no validada» en el paso 3.

Crea el cliente OAuth y recupera la clave

Toujours dans Google Auth Platform, va dans Clients puis Créer un client :

  • Type d’application : Application de bureau.
  • Ponle un nombre que signifique algo, por ejemplo Claude Search Console.
  • Haz clic en «Crear» y, a continuación, en «Descargar en formato JSON».

Este pequeño archivo .json, c’est ta clé. Range-le dans un dossier discret et facile à retrouver. Je te propose ce chemin, qu’on réutilisera tel quel :

# crée le dossier puis dépose ton fichier dedans, renommé proprement
mkdir -p ~/.config/google-mcp
mv ~/Downloads/client_secret_*.json ~/.config/google-mcp/oauth-client.json

Este archivo es una contraseña

Ne l’envoie jamais par mail, ne le poste pas sur Discord, ne le mets pas dans un dossier partagé. Il donne accès à tes données : tu le gardes sur ton ordi et c’est tout.

Étape 3 : connecter Claude à la Search Console

Deux commandes dans le Terminal : une pour t’identifier auprès de Google, une pour brancher le serveur à Claude. Tu copies, tu colles, et tu valides. Rien de sorcier !

Inicia sesión con la cuenta de Google correcta

Colle cette commande dans le Terminal. Elle tient sur plusieurs lignes, copie tout le bloc d’un coup :

gcloud auth application-default login \
  --client-id-file=$HOME/.config/google-mcp/oauth-client.json \
  --scopes=openid,\
https://www.googleapis.com/auth/cloud-platform,\
https://www.googleapis.com/auth/webmasters.readonly

Une fenêtre de navigateur s’ouvre. Déroule ces étapes :

  • Elige tu cuenta de Google, la del paso 1.
  • Un écran « Google n’a pas validé cette application » s’affiche : c’est normal, l’appli c’est toi. Clique Paramètres avancés, puis Accéder à Claude Search Console (non sécurisé).
  • Autoriza el acceso de lectura.

De vuelta en la Terminal, deberías ver Credentials saved to file. Ya está, tu conexión queda registrada.

Branche le serveur MCP Search Console

Toujours dans le Terminal, colle cette commande. Elle branche la Search Console à Claude :

claude mcp add --scope user google-search-console \
  -e GOOGLE_APPLICATION_CREDENTIALS=$HOME/.config/gcloud/application_default_credentials.json \
  -- npx -y mcp-server-gsc

A continuación, cierra y vuelve a abrir Claude Code. La nueva herramienta solo aparece al reiniciar, y eso es lo que confunde a todo el mundo.

Comment connecter Claude à la Search Console sans Terminal, ou sous Windows ?

Para conectar Search Console a Claude sin Terminal, la configuración por parte de Google (proyecto en la nube, API, identificador de OAuth) es la misma en todos los sistemas. Lo único que cambia es la forma de conectar el servidor MCP. El inicio de sesión en tu cuenta, el comando gcloud auth del paso 3, pasa de todos modos una vez por el Terminal en Mac o por PowerShell en Windows.

En Claude Desktop (Mac o Windows), no escribas claude mcp add. Tu ajoutes le serveur dans la config : dans l’app, Ajustes → Desarrollador → Editar configuración, puis colle ce bloc et enregistre :

{
  "mcpServers": {
    "google-search-console": {
      "command": "npx",
      "args": ["-y", "mcp-server-gsc"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "chemin/vers/application_default_credentials.json"
      }
    }
  }
}

Cierra y vuelve a abrir Claude Desktop. En Windows, instala Node y la CLI de gcloud desde sus páginas web oficiales en lugar de hacerlo a través de Homebrew, y la ruta del archivo de conexión pasa a ser %APPDATA%\gcloud\application_default_credentials.json.

Si el Terminal te echa para atrás

Hay servicios de terceros (Supermetrics, Porter, Windsor.ai) que conectan Search Console con Claude con un solo clic, sin necesidad de usar la línea de comandos. La desventaja es que son de pago y que tus datos pasan por sus servidores antes de llegar a Claude. Para un uso personal y gratuito, el método anterior sigue siendo el más limpio.

Étape 4 : vérifier la connexion avec Claude et interroger la Search Console

Comprueba que el servidor muestre «Connected» y, a continuación, formula tus preguntas en lenguaje natural. Lo más difícil ya está hecho.

Comprueba la conexión de Claude y Search Console

En el Terminal, escribe claude mcp list : tu servidor google-search-console debe mostrar ✓ Connected. Ensuite, dans Claude, lance-toi :

  • «Lista de mis propiedades en Search Console».
  • «Las 10 búsquedas más populares por número de clics en los últimos 28 días en mi-sitio.com.»
  • « Quelles requêtes sont coincées en position 11 à 20 et méritent un coup de pouce ? »
  • « Quelles pages ont le plus chuté en clics depuis 3 mois ? »

Si les chiffres remontent, c’est branché !

Preguntas frecuentes sobre la conexión entre Search Console y Claude

Deux blocages reviennent : « aucune propriété » quand Claude est connecté au mauvais compte Google, et « invalid_grant » quand la connexion a expiré. Les deux se règlent en relançant la commande de connexion de l’étape 3.

Claude ne voit aucune propriété Search Console, que faire ?

En la mayoría de los casos, el inicio de sesión se ha realizado con una cuenta de Google incorrecta. Vuelve a intentar el proceso de inicio de sesión del paso 3 y elige la cuenta que realmente tenga acceso a tu Search Console.

Pourquoi la connexion Search Console expire-t-elle après quelques jours dans Claude ?

En el modo de prueba, el token de acceso caduca al cabo de aproximadamente una semana y Claude muestra el mensaje «invalid_grant». Vuelve a ejecutar el comando de conexión del paso 3. Para no tener que volver a preocuparte por ello, cambia tu aplicación al modo «Producción» en Google Auth Platform.

C’est quoi le serveur MCP Search Console ?

Le serveur MCP Search Console est un petit programme open source qui tourne sur ta machine. Il fait le lien entre Claude et l’API Search Console : Claude lui pose ta question, il va chercher tes requêtes, tes clics et tes positions, et les lui renvoie. Il s’installe avec la commande claude mcp add del paso 3.

Conectar Google Analytics a Claude

Brancher GA4 suit la même logique : même projet Google Cloud, une API et un scope différents. Je t’ai fait le guide jumeau : Cómo conectar Google Analytics 4 a Claude. Para conectarlos los dos a la vez, añade el osciloscopio analytics.readonly en el comando de conexión del paso 3.

Next Gen SEO El acompañamientoEl SEO que ya no se viene abajo con cada actualizaciónEl método de SEO replicable para crear estrategias adaptadas a la ubicación geográfica, sin tener que preocuparte por tus recomendaciones aunque cambien los algoritmos.Descubre el método →