Aller au contenu
Serveur MCP · distant

Interrogez vos données
de mesure depuis Claude

Le serveur MCP Serge connecte Claude, Cursor ou une intégration backend à votre espace de travail. Neuf opérations lisent les données de mesure et d'installation. La seule écriture, create_site, enregistre un domaine de façon idempotente et ne réussit qu'avec une clé API dotée de sites:write.

Guide de connexionGitHubHub développeur
Aller à
Connectez en quelques minutes

Utilisez OAuth pour les questions en lecture seule, ou une clé API au scope précis pour la lecture ou le provisionnement de sites.

Aller à
Cadré par l'identifiant

Neuf opérations sont en lecture seule. Seul create_site écrit et exige une clé API avec sites:write.

Aller à
Dix outils ciblés

Neuf opérations de lecture couvrent l'installation et la mesure ; une opération idempotente enregistre un site.

Connecter votre client

Deux façons de s'authentifier. Choisissez-en une — vous n'avez pas besoin des deux.

Option A — Clé API

Générez une clé dans Paramètres → Clés API. Pour la mesure, accordez traffic:read. Pour le provisionnement AgentSolo, choisissez le préréglage qui accorde exactement sites:write + traffic:read.

Ajoutez ceci à la configuration de votre client. Le chemin de la configuration Claude Desktop est ci-dessous ; Cursor utilise le même format dans ses paramètres MCP.

macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json

Redémarrez votre client. Les outils Serge apparaissent dans le sélecteur d'outils.

Option B — Connecteur OAuth

Dans Claude, ajoutez https://mcp.serge.ai comme connecteur personnalisé et connectez-vous avec votre compte Serge. Claude déroule le flux OAuth et lie la connexion à votre espace de travail — aucune clé API à coller ou à faire tourner.

OAuth reste en lecture seule : il peut consulter les sites et les mesures, mais pas appeler create_site. Le provisionnement automatisé exige une clé API avec sites:write.

Outils que votre client reçoit

Dix outils cadrés sur l'espace de travail : neuf opérations de lecture et une écriture idempotente, create_site. Votre client choisit le bon selon la tâche.

list_sites

Liste les sites enregistrés sous votre espace de travail, avec leurs domaines et identifiants. Commencez ici si vous ne savez pas quel domaine un outil attend.

create_site

Enregistre le domaine d'un tenant et renvoie l'identifiant du site existant ou créé, son jeton public et le snippet prêt à coller. C'est le seul outil d'écriture ; les relances sont sûres et sites:write est requis.

check_install

Vérifie la télémétrie d'ingestion avec Origin correspondante. Un heartbeat confirme l'acceptation d'une requête, pas son exécution dans un navigateur ni la propriété ; les Origins rejetées sont des déclarations publiques non vérifiées.

get_traffic_overview

Résume le trafic d'assistants IA sur un site sur une période : sessions, plateformes (ChatGPT, Claude, Perplexity, Gemini), résultats et principales pages d'entrée.

get_purpose_split

Répartit les sessions d'assistants en trafic d'intention d'achat, informationnel et de crawler, pour distinguer la vraie demande client des bots.

get_traffic_sources

Répartit les sources d'acquisition issues des assistants IA et des marqueurs sur une période, avec le même instrument de session first-party de bout en bout.

get_verification_breakdown

Montre, par plateforme, combien de sessions ont été vérifiées soit par une signature de message HTTP valide, soit par une adresse IP source dans une plage publiée par le fournisseur, par rapport à celles qui se sont seulement déclarées.

find_failing_sessions

Liste les sessions classées comme abandonnées ou comme rebond court sur une seule page, avec les pages d'entrée/sortie et les durées. Ces libellés n'indiquent pas la cause et ne prouvent pas qu'une tâche a été tentée.

get_session_journey

Détaille une session — son parcours page par page, le temps par page, les interactions et le résultat.

whoami

Confirme à quel espace de travail et à quels scopes la connexion a accès. Appelez-le en premier quand un outil ne voit pas vos données.

Scopes

Une clé API porte des scopes explicites. Gardez les clés de provisionnement minimales ; leurs permissions sont fixées à la création et se modifient par rotation vers une clé de remplacement.

traffic:readAutorise les huit lectures d'installation et de mesure. whoami reste disponible sur toute connexion authentifiée.
sites:writeAutorise create_site à enregistrer des domaines dans cet espace. À n'accorder qu'à un service de provisionnement côté serveur de confiance.

OAuth n'accorde que des scopes de lecture. Il peut utiliser les neuf opérations de lecture, mais jamais create_site ; le provisionnement exige une clé API avec sites:write.

Exemples de prompts

Collez-les dans votre client connecté. Il associe chaque question au bon outil et complète le reste.

Quels assistants IA ont envoyé du trafic vers yourstore.com cette semaine ?

Quelle part du trafic d'assistants sur yourstore.com était une vraie intention d'achat par rapport aux crawlers sur les 7 derniers jours ?

Montre-moi les sessions sur yourstore.com classées comme abandonnées ou comme rebond court, avec leurs pages d'entrée et de sortie.

Quelles plateformes ont été vérifiées sur yourstore.com par une signature de message HTTP valide ou une plage d'IP source publiée par le fournisseur, et lesquelles se sont seulement déclarées ?

Dépannage

Un outil ne voit pas vos données

Demandez à votre client d'appeler whoami. Pour la mesure, traffic:read doit apparaître. Pour le provisionnement AgentSolo, sites:write et traffic:read doivent tous deux apparaître.

site_not_found

Le domaine n'est pas enregistré dans votre espace ou est écrit différemment. Une connexion en lecture seule appelle list_sites ; une clé de provisionnement peut appeler create_site, installer le snippet renvoyé, puis vérifier avec check_install.

Comment cela s'intègre avec Serge

Neuf opérations MCP lisent les mêmes données d'installation et de mesure que Serge. La dixième, create_site, est une opération de provisionnement précise pour les backends de confiance et exige son propre scope d'écriture.

Serge prend aujourd'hui en charge un seul parcours publicitaire accompagné : ChatGPT via votre propre compte OpenAI. Le serveur MCP expose vos données de mesure first-party distinctes, dont les sessions enregistrées et les marqueurs d'acquisition pris en charge ; il n'expose ni le rapport OpenAI ni l'état de la campagne.

Suite

→ Ouvrir le guide de connexion étape par étape→ Ouvrir le hub développeur