Aller au contenu
Serveur MCP · distant

Interrogez vos données
de mesure depuis Claude

Le serveur MCP Serge connecte votre client LLM — Claude Desktop, Claude sur le web ou Cursor — à votre espace de travail Serge. Demandez en langage naturel quels assistants IA ont envoyé du trafic vers votre site, quelle part de ce trafic était une vraie intention d'achat, et où les sessions ont décroché. Le serveur lit vos données de mesure ; il ne modifie rien.

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

Générez une clé API ou ajoutez le connecteur, pointez votre client vers mcp.serge.ai et posez votre première question.

Aller à
En lecture seule, cadré

Les outils sont cadrés sur votre espace de travail et lisent vos données de mesure. Rien n'est écrit ni modifié.

Aller à
Sept outils de mesure

Votre client obtient des outils pour consulter sites, trafic, répartition d'intention d'achat, vérification et sessions en échec.

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é API dans Paramètres → Clés API. Elle commence par sk_serge_. Accordez-lui le scope 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.

Utilisez ceci si vous préférez vous connecter plutôt que gérer une clé, ou si vous vous connectez depuis Claude sur le web.

Outils que votre client reçoit

Sept outils en lecture seule, tous cadrés sur votre espace de travail. Votre client choisit le bon selon votre question.

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.

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.

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_verification_breakdown

Montre, par plateforme, combien de sessions ont prouvé cryptographiquement leur identité par rapport à celles qui l'ont seulement déclarée.

find_failing_sessions

Liste les sessions qui ont abandonné une tâche ou rebondi, avec le motif d'échec et les pages d'entrée/sortie.

get_session_journey

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

Scopes

Une clé API porte des scopes qui décident des outils qu'elle peut appeler. Chaque outil de cette page n'en nécessite qu'un seul.

traffic:readLit les données de mesure de votre trafic d'assistants IA. Requis par chaque outil : trafic, répartition d'intention, vérification et sessions.

D'autres clés de scope restent attribuables sur les anciennes clés pour la compatibilité des données, mais aucun outil actif ne les requiert — traffic:read couvre tout ce qui figure sur cette page.

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 qui ont rebondi, et où elles ont décroché.

Quelles plateformes ont vérifié cryptographiquement leur identité sur yourstore.com, et lesquelles l'ont seulement déclarée ?

Dépannage

Un outil ne voit pas vos données

Demandez à votre client d'appeler whoami. Il renvoie l'espace de travail et les scopes de la connexion — si les scopes manquent, générez une clé avec le scope traffic:read.

site_not_found

Le domaine n'est pas enregistré sous votre espace de travail, ou vous l'avez écrit différemment. Demandez à votre client d'appeler list_sites et utilisez un domaine qu'il renvoie.

Comment cela s'intègre avec Serge

Le serveur MCP est une surface de lecture sur les mêmes données de mesure que vous voyez dans le tableau de bord Serge. C'est le moyen le plus rapide de poser une question ponctuelle sans cliquer à travers les filtres.

Serge place vos publicités sur les assistants IA — en commençant par ChatGPT — et trace chaque clic jusqu'à son résultat sur votre site. C'est cette couche de mesure que le serveur MCP expose : les sessions derrière les chiffres, la répartition d'intention d'achat et les parcours où les visites ont décroché.

Suite

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