Aller au contenu
Serveur MCP / Guide de connexion

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é.

Besoin

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).

Endpoint

Tous les clients se connectent à https://mcp.serge.ai.

Idéal pour

Poser des questions ponctuelles sur votre trafic d'assistants IA sans cliquer à travers les filtres du tableau de bord.

1

Choisir comment s'authentifier

Choisissez l'une des deux méthodes. Vous n'avez pas besoin des deux.

Clé API

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.

OAuth

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.

2

Configurer votre client

Ouvrez votre fichier de configuration Claude Desktop (Cursor utilise le même format JSON dans ses paramètres MCP) :

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

Ajoutez 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.

3

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.

4

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

Trafic« Combien d'assistants IA ont visité yourstore.com cette semaine, et quelles plateformes ? »
Intention d'achat« Quelle part du trafic d'assistants sur yourstore.com était une vraie intention d'achat par rapport aux crawlers ? »
Décrochages« Montre-moi les sessions qui ont rebondi sur yourstore.com, et où elles ont décroché. »
Vérification« Une plateforme a-t-elle vérifié cryptographiquement son identité sur yourstore.com la semaine dernière ? »

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 :

Étapes suivantes