Comment interroger Google Analytics 4 avec Claude / Curseur via MCP (Configuration du serveur Google Analytics MCP)

Voir tout ce que les Query Streams peuvent faire au-delà de ce guide Commencer gratuitement

Soutien

+Plus d'informations

Données en direct

Remplacer les exportations par du SQL à la demande

Excel Feuilles

BI & AI Analytics

Demandez à Nova, obtenez SQL + des graphiques

Rencontre avec Nova

API REST de base de données

Une clé par partenaire. Aucun identifiant partagé.

Créer une API

+Plus d'informations

Automatisation

Synchronisation programmée sur plus de 6 plateformes

Explorer

+Plus d'informations

API à SQL

Interroger les API avec SQL, sans code

Explorer

+Plus d'informations

Base de données IA MCP

Claude, Cursor, ChatGPT et Grok interagissent avec vos données.

Connecter l'IA

Query Streams est une plateforme d'intégration de données sécurisée et en temps réel qui intègre toutes les bases de données et API SaaS de votre compte dans Claude, Cursor, ChatGPT et Grok, grâce à une seule clé MCP et sans modification du pare-feu. Ce guide MCP de Google Analytics explique en détail comment connecter le connecteur Google Analytics 4, afin que votre outil d'IA puisse répondre à des questions en langage clair sur les pages vues, les sessions, les sources de trafic et les conversions sans que vous ayez à exporter de rapports CSV depuis l'interface utilisateur Web de GA4. Pour en savoir plus, rendez-vous sur QueryStreams.com. et Inscrivez-vous gratuitement pour commencer à poser à votre outil d'IA de véritables questions d'analyse marketing.

Que vous offre le serveur MCP de Query Streams pour Google Analytics ?

D'autres serveurs « Google Analytics MCP » open source connectent l'outil d'IA directement à l'API de données GA4. Cette solution fonctionne, mais elle impose l'utilisation d'un jeton OAuth Google dans la configuration de votre client d'IA, limite l'outil d'IA à Analytics et ne fournit aucun historique des requêtes effectuées par l'IA. Le serveur Query Streams Google Analytics MCP résout un problème plus global : une seule clé pour tous les connecteurs, un historique complet et l'outil d'IA ne conserve jamais vos identifiants Google. L'agent met en cache chaque propriété GA4 dans un fichier DuckDB local, permettant ainsi au LLM d'accéder aux véritables surfaces SQL (tables, colonnes, jointures, types sémantiques) au lieu des points de terminaison REST aux noms de dimensions et de métriques opaques.

Comment fonctionne le serveur MCP de Google Analytics sans ouvrir les ports du pare-feu

L'agent réseau Query Streams est un petit programme à installer une seule fois sur une machine pouvant accéder à l'API de données Google Analytics (ordinateur portable, serveur ou machine virtuelle cloud). Il établit une connexion TLS sortante vers le cloud Query Streams et attend les requêtes de l'outil. Lorsque Claude ou Cursor pose une question, le cloud la transmet à l'agent, qui appelle l'API de données GA4. L'agent met en cache la réponse dans une base de données DuckDB locale afin que l'IA puisse exécuter des requêtes SQL, puis le résultat est renvoyé via le même canal sortant. Aucune donnée n'est transmise en entrée. Aucune donnée n'est exposée. L'outil d'IA n'a jamais accès à votre jeton OAuth Google et le serveur GA4 MCP ne stocke jamais directement vos identifiants ; c'est l'agent, sur votre réseau, qui les conserve.

La touche MCP que vous donnez à Cursor ou Claude est limitée (lire / analyser / exécuter), révocable à tout moment et limitée en nombre d'utilisations par clé. L'outil d'IA fait appel à ces outils MCP pour fonctionner :

Pourquoi l'intelligence schématique rend le serveur GA4 MCP différent

La plupart des serveurs « MCP pour X » de l'écosystème open source fournissent à votre outil d'IA les mêmes informations. schéma_information Votre base de données est livrée à un étranger. Noms de colonnes. Types de données. Peut-être une clé primaire. Pour Google Analytics 4 en particulier, le tableau est encore plus sombre : un serveur GA4 MCP classique renvoie une liste plate de noms de dimensions et de métriques GA4, l’IA doit deviner quelles métriques sont cumulables et lesquelles sont moyennées, et ignore totalement que… taux d'engagement est stocké sous forme décimale (0-1) plutôt qu'en pourcentage, et n'a aucune idée que date_de_l'événement est un entier au format AAAAMMJJ plutôt qu'une véritable requête SQL DATEC’est pourquoi la première requête SQL que la plupart des LLM écrivent sur un schéma GA4 nu (qu’il soit renvoyé par un MCP GA4 générique ou par une bibliothèque MCP GA4 générique) est erronée du premier coup. Ce n’est pas que le LLM soit mauvais, c’est qu’il ne dispose pas des données nécessaires pour fonctionner correctement.

