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 d'analytics d'agents Serge via MCP. Choisissez une méthode d'authentification, configurez le client, vérifiez la connexion et posez votre première question.

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'agents 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 les scopes scans:read et 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 scans:read et 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'agents IA ont visité yourstore.com cette semaine, et quelles plateformes ? »
Intention d'achat« Quelle part du trafic d'agents sur yourstore.com était une vraie intention d'achat par rapport aux crawlers ? »
Échecs« Montre-moi les sessions où des agents ont abandonné le paiement sur yourstore.com. »
Scan« Quel est le dernier score de scan pour yourstore.com, et que devrais-je corriger en premier ? »

Plus d'exemples de prompts

Sur quelles pages d'entrée les agents IA atterrissent-ils le plus sur yourstore.com ?

Une plateforme a-t-elle vérifié cryptographiquement son identité sur yourstore.com la semaine dernière ?

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.

Transformer les constatations en correctifs

Une fois qu'un parcours de session ou un scan révèle un blocage, collez-le dans Claude, Cursor ou votre agent de codage avec un prompt comme celui-ci :

Étapes suivantes