Google Analytics MCP : brancher GA4 à Claude, et savoir quand ça ne suffit pas.

Bastien GeneixBastien GeneixMis à jour le 5 novembre 2026 · 10 min de lecture

Google publie un serveur MCP officiel pour Google Analytics. Il donne à Claude neuf outils pour lire une propriété GA4 : rapports, temps réel, entonnoirs, configuration. Il est sérieux, ouvert et en lecture seule par défaut. Mais il demande Python, un projet Google Cloud et des identifiants, et il tourne sur votre machine. Si votre question porte sur GA4, c'est la voie directe. Si elle porte sur ce que vos visites rapportent, GA4 seul ne suffit pas : il faut vos ventes et vos dépenses en face.

Que fait le MCP de Google Analytics ?

Le MCP, pour Model Context Protocol, permet à un assistant d'appeler des outils externes. Celui de Google traduit votre question en appels aux API Admin et Data de GA4. Voici les neuf outils que liste sa documentation :

OutilCe qu'il rendQuand il sert
get_account_summariesVos comptes et propriétésTrouver le bon identifiant
get_property_detailsLa configuration d'une propriétéVérifier le fuseau et la devise
list_google_ads_linksLes comptes Google Ads liésContrôler une liaison
list_property_annotationsLes annotations de la propriétéRetrouver un changement daté
get_custom_dimensions_and_metricsVos dimensions et métriques personnaliséesAvant une question sur vos propres champs
run_reportUn rapport standardLa plupart des questions
run_realtime_reportUn rapport en temps réelContrôler un lancement
run_funnel_reportUn entonnoirLire un tunnel de conversion
run_conversions_reportUn rapport de conversionsSuivre vos événements clés

Nous l'utilisons chaque semaine pour le suivi SEO de ce site. Son point fort : il appelle l'API, donc le chiffre vient de GA4. Son point faible : il ne vous dit pas si ce chiffre est le bon à regarder.

Installer le serveur, étape par étape

L'installation passe par un terminal. Il vous faut :

  1. Python 3.10 ou plus, avec pipx ou uv.
  2. Un projet Google Cloud où activer l'API Google Analytics Admin et l'API Google Analytics Data.
  3. Le rôle Lecteur sur la propriété, pour votre compte ou un compte de service.
  4. Des identifiants : gcloud auth application-default login avec le droit analytics.readonly, et le chemin du fichier JSON que la commande affiche.

Ensuite, pour Claude Desktop, ajoutez le serveur à claude_desktop_config.json :

{
  "mcpServers": {
    "analytics-mcp": {
      "command": "pipx",
      "args": ["run", "analytics-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "CHEMIN_VERS_LE_JSON",
        "GOOGLE_CLOUD_PROJECT": "ID_DU_PROJET"
      }
    }
  }
}

Pour Claude Code, une commande :

claude mcp add analytics-mcp \
  --scope user \
  -e GOOGLE_APPLICATION_CREDENTIALS="CHEMIN_VERS_LE_JSON" \
  -e GOOGLE_CLOUD_PROJECT="ID_DU_PROJET" \
  -- pipx run analytics-mcp

Et Claude.ai ?

Un connecteur personnalisé de Claude.ai attend un serveur distant, joignable sur Internet. Or celui-ci tourne en local. Le dépôt décrit un mode HTTP avec OAuth, déployable sur Cloud Run. C'est un travail de développeur, et un service de plus à tenir à jour.

Lecture seule, vraiment ?

Les deux documents de Google ne disent pas tout à fait la même chose, et c'est bon à savoir. La page pour développeurs, mise à jour le 26 octobre 2026, écrit que le serveur ne crée, ne modifie ni ne supprime rien. Le dépôt GitHub, lui, décrit une option --allow-write : avec elle et le droit analytics.edit, le serveur peut créer une annotation, une dimension personnalisée ou un événement clé.

Notre avis : gardez la lecture seule.

