Aller au contenu
Serveur MCP / Guide de connexion

Connecter Serge à votre
client LLM

Ce guide connecte Claude, Cursor ou une intégration backend à votre espace Serge via MCP. Choisissez OAuth en lecture seule ou une clé API aux scopes explicites, vérifiez l'espace et les permissions, puis consultez les mesures ou provisionnez un site.

Besoin

Un espace de travail Serge et un client MCP. La lecture utilise traffic:read ; le provisionnement automatisé de sites exige aussi une clé API avec sites:write.

Endpoint

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

Idéal pour

Mesurer en lecture seule dans Claude ou Cursor, et provisionner délibérément des sites de serveur à serveur avec une clé API.

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. Utilisez traffic:read pour la mesure. Pour le provisionnement AgentSolo, choisissez le préréglage avec exactement sites:write + traffic:read. Conservez la clé dans un coffre de secrets côté serveur.

OAuth

Ajoutez https://mcp.serge.ai comme connecteur dans Claude et connectez-vous avec votre compte Serge. OAuth reste en lecture seule : il peut consulter vos données, mais pas appeler create_site.

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 plutôt OAuth en lecture seule ? Ignorez le fichier de configuration : dans Claude, ajoutez https://mcp.serge.ai comme connecteur et connectez-vous. Le provisionnement exige toujours une clé API avec sites:write.

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 l'espace de travail et les scopes. La mesure exige traffic:read. Le provisionnement AgentSolo doit afficher exactement sites:write et traffic:read ; sinon, créez une clé de remplacement et effectuez une rotation sûre.

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, une connexion en lecture seule appelle list_sites. Avec une clé de provisionnement, appelez create_site, collez le snippet renvoyé dans le site du tenant, déployez, puis appelez check_install jusqu'à ce qu'il indique receiving.

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 ? »
Fins de session« Montre-moi les sessions sur yourstore.com classées comme abandonnées ou comme rebond court, avec leurs pages d'entrée et de sortie. »
Vérification« Une plateforme a-t-elle été vérifiée sur yourstore.com la semaine dernière par une signature de message HTTP valide ou une plage d'IP source publiée par le fournisseur ? »

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 dans une session abandonnée ou un rebond court sur yourstore.com, sans déduire pourquoi elle s'est terminée.

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 passer ni la vérification par signature valide ni celle par plage IP publiée ?

Transformer les signaux en investigation

Lorsque des parcours de session enregistrés se terminent plusieurs fois sur la même page, utilisez-les comme point de départ d'une investigation, pas comme diagnostic. Collez les éléments observés dans Claude, Cursor ou votre agent de codage avec un prompt comme celui-ci :

Étapes suivantes