Connecter un agent au serveur MCP

Le résultat : ton agent de code cherche dans ta doc avant de répondre à une question sur ton produit.

Avant de commencer : un projet dans la console, avec un site synchronisé (état À jour).

Chaque projet a un serveur MCP en lecture seule. Son adresse est dans l’aperçu du projet, avec les lignes de configuration déjà remplies :

https://docs.hgdc.ch/mcp/<identifiant du projet>

Claude Code

Dans un terminal, à la racine de ton projet :

claude mcp add --transport http documentation-acme https://docs.hgdc.ch/mcp/<identifiant du projet>

Cursor

Dans .cursor/mcp.json (pour un projet) ou ~/.cursor/mcp.json (pour tous les projets) :

{ "mcpServers": { "documentation-acme": { "url": "https://docs.hgdc.ch/mcp/<identifiant du projet>" } } }

VS Code

Dans .vscode/mcp.json :

{ "servers": { "documentation-acme": { "type": "http", "url": "https://docs.hgdc.ch/mcp/<identifiant du projet>" } } }

Le nom du serveur dérive du nom de la doc : « Documentation Acme » donne documentation-acme. L’aperçu du projet propose la ligne exacte pour chaque client.

Ce que l’agent peut faire

Le serveur propose trois outils :

• search_docs : cherche dans la doc et rend les passages les plus proches, avec l’adresse de chaque section.
• get_page : rend une page complète en Markdown, à partir de son chemin.
• list_pages : liste les pages publiées, avec leur titre et leur chemin.

Le serveur ne fait que chercher et lire ce que ton site publie. Il n’appelle pas le modèle qui rédige les réponses, et il reste disponible même si l’assistant du site est coupé. Le détail du protocole est dans la référence du serveur MCP.

Si ça ne marche pas

• Projet inconnu : l’identifiant de l’adresse ne correspond à aucun projet. Recopie-le depuis l’aperçu.
• Passe par https://docs.hgdc.ch/mcp/ : l’adresse n’est pas celle du serveur. Utilise celle de l’aperçu du projet.
• Trop de requêtes, réessaie dans une minute : la limite par minute est atteinte, côté projet ou côté client. Attends une minute.
• Le serveur répond « Projet inconnu » alors que l’identifiant est bon : vérifie que la doc n’a pas été supprimée et recréée. Chaque création donne un nouvel identifiant.