Un événement clé créé par erreur change vos conversions à partir de ce jour-là. Ce genre de décision se prend dans l'interface, pas au détour d'une conversation.

À quoi ressemble un appel ?

Vous n'écrivez pas ce code : l'assistant le fait. Mais il vaut la peine de le lire, car c'est lui qui dit quelle métrique a été choisie.

run_report(
  property_id="properties/123456789",
  date_ranges=[{"start_date": "2026-10-01", "end_date": "2026-10-31"}],
  dimensions=["sessionDefaultChannelGroup"],
  metrics=["sessions", "purchaseRevenue"]
)

Demandez à Claude de vous montrer les paramètres de son appel. purchaseRevenue n'est pas totalRevenue, et sessionDefaultChannelGroup n'est pas firstUserDefaultChannelGroup : la première se rapporte à la session, la seconde au premier passage de l'utilisateur. Deux réponses crédibles, deux chiffres différents. Chaque requête consomme aussi du quota de votre propriété : un assistant qui multiplie les appels sur une longue période peut l'épuiser.

Google Analytics 4, rapport Transactions : une ligne par identifiant de transaction, avec les achats et les revenus issus des achats sur 28 jours.
Le rapport Transactions de GA4, sur le compte de démonstration de Google. La liste des identifiants est ce qui permet de contrôler le revenu avec votre boutique.

Ce que GA4 ne vous dira pas

  • Vos ventes réelles. Il mesure des événements d'achat. Pour le chiffre encaissé, la boutique fait foi : c'est ce que lit le connecteur Shopify pour Claude.
  • Votre dépense complète. GA4 ne connaît les coûts que des comptes liés ou importés. Pour le MER, il faut toute la dépense.
  • Ce qui s'est passé avant le clic. Les requêtes de recherche sont dans la Search Console, le revenu revendiqué dans chaque régie.

Le MCP de Google ou un connecteur multi-sources ?

Le MCP de GoogleKyras
Mise en placePython, projet Google Cloud, deux API, identifiantsUne autorisation Google, puis une adresse dans Claude
Où ça tourneSur votre machine, ou sur un serveur que vous hébergezHébergé par Kyras
Claude.aiSeulement si vous hébergez le serveurOui, comme Claude Code
LectureTout ce que l'API de GA4 expose, propriété par propriétéGA4 avec votre boutique, vos régies et la Search Console
Le revenuCelui que GA4 a mesuréLa commande d'abord, GA4 s'il n'y a pas de boutique branchée
PrixCode ouvert, licence Apache 2.0Inclus dans les formules Pro et Scale
En une ligne
  • Vous êtes à l'aise avec un terminal et votre question porte sur GA4 : prenez le MCP de Google.
  • Vous voulez une réponse qui croise GA4, vos ventes et vos régies, sans rien installer : passez par un connecteur qui les lit ensemble.

Passer par Kyras

Kyras lit votre propriété GA4 avec une autorisation Google, en lecture : sessions, conversions, revenu, e-commerce par article, canaux, pages d'entrée. Il met ces chiffres face à votre boutique, à Meta Ads, à Google Ads et à la Search Console. Quand une boutique est branchée, le chiffre d'affaires vient des commandes et GA4 explique d'où viennent les visites.

Côté Claude, ajoutez un connecteur personnalisé avec l'adresse https://app.kyras.ai/api/mcp/mcp, connectez-vous et choisissez l'espace. Cinq outils en lecture, sans Python ni projet Google Cloud. L'accès s'ouvre avec l'abonnement. Le pas à pas est dans le centre d'aide, et l'intégration GA4 détaille ce que Kyras lit.

Rendu d'exemple d'une revue des régies : ce que Meta et Google s'attribuent face à ce que le site mesure, campagne par campagne, sur une boutique d'exemple.
Dans Kyras. Une revue des régies rendue par Claude : ce que Meta et Google s'attribuent, face à ce que le site mesure. Boutique d'exemple, données fictives. Voir le serveur MCP

Que demander à GA4 depuis Claude ?

