Connecter GA4 à Claude Code en une commande
Claude Code
Connectez GA4 à Claude Code : lancez claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, tapez /mcp et connectez-vous à PaidSync.ai.
Claude Code accède alors à vos propriétés Google Analytics 4 via 26 outils : rapports, temps réel, événements clés, dimensions, audiences, liens Google Ads. Il demande avant chaque outil, et les écritures GA4 s'appliquent au premier appel, sans simulation.
Une commande. OAuth, sans clé. Gratuit : 100 tâches/mois, valeur $50, sans carte.
La commande
Claude Code parle aux serveurs MCP distants via Streamable HTTP. PaidSync en fait partie. Ajoutez-le une fois et le même terminal qui modifie votre code peut interroger et configurer vos propriétés GA4.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpPar défaut, cela enregistre le serveur pour le projet courant seulement. Ajoutez --scope user pour le rendre disponible dans tous les projets de votre machine.
Exécutez claude mcp list pour confirmer qu'il est là, puis lancez une session et tapez /mcp pour vous connecter.
Configuration en 5 étapes
1Inscrivez-vous sur paidsync.ai/signup
Cela prend 10 secondes. Connexion avec Google ou e-mail. Le forfait gratuit offre 100 tâches par mois à $0, sans carte.
2Connectez GA4 dans le tableau de bord PaidSync
Cliquez sur Connecter pour Google Analytics 4. GA4 s'autorise via Google OAuth, avec le compte Google qui a accès à vos propriétés. Il utilise la même connexion Google que Google Ads et demande les scopes analytics, analytics.edit et analytics.readonly.
Déjà dans Claude Code ? Demandez-lui d'exécuter connect_ga4. L'outil renvoie un lien OAuth à ouvrir dans votre navigateur.
3Choisissez la propriété sur laquelle Claude Code doit travailler
Dans une session, list_ga4_accounts et list_ga4_properties affichent chaque propriété que votre connexion peut atteindre. Nommez la propriété dans votre prompt, ou épinglez-la dans le CLAUDE.md de votre projet pour que chaque session l'utilise.
4Ajoutez PaidSync à Claude Code
Dans votre terminal, lancez :
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpDémarrez une session, tapez /mcp, choisissez paidsync et connectez-vous avec votre compte PaidSync dans la fenêtre du navigateur qui s'ouvre. Claude Code stocke le jeton OAuth pour vous. Aucune clé n'est collée nulle part.
Vous configurez pour une équipe ? Validez un .mcp.json à la racine du dépôt pour que chaque ingénieur ait le même connecteur :
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}Vous préférez une clé API, par exemple pour des exécutions sans interface ? Envoyez-la dans un en-tête, jamais dans l'URL, où elle finirait dans les journaux :
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"Dans un .mcp.json validé, ajoutez "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } pour que la clé reste dans l'environnement de chaque ingénieur et n'entre jamais dans git. Appliquer un changement à Google Ads exige toujours la connexion OAuth. Sur les autres plateformes, une clé peut aussi appliquer des changements, donc traitez-la comme un mot de passe et préférez OAuth.
5Testez la connexion
Dans une session Claude Code, demandez : “Montre-moi les sessions et les événements clés par source et support sur les 28 derniers jours”
Claude Code exécute un rapport GA4 sur la propriété et renvoie le tableau. La connexion est active.
Le forfait gratuit comprend 100 tâches par mois. Pro à partir de $99 par mois, Team à partir de $249.
Prompts GA4 à essayer dans Claude Code
Chaque prompt ci-dessous correspond à des outils du groupe GA4 de PaidSync. Claude Code choisit l'outil. La dernière colonne indique si l'appel peut modifier quelque chose dans la propriété.
| Demande | Outils appelés | Modifie votre compte ? |
|---|---|---|
| “Liste mes propriétés GA4 et leurs flux de données” | list_ga4_properties, list_ga4_data_streams | Non |
| “Sessions et conversions par source et support, 28 derniers jours” | run_ga4_report | Non |
| “L'événement purchase se déclenche-t-il en ce moment ?” | run_ga4_realtime_report | Non |
| “Quels événements clés sont configurés, et Google Ads est-il lié ?” | list_ga4_conversion_events, list_ga4_google_ads_links | Non |
| “Quels événements de mesure améliorée sont activés pour le flux web ?” | get_ga4_enhanced_measurement | Non |
| “Marque generate_lead comme événement clé” | create_ga4_conversion_event | Oui, après votre confirmation |
| “Ajoute une dimension personnalisée pour le paramètre d'événement plan_tier” | create_ga4_custom_dimension | Oui, après votre confirmation |
| “Lie le compte Google Ads 123-456-7890 à cette propriété” | create_ga4_google_ads_link | Oui, après votre confirmation |
Exécuter sans interface avec claude -p
L'option -p lance Claude Code sans la session interactive. Connectez-vous une fois via /mcp et le jeton OAuth stocké est repris. Un rapport qui atterrit dans un fichier ressemble à ceci :
claude -p "Run a GA4 report for the last 7 days of sessions and key events by source and medium, and flag any source whose key events dropped against the week before." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/ga4-$(date +%F).jsonLes lectures s'exécutent directement, et les écritures aussi. --allowedTools "mcp__paidsync" autorise tous les outils PaidSync, écritures comprises, sans invite.
Pour une tâche sans surveillance, n'autorisez que les outils de lecture nécessaires, chacun par son nom sous la forme mcp__paidsync__tool_name.
Ce qui se lit et ce qui s'écrit
Sur les 26 outils GA4, 11 ne font que lire et 13 peuvent écrire.
Lire la suite
Les lectures et rapports couvrent les propriétés, flux de données, événements clés, dimensions et métriques personnalisées, audiences, liens Google Ads, mesure améliorée, rapports personnalisés via run_ga4_report et les 30 dernières minutes via run_ga4_realtime_report.
Les écritures modifient la configuration de la propriété : propriétés, flux de données, événements clés, dimensions et métriques personnalisées, audiences, mesure améliorée et liens Google Ads. Aucune écriture GA4 n'a de simulation. Chacune s'applique dès le premier appel, donc lisez les arguments dans l'invite de Claude Code avant de l'autoriser. Les suppressions exigent confirm_destructive.
Via MCP, l'étape d'approbation est l'invite propre à Claude Code. Il demande une confirmation avant d'exécuter un outil, sauf si vous l'avez autorisé avec --allowedTools ou dans vos paramètres. PaidSync ajoute des contrôles de son côté. Les suppressions, mises en pause et changements de budget exigent confirm_destructive, et un contrôle de règles avant écriture bloque les arguments dangereux. La carte d'approbation, et l'annulation sur une carte appliquée dont la modification a un inverse sûr, ne s'appliquent que dans l'espace de travail PaidSync.
Ajouter à ChatGPT : ouvrez PaidSync.ai dans l'annuaire des plugins de ChatGPT, installez-le, puis connectez-vous.
Ajouter à Claude : ouvrez PaidSync.ai dans l'annuaire des connecteurs de Claude, cliquez sur Connecter, puis connectez-vous.
Limites à connaître
- Un événement doit déjà se déclencher dans votre flux de données avant que
create_ga4_conversion_eventpuisse le marquer comme événement clé. - Les outils GA4 ne posent pas de balises sur votre site web. Les balises vivent dans Google Tag Manager, qui a sa propre configuration pour Claude Code.
setup_ga4_eventcrée une balise d'événement GA4 dans un espace de travail GTM, donc GTM doit aussi être connecté. - Supprimer un événement clé avec
delete_ga4_conversion_eventl'empêche d'être compté comme événement clé. GA4 continue de collecter l'événement lui-même. - Le rapport en temps réel ne couvre que les 30 dernières minutes. Utilisez
run_ga4_reportpour tout ce qui est plus ancien.
Questions fréquentes
Comment connecter GA4 à Claude Code ?
Inscrivez-vous sur paidsync.ai, connectez Google Analytics 4 dans le tableau de bord avec votre connexion Google, puis exécutez claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp dans votre terminal. Tapez /mcp dans une session, choisissez paidsync, et connectez-vous avec votre identifiant PaidSync.
Claude Code peut-il modifier ma configuration GA4 ?
Oui. Claude Code peut marquer des événements clés, ajouter des dimensions et métriques personnalisées, créer des audiences, modifier la mesure améliorée et lier Google Ads. Les écritures GA4 n'ont pas de simulation et s'appliquent dès le premier appel, donc l'invite de Claude Code est votre contrôle. Les suppressions exigent une confirmation explicite.
Claude Code peut-il vérifier que le suivi fonctionne ?
Oui. run_ga4_realtime_report montre les 30 dernières minutes, donc vous pouvez déclencher un événement test sur votre site et demander à Claude Code s'il est arrivé.
Cela fonctionne-t-il en mode sans interface avec claude -p ?
Oui. Une fois connecté via /mcp, claude -p réutilise le jeton OAuth stocké. Les lectures s'exécutent directement. Les écritures demandent de la prudence. Personne n'est là pour répondre à l'invite de Claude Code : tout outil d'écriture que vous avez autorisé avec --allowedTools s'exécute donc directement. Pour une tâche sans surveillance, n'autorisez que les outils de lecture nécessaires.
Est-ce gratuit ?
Oui. Le forfait gratuit coûte $0 pour 100 tâches par mois, sans carte. Pro démarre à $99 par mois et Team à $249 par mois.
26 outils GA4. Une commande dans Claude Code.