Serveur MCP · distant

Interrogez vos analytics
d'agents depuis Claude

Le serveur MCP Serge connecte votre client LLM — Claude Desktop, Claude sur le web ou Cursor — à votre espace de travail d'analytics d'agents Serge. Demandez en langage naturel quels agents IA ont visité votre boutique, quelle part de ce trafic était une vraie intention d'achat, et où les agents n'ont pas pu finaliser le paiement. Le serveur lit vos données ; il ne modifie rien.

Guide de connexionGitHubDocs API Scanner
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 d'analytics. Rien n'est écrit ni modifié.

Aller à
Huit outils d'analytics

Votre client obtient des outils pour consulter scans, 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 les scopes scans:read et 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

Huit 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_scan

Consulte le dernier scan d'un domaine — score global, verdict et un lien vers le rapport.

get_traffic_overview

Résume le trafic d'agents 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'agents 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. Accordez le minimum que la question nécessite.

scans:readLit les résultats de scan de vos domaines. Requis par get_scan.
traffic:readLit les analytics de trafic d'agents. Requis par les outils de trafic, d'intention, de vérification et de session.

Les scopes de replay existent en interne mais ne sont pas encore attribuables depuis le tableau de bord — bientôt disponible.

Exemples de prompts

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

Combien d'agents IA n'ont pas pu finaliser leur paiement sur yourstore.com cette semaine ?

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

laptop-x-15 est-il trouvable par les agents sur yourstore.com ? Montre-moi le dernier scan.

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 scans:read et 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 d'analytics d'agents que vous voyez dans le tableau de bord. C'est le moyen le plus rapide de poser une question ponctuelle sans cliquer à travers les filtres.

Quand vous voulez regarder un vrai agent tenter un achat sur votre boutique en production — et voir exactement où il échoue — c'est l'Agent Journey Test du produit hébergé. Le serveur MCP vous dit ce qui s'est passé ; le journey test vous montre pourquoi.

Suite

→ Ouvrir le guide de connexion étape par étape→ Ouvrir les docs API Scanner→ Exécuter le scanner public