Accueil › SEO & IA › Connecter Google Analytics 4 (GA4) à Claude : le guide pas à pas
Analiza tu tráfico, tus fuentes y tus conversiones en lenguaje natural, directamente en Claude. Sin exportar, sin tablas cruzadas, sin programar.
El MCP (Model Context Protocol) es la interfaz estándar que conecta a Claude con una herramienta externa. El servidor MCP de Google Analytics lo publica Google, y no tienes que escribir ni una sola línea de código para utilizarlo.
Connecter ton Google Analytics 4 (GA4) à Claude tient en quatre étapes : créer un projet Google Cloud, activer les API Analytics, 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.
Los datos de GA4, en modo conversación
Al estar conectado a Claude, tu Google Analytics se lee en lenguaje natural. Solo tienes que hacer tu pregunta y Claude te muestra tus sesiones, tus fuentes y tus conversiones ya agregadas, sin necesidad de exportarlas ni de crear una exploración.
Avant, on devait ouvrir GA4, choisir le bon rapport, monter une exploration, croiser deux dimensions sans tout casser, puis exporter pour enfin lire un chiffre. L’interface qui te fait soupirer, tu connais, et c’est fini !
Là, tu écris une phrase. « Donne-moi mes sessions des 30 derniers jours par source. » La réponse arrive dans Claude, déjà mâchée. Tu enchaînes : « D’où viennent mes conversions ? », « Compare à l’an dernier », « Quelles pages ramènent le plus de monde ? ».
C’est tes données GA4, en mode discussion. Je m’en sers avant chaque point client, et je ne reviendrai pas en arrière. Encore faut-il savoir quoi regarder : pose d’abord un plan de mesure clair des KPI que tu souhaites tracker avant de foncer dans les chiffres.
Pour que la magie opère, Claude a juste besoin de lire ton Google Analytics. 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. De hecho, es lo que recomienda Google para su propia herramienta Analytics, y la forma más sencilla de mantenerla a largo plazo. Claude ve lo mismo que tú en GA4, ni más ni menos.
Google Analytics 4 es la herramienta que mide quién visita tu página web y qué hacen en ella. Al estar conectada a Claude, puedes explorarla en lenguaje natural, sin tablas cruzadas.
Lo que hay que instalar antes de empezar
Deux outils gratuits à installer une seule fois pour connecter Claude et GA4 : pipx 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 Pas de 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 pipx # pour faire tourner le serveur Analytics
brew install --cask gcloud-cli # l'outil de connexion GoogleEso 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 les deux API Analytics. C’est l’espace et les portes 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 à ton Analytics. 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 las dos API de Analytics
Une API, c’est une porte par laquelle deux logiciels se parlent. Par défaut elles sont fermées. Dans la barre de recherche en haut de la console, cherche et active ces deux-là, une par une, avec le bouton bleu Activer :
- API de datos de Google Analytics (tus cifras)
- API de administración de Google Analytics (la lista de tus propiedades)
Étape 2 : créer la clé de connexion (OAuth)
Génère un identifiant OAuth : le laissez-passer qui autorise Claude à lire ton Analytics 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 Analytics. - 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.jsonEste 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 à Analytics
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/analytics.readonlyUne 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 Analytics (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.
Conecta el servidor MCP Analytics
Sin salir del Terminal, pega este comando. Sustituye TON-ID-PROJET par l’ID noté à l’étape 1 :
claude mcp add --scope user google-analytics \
-e GOOGLE_PROJECT_ID=TON-ID-PROJET \
-- pipx run analytics-mcpA 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 à GA4 sans Terminal, ou sous Windows ?
Para conectar Google Analytics 4 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-analytics": {
"command": "pipx",
"args": ["run", "analytics-mcp"],
"env": {
"GOOGLE_PROJECT_ID": "TON-ID-PROJET"
}
}
}
}Cierra y vuelve a abrir Claude Desktop. En Windows, installe Python (avec pipx) et le gcloud CLI depuis leurs sites officiels plutôt que par Homebrew ; la commande gcloud auth del paso 3 sigue siendo el mismo en PowerShell.
Si el Terminal te echa para atrás
Hay servicios de terceros (Supermetrics, Porter, Windsor.ai) que conectan tu Analytics a 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 GA4
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 entre Claude y GA4
En el Terminal, escribe claude mcp list : tu servidor google-analytics debe mostrar ✓ Connected. Ensuite, dans Claude, lance-toi :
- «Lista de mis propiedades de Google Analytics».
- «Mis sesiones de los últimos 30 días por fuente y dispositivo.»
- «Compara mis conversiones de este mes con las del mes pasado.»
- « Quelles pages ramènent le plus de trafic organique ? »
Si les chiffres remontent, c’est branché !
Preguntas frecuentes sobre la conexión entre GA4 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é GA4, 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 Analytics.
Pourquoi la connexion GA4 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.
¿Qué es el servidor MCP de Google Analytics?
El servidor MCP de Google Analytics es un pequeño programa publicado por Google que se ejecuta en tu ordenador. Sirve de enlace entre Claude y la API de Analytics: Claude le formula tu pregunta, él busca los datos en GA4 y se los envía de vuelta. Se instala con el comando claude mcp add del paso 3.
Conectar Search Console a Claude
Brancher la Search Console 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 Search Console a Claude. Para conectarlos los dos a la vez, añade el osciloscopio webmasters.readonly en el comando de conexión del paso 3.
