Join Médicis
Serveurs MCP

MCP Google Analytics

Serveur officiel publié par Google

Pose tes questions sur ton site en langage courant et ton IA va chercher la réponse dans Google Analytics 4 : trafic, sources, conversions, entonnoirs et temps réel.

  • Officiel
  • Gratuit (serveur open source, API Google Analytics sans frais)
  • Lecture seule
  • Installation : Avancé
  • 30 min
InstallerGuide officiel de Google ↗GitHub ↗

✓ Fiche vérifiée par Join Médicis le 13 octobre 2026, d'après la documentation officielle.

Comment ça marche

Un MCP est un pont entre ton IA et un outil. Ici, en trois temps :

  1. I

    Tu poses ta question : « Combien de visiteurs ai-je eu hier ? »

  2. II

    Ton IA appelle le serveur MCP, qui interroge les API Google Analytics à ta place.

  3. III

    Elle reçoit les chiffres et te répond en clair, avec l'analyse en prime.

Ce que tu peux lui demander

Copie une de ces demandes dans ta conversation une fois le MCP installé.

  • « À quelles propriétés Google Analytics ai-je accès ? »

    Le bon premier test : vérifie que la connexion marche.

  • « Combien de visiteurs ai-je eu hier sur ma propriété « mon-site » ? »

    Ton chiffre du matin, sans ouvrir GA4.

  • « D'où vient mon trafic ces 30 derniers jours ? Classe les sources par sessions et par conversions. »

    Repère les canaux qui rapportent vraiment.

  • « Quels sont les événements les plus fréquents sur ma propriété ces 180 derniers jours ? »

    Vérifie ce que ton site mesure réellement.

  • « Construis l'entonnoir accueil → ajout au panier → achat du mois dernier, ventilé par appareil. Où est-ce que je perds le plus de monde ? »

    Trouve l'étape qui fait fuir tes visiteurs.

  • « Quel est le ROAS de mes campagnes ce mois-ci, en attribution basée sur les données ? »

    Relie tes dépenses publicitaires à tes revenus.

  • « Combien de personnes sont sur mon site en ce moment, et sur quelles pages ? »

    Idéal pendant un lancement ou un live.

  • « J'ai 5 000 € par mois de budget marketing et je veux plus de chiffre d'affaires. Aide-moi à bâtir un plan à partir de mes données. »

    L'exemple donné par Google lui-même.

Ton IA a besoin de savoir quelle propriété interroger. Donne son nom ou son numéro (Administration → Paramètres de la propriété) : elle sait retrouver le numéro à partir du nom.

Avant de commencer