Le serveur Query Streams MCP renvoie ce même schéma enrichi de ce que nous appelons Intelligence schématique (IS) — Métadonnées organisées par l'IA générées en exécutant des requêtes de profilage sur votre vrai Les données GA4 sont collectées avant même que le client IA ne les demande. Lorsque l'intégration de schémas est activée sur un connecteur, chaque outil de schéma appelé par l'IA (qs_get_connector_schema, qs_get_table_schema, table de profils qs, qs_get_relationships) renvoie le schéma de base ainsi que six couches de connaissances spécialisées. Le LLM cesse ainsi de deviner les noms d'événements, les sources de trafic, les catégories d'appareils, les dimensions personnalisées et la colonne de date encodée en entier.

Pour concrétiser cela, voici ce que le client IA récupère d'une seule requête. qs_get_table_schema appel contre le connecteur GA4 ga4_événements tableau — d'abord sans Schema Intelligence, puis avec.

Les six couches de l'intelligence schématique ajoutent

Chaque couche traite d'une catégorie spécifique de questions auxquelles le LLM devrait autrement répondre par supposition, et SI fonctionne comme une passe de profilage optionnelle en lecture seule qui ne modifie jamais votre schéma. En savoir plus sur la génération de l'intelligence schématique →

Même invite de commande, requête SQL différente

La preuve se trouve dans le code SQL que l'outil d'IA écrit réellement. Même session Cursor, même modèle Claude, même invite. « Montrez-moi mes 10 meilleures pages de destination en termes d'engagement le mois dernier, celles qui ont enregistré plus de 100 vues. » Sans l'intelligence schématique, le LLM doit deviner. Avec elle, il sait.

MCP ne vous convient pas ? Essayez plutôt Nova AI.

Évitez complètement MCP : Nova AI est intégré directement au portail web Query Streams, vous pouvez donc vous connecter et poser les mêmes questions GA4 en langage clair — «Quelle est l'évolution de notre taux de rebond au cours des 90 derniers jours ?" ou "Quelles catégories de contenu génèrent le plus d'inscriptions ?— sans fichiers de configuration et sans aucun câblage.

Découvrez Nova AI

Conditions préalables

Avant de commencer, assurez-vous d'avoir :

1. Un compte Query Streams gratuit sur mon.querystreams.com.
2. L'agent réseau Query Streams installé sur une machine ayant accès à Internet — voir Téléchargez l'agent Query Streams.
3. Un connecteur Google Analytics 4 configuré avec l'agent — voir l'existant Configuration du connecteur API Guides pour l'appairage OAuth. L'agent détient le jeton OAuth de Google ; l'outil d'IA n'y a jamais accès.
4. Tout client d'IA compatible MCP. Ce guide présente Cursor, Claude Desktop, ChatGPT et Grok ; si vous utilisez Windsurf, Zed, Continue, Cline, VS Code Copilot, Codex ou Goose, la configuration reste globalement la même.
5. Cinq minutes.

Étape 1 : Générer une clé MCP Google Analytics dans Query Streams

Connectez-vous à Query Streams et ouvrez le page MCP (ou connectez-vous d'abord à mon.querystreams.com et cliquez MCP (dans le menu de navigation de gauche). La même clé MCP Google Analytics est utilisée pour tous les connecteurs de votre compte (et pas seulement pour GA4), vous n'en générez donc qu'une seule. Cliquez Générer une clé, donnez à la clé un nom reconnaissable (quelque chose comme curseur-ordinateur portable ou bureau de Claude), et choisissez les portées que vous souhaitez associer à cette clé :

• lire — L'IA peut parcourir les connecteurs et lire les schémas. Indispensable pour tout le reste.
• analyser L'IA peut profiler les tables et découvrir les relations (valeurs d'échantillon, distributions, types sémantiques). Cette fonctionnalité est optionnelle, mais fortement recommandée pour les analyses, car il est essentiel de comprendre la structure des données d'événements.
• exécuter — L'IA peut effectivement exécuter des requêtes SQL. Sans cela, elle ne peut lire que les métadonnées du schéma.

