Connecter Serge à votre
client LLM
Ce guide connecte Claude Desktop, Claude sur le web ou Cursor à votre espace de travail Serge via MCP. Choisissez une méthode d'authentification, configurez le client, vérifiez la connexion et posez votre première question sur votre trafic d'assistants IA mesuré.
Un espace de travail Serge avec au moins un site enregistré, et un client LLM qui parle MCP (Claude Desktop, Claude sur le web ou Cursor).
Tous les clients se connectent à https://mcp.serge.ai.
Poser des questions ponctuelles sur votre trafic d'assistants IA sans cliquer à travers les filtres du tableau de bord.
Choisir comment s'authentifier
Choisissez l'une des deux méthodes. Vous n'avez pas besoin des deux.
Générez une clé dans Paramètres → Clés API (elle commence par sk_serge_) avec le scope traffic:read. Idéal pour Claude Desktop et Cursor, où la clé vit dans un fichier de configuration.
Ajoutez https://mcp.serge.ai comme connecteur dans Claude et connectez-vous avec votre compte Serge. Idéal si vous préférez vous connecter plutôt que gérer une clé, ou si vous êtes sur Claude web.
Configurer votre client
Ouvrez votre fichier de configuration Claude Desktop (Cursor utilise le même format JSON dans ses paramètres MCP) :
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonAjoutez Serge sous l'objet mcpServers. Remplacez le placeholder par votre clé sk_serge_ :
Vous utilisez OAuth à la place ? Ignorez le fichier de configuration : dans Claude, ouvrez les paramètres de connecteur, ajoutez https://mcp.serge.ai et terminez la connexion.
Redémarrer et vérifier la connexion
Redémarrez votre client pour qu'il charge le nouveau serveur. Les outils Serge devraient apparaître dans le sélecteur d'outils.
Confirmez que la connexion est liée au bon espace de travail en demandant à votre client d'appeler whoami :
Il renvoie votre espace de travail et les scopes de la clé. Si les scopes manquent, générez une nouvelle clé avec le scope traffic:read.
Poser votre première question
Utilisez le langage naturel. Votre client associe la question au bon outil et complète la période et le domaine.
Si un outil répond site_not_found, demandez à votre client d'appeler list_sites et utilisez un domaine qu'il renvoie.
Ce que vous pouvez demander
Plus d'exemples de prompts
Sur quelles pages d'entrée les assistants IA atterrissent-ils le plus sur yourstore.com ?
Guide-moi page par page à travers une session en échec sur yourstore.com.
Compare le trafic d'intention d'achat sur yourstore.com sur les 7 derniers jours par rapport aux 30 derniers.
Quelles sessions se sont déclarées comme ChatGPT sans jamais le vérifier cryptographiquement ?
Transformer les constatations en correctifs
Quand un parcours de session révèle un décrochage — une page où les visites portées par des assistants calent systématiquement —, collez-le dans Claude, Cursor ou votre agent de codage avec un prompt comme celui-ci :