Une bonne question nomme la métrique, la dimension et la période. Trois exemples :

  • « Sessions et revenu d'achat par groupe de canaux par défaut, octobre contre septembre. » Deux métriques, une dimension, deux périodes : l'assistant n'a rien à interpréter. Vous vérifiez dans GA4 en deux minutes.
  • « Quelles dimensions et métriques personnalisées existent sur cette propriété ? » Une question de configuration, utile avant toutes les autres. Elle évite de demander un champ qui n'existe pas.
  • « Le revenu de GA4 en octobre colle-t-il à mes commandes ? » GA4 n'a pas la réponse : il faut la boutique en face. Sans elle, l'assistant ne peut que commenter le chiffre de GA4.

Cinq pièges de lecture dans GA4

  1. Ignorer les lignes « (not set) ». Sur notre propre propriété, une session organique sur cinq revenait sans page d'entrée la semaine du 29 octobre 2026 (4 sur 20, petit volume). Un classement qui oublie cette ligne ne somme plus au total. Demandez-la toujours.
  2. Prendre le revenu de GA4 pour vos ventes. GA4 ne voit que ce que le tag a mesuré : pas les visiteurs qui refusent les cookies, pas les commandes hors site. L'écart avec la boutique est normal, et il se contrôle.
  3. Lire la journée en cours. Google le dit : les données se traitent à des intervalles différents, et celles de la journée continuent d'évoluer. Arrêtez vos comparaisons à hier.
  4. Faire moyenner des taux. Un taux de conversion moyen de cinq pages n'est pas celui des cinq pages. Demandez le numérateur et le dénominateur.
  5. Croire une ligne absente. Les seuils de données de GA4 masquent des lignes quand un rapport pourrait identifier quelqu'un. L'API rend ce que GA4 accepte de rendre. Une ligne qui manque n'est pas un zéro.

Ce que Kyras ne fait pas avec GA4

Kyras ne modifie rien dans votre propriété et ne pose aucun script : si votre tracking a des trous, il vous les montre, il ne les comble pas. Les quotas de votre propriété s'appliquent aussi à lui, et ses classements détaillés sont plafonnés. Pour une exploration libre de toutes les dimensions de GA4, le MCP de Google va plus loin.

Questions fréquentes

Les questions qui reviennent sur Google Analytics et Claude.

Google Analytics a-t-il un serveur MCP officiel ?

Oui. Google le publie sur GitHub sous le nom google-analytics-mcp et le documente sur son site pour développeurs. Il se lance avec le paquet analytics-mcp.

Le serveur MCP de Google Analytics est-il payant ?

Le code est ouvert, sous licence Apache 2.0. Il passe par l'API de données de GA4, dont les quotas s'appliquent à votre propriété. Votre abonnement à Claude reste à part.

Peut-on l'utiliser sur Claude.ai ?

Pas directement : il tourne en local, et un connecteur Claude.ai attend un serveur distant. Le dépôt décrit un mode HTTP avec OAuth, mais il faut l'héberger. Claude Desktop et Claude Code se configurent, eux, en local.

Le serveur peut-il modifier ma propriété GA4 ?

Par défaut, non : la documentation de Google le présente en lecture seule. Le dépôt décrit toutefois une option --allow-write, qui ajoute la création d'annotations, de dimensions personnalisées et d'événements clés, avec un droit d'édition en plus. Ne l'activez que si vous en avez besoin.

Quel rôle faut-il dans GA4 ?

Au moins le rôle Lecteur sur la propriété visée, pour le compte utilisateur ou le compte de service que vous utilisez.

Kyras remplace-t-il le MCP de Google ?

Non. Le MCP de Google est très bien pour explorer GA4 en profondeur. Kyras sert quand la réponse demande aussi vos ventes et vos dépenses publicitaires. Les deux se branchent dans le même Claude.

GA4 dans Claude, avec vos ventes en face.

Branchez une source : Kyras vous montre ses chiffres et répond à deux de vos questions avant que vous ne payiez.