Il faut un projet Google Cloud, deux API à activer, des identifiants OAuth et quelques commandes à lancer. Compte 30 à 45 minutes la première fois, ou demande un coup de main à un développeur.

  • Un accès à une propriété Google Analytics 4

    Avec le compte Google que tu utiliseras pour te connecter. Un accès en lecture suffit.

  • Un projet Google Cloud avec deux API activées

    Google Analytics Admin API et Google Analytics Data API (console Google Cloud → Bibliothèque d'API).

  • Des identifiants OAuth

    Un client OAuth 2.0 de type application de bureau, téléchargé en fichier JSON, transformé en identifiants par défaut de l'application (ADC) avec l'outil gcloud.

  • Python 3.10 ou plus récent et pipx

    pipx lance le serveur sans rien installer à la main. Voir pipx.pypa.io pour l'installer sur ton ordinateur.

Installer, selon ton interface

Étape 0, commune à toutes les interfacesPréparer tes identifiants Google (une seule fois)

Cette étape est commune à toutes les interfaces. Elle crée un fichier d'identifiants que le serveur utilisera pour lire tes données, en lecture seule.

  1. 1

    Dans la console Google Cloud, active pour ton projet la Google Analytics Admin API et la Google Analytics Data API (Bibliothèque d'API → Activer).

  2. 2

    Crée un client OAuth (type application de bureau) et télécharge son fichier JSON.

  3. 3

    Installe l'outil gcloud, puis connecte-toi avec le périmètre de lecture Google Analytics (remplace le nom du fichier) :

    gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=TON_FICHIER_CLIENT.json
  4. 4

    Note le chemin affiché à la fin (« Credentials saved to file: … ») : tu en auras besoin à l'étape suivante, avec l'ID de ton projet Google Cloud.

Tu utilises quoi ?

Installer sur Claude Desktop

Sur ton ordinateur
  1. 1

    Termine la préparation des identifiants ci-dessus.

  2. 2

    Dans l'application Claude Desktop : Réglages → Développeur → Modifier la configuration.

  3. 3

    Colle ce bloc dans le fichier (remplace le chemin du fichier d'identifiants et l'ID de projet), puis enregistre :

    {
  "mcpServers": {
    "analytics-mcp": {
      "command": "pipx",
      "args": ["run", "analytics-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/chemin/vers/credentials.json",
        "GOOGLE_PROJECT_ID": "TON_ID_DE_PROJET"
      }
    }
  }
}
  4. 4

    Quitte complètement Claude Desktop et relance-le.

C'est bon si… « analytics-mcp » apparaît dans la liste des outils de la conversation. Demande : « À quelles propriétés Google Analytics ai-je accès ? »

Ce que ton IA peut faire avec

  • Lecture

    Lister tes comptes et propriétés

    Retrouve les comptes et propriétés GA4 auxquels tu as accès, avec leurs détails et leurs liens Google Ads.

  • Lecture

    Faire des rapports

    Trafic, sources, pages, événements, revenus… sur la période de ton choix, avec filtres, tris et comparaisons. L'IA choisit les bonnes dimensions et métriques pour toi.

  • Lecture

    Analyser un entonnoir

    Mesure le passage d'une étape à l'autre (visite, ajout au panier, achat), avec ventilation par appareil ou pays.

  • Lecture

    Mesurer conversions et ROAS

    Coût publicitaire, conversions et retour sur dépense par campagne ou canal, en attribution basée sur les données ou au dernier clic.

  • Lecture

    Suivre le temps réel

    Qui est sur ton site en ce moment, d'où il vient et ce qu'il regarde.

  • Lecture

    Lire tes annotations

    Récupère les notes datées de ta propriété (lancement, campagne, incident) pour expliquer un pic ou une chute.

Ce qu'il ne fait pas

  • Il ne modifie rien : pas de création d'événement clé, de dimension personnalisée ni de changement de configuration.
  • Il ne voit que les propriétés GA4 auxquelles ton compte Google a déjà accès.
  • Google le présente comme expérimental : les outils peuvent changer d'une version à l'autre.
  • Les rapports consomment le quota de l'API Data de ta propriété : sur une très grosse analyse, mieux vaut découper les questions.

Les outils du serveur

9 outils et ressources, que ton IA découvre et appelle toute seule.

  • Comptes et propriétés (4)

    • get_account_summariesListe les comptes et propriétés Google Analytics accessibles.
    • get_property_detailsRenvoie les détails d'une propriété (fuseau horaire, devise, secteur…).
    • list_google_ads_linksListe les comptes Google Ads liés à une propriété.
    • list_property_annotationsListe les annotations datées de la propriété.

  • Rapports (4)

    • run_reportLance un rapport : dimensions, métriques, périodes, filtres et tris.
    • run_funnel_reportLance un rapport d'entonnoir, avec ventilation et analyse de l'action suivante.
    • run_conversions_reportLance un rapport de conversions : coûts publicitaires, conversions, ROAS et modèle d'attribution.
    • run_realtime_reportLance un rapport en temps réel.

  • Métadonnées (1)

    • get_custom_dimensions_and_metricsListe les dimensions et métriques personnalisées de la propriété.

Le README officiel n'en liste que 7 : les annotations et le rapport de conversions, ajoutés en 2026, apparaissent dans le code du serveur. Les entonnoirs et les conversions passent par une version alpha de l'API Data, susceptible d'évoluer.

Sécurité et données

  • Lecture seule : le serveur demande uniquement le périmètre analytics.readonly et ne peut rien modifier dans tes propriétés.
  • Les données récupérées sont transmises à l'IA que tu connectes (Claude, ChatGPT…) : vérifie ses règles de confidentialité avant d'y brancher des propriétés clients.
  • Garde ton fichier d'identifiants hors des dossiers partagés ou synchronisés, et ne le publie jamais sur GitHub.
  • Tu peux révoquer l'accès à tout moment depuis les autorisations de ton compte Google.

Ça ne marche pas ?

Le serveur n'apparaît pas dans mon IA

Vérifie que pipx est installé, que le fichier de configuration est un JSON valide (virgules, accolades), puis quitte et relance complètement l'application.

Erreur d'autorisation ou « permission denied »

Tes identifiants doivent inclure le périmètre https://www.googleapis.com/auth/analytics.readonly, et les deux API (Admin et Data) doivent être activées dans le projet. Relance la commande gcloud de la préparation.

Sous Windows, les réponses prennent plusieurs minutes ou n'arrivent jamais

Un blocage connu sous Windows a été corrigé en version 0.6.0. Si tu as une version plus ancienne en cache, lance une fois « pipx run --no-cache analytics-mcp » dans un terminal, puis relance ton application.

Sur Mac avec Claude Code : « Failed to resolve analyticsadmin.googleapis.com »

Contournement signalé par la communauté (pas encore de correctif officiel) : ajoute GRPC_DNS_RESOLVER=native aux variables d'environnement du serveur, par exemple avec -e "GRPC_DNS_RESOLVER=native" dans la commande claude mcp add.

L'IA ne trouve pas la bonne propriété

Donne le nom exact de la propriété ou son numéro (Administration → Paramètres de la propriété) directement dans ta question.

Toujours bloqué ? Tutoriel vidéo d'installation (Google) · Présentation vidéo du serveur (Google) · Signaler un bug (GitHub) · Discord Google Analytics · #🤖-analytics-mcp

MCP Google Analytics : questions fréquentes

Le MCP Google Analytics peut-il modifier ma configuration GA4 ?

Non. Google le précise : le serveur ne traite que des demandes de lecture. Il ne peut ni créer d'événement clé, ni changer une dimension personnalisée, ni toucher aux paramètres de ta propriété.

Est-ce que c'est gratuit ?

Oui. Le serveur est open source et publié par Google, et les API Google Analytics ne sont pas facturées. Tu paies seulement ton abonnement à l'IA que tu utilises.

Fonctionne-t-il avec Universal Analytics ?

Non. Il s'appuie sur les API Admin et Data de Google Analytics 4 : il ne lit que des propriétés GA4.

Pourquoi ça ne marche pas sur Claude.ai ou ChatGPT dans le navigateur ?

Le serveur tourne uniquement sur ton ordinateur, et Google n'en propose pas de version hébergée. Claude Desktop, Claude Code, Gemini CLI, Codex, Cursor ou VS Code peuvent le lancer eux-mêmes ; les versions web ne peuvent se connecter qu'à un serveur accessible par une URL publique, qu'un développeur doit mettre en place.

Mes données Google Analytics sont-elles partagées ?

Elles sont transmises à l'IA que tu connectes, le temps de répondre à ta question. Join Médicis ne voit rien : tout se passe entre ton ordinateur, Google et ton IA. Vérifie les règles de confidentialité de ton IA avant d'y connecter des propriétés clients.

Une erreur, un lien cassé, un souci de sécurité ? Dis-le-nous, on corrige.