Serveur MCP — Documentation pour assistants IA

Chaque page de cette section Documentation est aussi directement accessible à votre assistant de code IA : Claude Code, Cursor, VS Code avec GitHub Copilot Chat, Claude Desktop, Windsurf, ou tout autre outil parlant le Model Context Protocol (MCP). Pointez-le vers une seule URL et il pourra consulter lui-même les détails d'installation, de configuration, de personnalisation et de licence, plutôt que vous n'ayez à copier-coller la documentation dans le chat, ou qu'il ne devine (et se trompe parfois).

Qu'est-ce que le MCP, en termes simples ?

MCP (Model Context Protocol) est une norme ouverte qui permet à un assistant IA d'appeler des « outils » exposés par un serveur externe, de la même façon qu'il appelle déjà des outils comme un éditeur de fichiers ou un terminal. Un outil est simplement une fonction avec un nom, une description, et des entrées/sorties typées : l'assistant décide quand l'appeler selon ce que vous demandez. Ce serveur expose trois outils reposant sur le contenu réel et en direct de cette section Documentation (voir Outils exposés ci-dessous) : un pour lister chaque page de documentation, un pour récupérer une page précise en markdown, et un pour effectuer une recherche dans toutes les pages. Rien n'est installé sur votre machine : c'est un serveur distant avec lequel votre assistant communique en HTTP, de la même façon qu'un navigateur communique avec un site web.

Démarrage rapide

Le serveur se trouve à une seule URL. Chaque configuration ci-dessous revient simplement à « indiquer cette URL à votre assistant » :

URL du serveur: https://guidemyhair.com/mcp

Connecter votre assistant

Claude Code

Créez un fichier .mcp.json à la racine de votre projet (celui-ci est versionné dans git, toute l'équipe le récupère donc automatiquement en ouvrant le dépôt) :

{
  "mcpServers": {
    "guidemyhair-docs": {
      "url": "https://guidemyhair.com/mcp"
    }
  }
}

Ou ajoutez-le sans éditer de JSON à la main :

claude mcp add --transport http guidemyhair-docs https://guidemyhair.com/mcp

Cursor

Paramètres → Paramètres Cursor → MCP → « Ajouter un nouveau serveur MCP », ou créez directement .cursor/mcp.json (même forme que la configuration de Claude Code) :

{
  "mcpServers": {
    "guidemyhair-docs": {
      "url": "https://guidemyhair.com/mcp"
    }
  }
}

VS Code (GitHub Copilot Chat)

Palette de commandes → « MCP : Ajouter un serveur » → HTTP, ou créez directement .vscode/mcp.json. Notez que la forme diffère légèrement des autres : servers au lieu de mcpServers, et un champ type explicite :

{
  "servers": {
    "guidemyhair-docs": {
      "url": "https://guidemyhair.com/mcp",
      "type": "http"
    }
  }
}

Claude Desktop

Paramètres → Connecteurs → « Ajouter un connecteur personnalisé » → collez l'URL du serveur. C'est le chemin pris en charge pour un serveur HTTP distant comme celui-ci dans l'application de bureau : aucun fichier JSON à éditer.

Windsurf

Paramètres Windsurf → Cascade → Serveurs MCP → « Ajouter un serveur personnalisé », ou éditez directement ~/.codeium/windsurf/mcp_config.json (même forme mcpServers que Claude Code/Cursor).

{
  "mcpServers": {
    "guidemyhair-docs": {
      "url": "https://guidemyhair.com/mcp"
    }
  }
}

Tout autre client MCP

Tout client prenant en charge le transport HTTP en flux continu n'a besoin que de l'URL ci-dessus : il n'y a rien de spécifique à GuideMyHair dans la connexion elle-même, et aucune authentification n'est requise (c'est une documentation publique, en lecture seule).

Outils exposés

Exemples de requêtes

Une fois connecté, inutile de mentionner les outils par leur nom : posez simplement votre question normalement à votre assistant, il les utilisera si nécessaire :

• « Comment configurer le catalogue de nuances détaillé pour TreatmentConsultant ? »
• « Quelles propriétés CSS personnalisées puis-je surcharger pour personnaliser le widget ? »
• « Pourquoi mon widget affiche-t-il un filigrane, quelles raisons de licence déclenchent cela ? »
• « Cherche dans la documentation GuideMyHair tout ce qui concerne le slot d'en-tête »

Dépannage

Mon assistant ne semble pas l'utiliser

La plupart des outils listent les serveurs MCP connectés quelque part dans leurs paramètres/interface : vérifiez que guidemyhair-docs (ou le nom que vous lui avez donné) apparaît comme connecté, et que ses outils (list_docs, get_doc, search_docs) sont listés. Certains assistants n'activent les serveurs nouvellement ajoutés qu'après un redémarrage.

J'obtiens une erreur « Method not allowed » ou une erreur de connexion

Vérifiez que l'URL ne contient pas de faute de frappe et n'a pas de barre oblique finale ni de segment de chemin supplémentaire : elle doit être exactement https://guidemyhair.com/mcp.