La connexion GA4 de Claude Code aide les développeurs à déterminer si l'instrumentation des événements correspond aux données atteignant Analytics. Il ajoute des outils de reporting à une session de codage sans nécessiter les informations d'identification Google dans le référentiel. Utilisez-le pour vérifier un contrat d'événement, puis décidez si la tâche suivante appartient à la configuration code, Tag Manager ou GA4.
De quoi avez-vous besoin avant de vous connecter ?
Utilisez Claude Code installé sur l'ordinateur sur lequel vous exécuterez ces commandes. Son CLI prend en charge les serveurs distants HTTP MCP et le navigateur OAuth. Cette route enregistre un serveur explicite à l'échelle de l'utilisateur à utiliser dans vos projets ; la configuration d’une équipe à l’échelle d’un projet est un choix distinct. Vous n'avez pas besoin d'exécuter un serveur Google API local.
- Un identifiant Google avec accès à la propriété GA4 que vous souhaitez analyser.
- Un compte LoomaScale et une connexion Google Analytics ; la connexion de Google Ads seule n’autorise pas Analytics.
- L'identifiant numérique de la propriété ou l'autorisation de la découvrir à partir de la liste des comptes. Un ID de mesure G identifie un flux Web et n'est pas l'ID de propriété de rapport.
Comment connecter le Claude Code au GA4 ?
1. Connectez GA4 dans LoomaScale
Créez ou connectez-vous à votre compte LoomaScale, puis ouvrez Connexions. Choisissez Google Analytics, connectez-vous avec l'e-mail Google qui a accès aux données requises et vérifiez les autorisations demandées. La connexion à LoomaScale avec Google ne remplace pas la connexion à cette source de données. Vous pouvez connecter ce service sans connecter de compte publicitaire.
2. Enregistrez le serveur distant MCP dans Claude Code
Exécutez cette commande dans votre terminal système, en dehors d'une conversation Claude Code. La portée utilisateur rend la connexion disponible dans tous vos projets. L'URL sélectionne les outils de ce service Google.
claude mcp add --transport http --scope user loomascale-ga4 https://api.loomascale.com/mcp/ga4Si vous utilisez déjà le plugin d'agent LoomaScale complet, vérifiez ses outils avant d'ajouter une deuxième connexion. L'itinéraire du plugin est documenté dans le Guide de configuration Claude Code ; cet article utilise la configuration directe de MCP.
3. Authentifiez-vous à partir du menu MCP du Claude Code
Ouvrez Claude Code et entrez /mcp. Sélectionnez loomascale-ga4 et terminez son flux d'authentification dans le navigateur. Utilisez le compte LoomaScale avec votre source Google connectée. Revenez à Claude Code et confirmez que le serveur est connecté. Vous pouvez inspecter le serveur enregistré à partir du terminal système avec claude mcp get loomascale-ga4 ou claude mcp list. Une commande d'ajout réussie enregistre la configuration ; cela ne prouve pas que la recherche du compte Google a réussi.
4. Vérifiez l'accès avec une recherche de compte réelle
Utilisez LoomaScale pour appeler ga4_get_account_summaries. Répertoriez mes propriétés GA4 accessibles avec leurs noms et ID de propriété numériques. Demandez-moi quelle propriété utiliser. Lisez son fuseau horaire et sa devise de rapport. Ne modifiez aucun paramètre.
La réponse doit contenir les propriétés de votre propre connexion Google, avec une ressource telle que properties/123456789. Sélectionnez la propriété par nom et ID, puis conservez cette sélection dans les demandes ultérieures. Une description de GA4 ou un exemple de tableau de bord ne prouve pas que le connecteur a récupéré les données. Une liste de comptes vide peut être une réponse valide d'une connexion sans propriétés accessibles.
Comment vérifier un contrat événementiel avec Claude Code et GA4 ?
Commencez par un événement que vous pouvez identifier dans le référentiel, tel que generate_lead. Demandez à Claude Code d'enregistrer l'orthographe et les conditions dans lesquelles le site l'émet. Comparez ensuite ce contrat avec les noms d'événements observés et les décomptes récents de GA4. Un événement absent est une piste d’enquête et non une preuve automatique que le code n’a jamais été exécuté.
Utilisez LoomaScale avec la propriété GA4 que j'ai sélectionnée. Lisez l'instrumentation d'événements de formulaire principal de ce référentiel sans modifier de fichiers. Identifiez les noms des événements prévus et le moment où ils se déclenchent. Signalez eventCount par eventName pour les 7 derniers jours complets et vérifiez les noms attendus. Si cela est utile, interrogez les événements en temps réel séparément. Expliquez ce que le rapport vérifie et ce qui nécessite un test du navigateur. Ne créez pas d’événements et ne modifiez pas les paramètres.
Séparez une incompatibilité de nom d’événement d’un échec de collecte. Un événement récent peut être absent d'un rapport daté alors que le traitement est encore en cours ; un résultat en temps réel répond à une question de fenêtre temporelle différente. Vérifiez la propriété et le flux prévus avant de modifier le code. Si un test du navigateur est nécessaire, effectuez-le dans l'environnement de test approprié du site et vérifiez les requêtes réellement émises.
Quel point de terminaison MCP ce guide utilise-t-il ?
https://api.loomascale.com/mcp/ga4Le point de terminaison spécifique au service expose les outils GA4 et les assistants de compte LoomaScale. Le plugin ou connecteur de répertoire complet utilise https://api.loomascale.com/mcp et peut atteindre toutes les sources que vous connectez séparément. Choisissez la connexion complète pour travailler sur plusieurs services ; utilisez le point de terminaison spécifique lorsque vous souhaitez utiliser l'ensemble d'outils de cette source. Un choix de point de terminaison limite les outils exposés, et non les rôles Google détenus par votre connexion.
Que peut lire ou modifier Claude Code dans GA4 ?
LoomaScale peut récupérer des rapports sur le trafic, l'engagement, les événements clés, les revenus, l'activité en temps réel et l'entonnoir. Commencez par créer des rapports et spécifiez les dates, les dimensions et les mesures. Les outils de configuration, lorsqu'ils sont activés pour votre compte, nécessitent le rôle Google et l'autorisation analytics.edit appropriés ; L'accès au rapport à lui seul n'autorise pas la modification. La connexion d'un assistant n'installe pas de balise de site Web, ne crée pas d'événements historiques et ne rend pas l'attribution GA4 identique à l'attribution d'une plateforme publicitaire.
Pourquoi la connexion ou les données sont-elles manquantes ?
Si le serveur a besoin d'une authentification, ouvrez /mcp et reconnectez-vous. Si des outils sont manquants, vérifiez claude mcp list, le point de terminaison source et si une stratégie d'organisation restreint le serveur. Redémarrez la session après une modification de configuration si nécessaire. Un connecteur Web Claude et un serveur CLI explicite peuvent se chevaucher ; vérifiez les outils actifs avant d’ajouter des connexions en double.
Si la propriété est manquante, confirmez l'e-mail Google et l'accès à la propriété, puis vérifiez la connexion Analytics dans LoomaScale. Si un rapport est vide, vérifiez la propriété, les dates, les filtres et si le site envoie réellement des événements. Comparez les périodes équivalentes dans le fuseau horaire de la propriété. En cas d’incompatibilité de métriques, conservez les noms exacts des métriques et les définitions d’attribution avant de tirer des conclusions. Utilisez l'ID de propriété de reporting plutôt que l'identifiant G-stream.
Guides de connexion associés et références officielles
Utilisez GA4 dans un autre assistant
- Comment connecter ChatGPT à GA4
- Comment connecter Claude à GA4
- Comment connecter Codex à GA4
- Comment connecter Grok Build à GA4
Connectez une autre source Google à Claude Code
- Comment connecter Claude Code à GTM
- Comment connecter Claude Code à GSC
- Comment connecter Claude Code à GMC
Références de configuration officielles
- Claude Code MCP d'Anthropic, portées et guide d'authentification
- Référence d'ID de propriété GA4 de Google
Références de configuration vérifiées le 12 novembre 2026. Les étiquettes de menu et les politiques de l'espace de travail peuvent changer ; utilisez les instructions du fournisseur lié pour votre compte. Pour les flux de travail pris en charge par LoomaScale, consultez le centre de documentation.