Pour un flux de travail classique du type « laisser Claude analyser mes données Google Analytics », les trois niveaux de portée conviennent. En revanche, pour une donnée clé que vous confiez à un collègue ou à un client moins digne de confiance, supprimez-en un. exécuter et autorisez-les uniquement à consulter. Vous pouvez révoquer n'importe quelle clé à tout moment depuis cette même page ; le client IA le verra. CLÉ_MCP_RÉVOQUÉE Lors de son prochain appel, le fonctionnement s'arrête immédiatement. Il n'y a pas de délai de propagation.

Copiez la clé maintenant : Query Streams l’affiche une seule fois, puis ne conserve qu’un hachage. Si vous la perdez, générez-en une nouvelle. La clé ressemble à ceci : qsmcp_ suivi de 48 caractères aléatoires, ce que votre client IA envoie dans le Clé X-MCP En-tête de requête.

Étape 2 : Ajoutez Query Streams MCP à votre client d’IA

La configuration est identique pour tous les clients compatibles MCP : une entrée de serveur MCP pointant vers https://mcp.querystreams.com avec votre clé dans le Clé X-MCP En-tête. Choisissez votre client ci-dessous.

Curseur ~/.cursor/mcp.json

// Modifier ~/.cursor/mcp.json
{
  "mcpServers": {
    "flux de requêtes": {
      "url": "https://mcp.querystreams.com",
      "en-têtes": {
        "Clé X-MCP": "qsmcp_CLÉ_PASSER_ICI"
      }
    }
  }
}

Claude Desktop claude_desktop_config.json

// Paramètres → Développeur → Modifier la configuration
{
  "mcpServers": {
    "flux de requêtes": {
      "url": "https://mcp.querystreams.com",
      "en-têtes": {
        "Clé X-MCP": "qsmcp_CLÉ_PASSER_ICI"
      }
    }
  }
}

ChatGPT Applications et connecteurs

// Paramètres → Applications et connecteurs → Ajouter un MCP
URL du serveur  https://mcp.querystreams.com
En-tête d'authentification Clé X-MCP
Valeur d'en-tête qsmcp_COLLER_LA_CLÉ_ICI

Nécessite un abonnement ChatGPT payant
// (Plus / Pro / Team / Enterprise).

Grok Outils MCP distants

// Grok → Paramètres → Outils
{
  "mcp_servers": [{
    "nom": "flux de requêtes",
    "url": "https://mcp.querystreams.com",
    "auth_header": "Clé X-MCP",
    "auth_value": "qsmcp_..."
  }]
}

Redémarrez votre client IA. Au prochain démarrage, il détectera les huit outils Query Streams MCP mentionnés ci-dessus et les affichera dans sa palette d'outils. Dans Cursor et Claude Desktop, vous pouvez le vérifier en saisissant : « liste des connecteurs » — l'IA devrait appeler qs_list_connectors et renvoyez votre connecteur Google Analytics 4 ainsi que tout autre élément que vous avez configuré.

Étape 3 : Poser une question à l’IA sur Google Analytics 4

Vous n'écrivez pas de SQL : c'est l'IA qui s'en charge. Vous posez une question, l'IA choisit l'outil MCP approprié, l'agent exécute la requête sur vos données GA4 mises en cache et la réponse est renvoyée sous forme de texte et de tableaux. Voici trois exemples de requêtes à tester :

Lors du premier appel à un outil par l'IA, votre client peut afficher une fenêtre de confirmation vous demandant d'approuver cet appel. Il s'agit du flux de consentement standard de MCP, et non d'une fonctionnalité ajoutée par Query Streams. Une fois l'approbation donnée, l'IA poursuivra la conversation sans problème. Vous pouvez modifier ce consentement à tout moment dans les paramètres de votre client.

Foire aux questions

Commencer

Guides associés : Téléchargez l'agent Query Streams | Configuration du connecteur API | Tous les guides du serveur MCP | Nova AI text-to-SQL

Catégorie : Serveur MCP

Mots-clés : mcp, claude, curseur, chatgpt, grok, google-analytics, ga4, web-analytics, marketing-analytics, api-connector, ai

Description : Connectez Claude ou Cursor à Google Analytics 4 via MCP. Interrogez les données GA4 avec l’IA en langage naturel. Gratuit.