Docsbook
Aperçu

Serveur MCP pour la documentation : ce que c’est et pourquoi il s’impose

Le Model Context Protocol (MCP) est le standard de connexion lancé par Anthropic fin 2024. À la mi-2026, il est pris en charge par Claude Code, Cursor, ChatGPT et une liste croissante d’agents. Pour la documentation, MCP transforme vos documents d’un contenu accessible uniquement via un site web en une interface programmable que les agents d’IA peuvent lire et utiliser.

Cet article explique ce qu’est MCP, quels outils un serveur MCP de documentation expose et comment Docsbook en fournit un.

En bref#

  • MCP = méthode standard permettant aux agents d’IA d’appeler des outils externes
  • Un serveur MCP de documentation expose des outils tels que get_analytics, update_branding, set_chat_hooks
  • Les agents découvrent les fonctionnalités, demandent une autorisation OAuth, puis appellent les outils dans le cadre de leur travail
  • Docsbook fournit un serveur MCP géré à l’adresse docsbook.io/api/mcp/server
  • Il s’agit désormais d’un canal de distribution d’IA principal — Mintlify a mesuré que les agents de codage IA représentaient 45,3 % des requêtes adressées aux sites de documentation qu’il hébergeait en mars 2026, Claude Code 25,2 % et Cursor 18,0 % (source)

Ce qu’est réellement MCP#

MCP est un protocole JSON-RPC superposé à HTTP (ou stdio). Un agent se connecte à un serveur MCP, demande « quels outils proposez-vous ? », reçoit un schéma typé et appelle les outils. L’authentification utilise OAuth 2.0 avec PKCE.

La manière la plus simple de le voir : une API REST + OAuth + un point de découverte + des outils plutôt que des ressources.

Pourquoi la documentation bénéficie de MCP#

Trois flux de travail :

1. Lire la documentation comme des données structurées#

Sans MCP, un agent récupère une page HTML, l’analyse et espère que sa structure est intacte. Avec markdown-lsp exécuté localement (npx markdown-lsp <subcommand> ./docs), l’agent analyse le graphe documentaire sur le disque et reçoit du Markdown ou du JSON propre, sans aller-retour réseau.

Cela signifie que les agents :

  • Connaissent la table des matières complète avant de lire
  • Peuvent lire des sections individuelles plutôt que des pages entières
  • Voient les liens croisés comme des arêtes de graphe, et non comme des correspondances regex
  • Obtiennent des métadonnées stables d’une version à l’autre

2. Modifier la configuration de la documentation depuis l’agent#

Un utilisateur de Claude Code peut dire « définis la couleur d’accent de ma documentation sur le violet de la marque et ajoute un lien Discord dans le pied de page ». L’agent appelle update_branding et update_navigation sur le serveur MCP. Aucun changement de tableau de bord, aucun copier-coller, aucune modification de Markdown.

3. Interroger les analyses de la documentation depuis l’agent#

"Quelles pages ont enregistré le plus de recherches infructueuses la semaine dernière ?" — l’agent appelle get_failed_searches, consulte la liste et propose de rédiger le contenu manquant directement à cet endroit.

Quels outils un bon serveur MCP de documentation expose#

Le serveur MCP de Docsbook expose des outils dans ces catégories. La liste complète est renvoyée par le serveur lui-même lors de la connexion — le tableau ci-dessous en présente la structure, et non l'inventaire :

Catégorie Exemples
Espace de travail list_workspaces, get_workspace, create_workspace
Contenu et documentation search_docs, get_doc_outline, write_docs
Image de marque update_branding, update_ui_settings, update_navigation
Paramètres d'IA update_ai_settings, set_chat_system_prompt, set_chat_hooks
Domaine update_domain
Traduction update_languages, set_translation_mode, approve_translation
Analytique get_analytics, get_ai_questions, get_failed_searches, get_negative_feedback, get_top_visitors, get_visitor_activity
Webhooks register_webhook_*, list_webhook_deliveries, test_webhook
Compétences find_skill (interroge le catalogue docs-skills)

Connexion depuis Claude Code#

mcp add --transport http https://docsbook.io/api/mcp/server

Le flux OAuth s’ouvre dans le navigateur, vous vous authentifiez et les outils apparaissent dans Claude Code. Aucune clé API à gérer, aucun fichier de configuration à modifier.

Cursor utilise le même serveur MCP avec une expérience utilisateur similaire. ChatGPT et Gemini ajoutent la prise en charge de MCP via HTTP au cours de l’année 2026.

Les outils de type LSP constituent la moitié sous-estimée (plugin local, et non MCP hébergé)#

La plupart des communications sur les MCP pour la documentation se concentrent sur la lecture et l’écriture — dans le cas de Docsbook, search_docs pour trouver des sections pouvant être citées, get_doc_outline pour voir le titre, le nombre de titres et la taille de chaque page avant d’effectuer une recherche ou une écriture, et write_docs pour valider les modifications (avec consentement OAuth : le client choisit une portée en lecture seule ou en lecture-écriture lors de l’autorisation de la connexion). La valeur ajoutée la plus importante pour les agents réside dans la surface de recherche et de navigation de type LSP — mais pour un dépôt opérationnel, cette surface est mieux fournie sous la forme d’un plugin Claude Code local plutôt que d’un outil MCP hébergé. L’analyse locale sur disque est plus rapide, moins coûteuse et ne nécessite pas que la documentation soit déjà publiée.

Docsbook fournit cette fonctionnalité via markdown-lsp — exécutez-le localement et l’agent bénéficie des fonctionnalités suivantes :

  • doc_outline — hiérarchie des titres d’une page (sans le contenu)
  • doc_search_symbols — recherche floue par sous-séquence sur tous les titres (« oaf » → « OAuth flow »)
  • doc_search_text — recherche en texte intégral avec extraits et ligne/colonne exactes
  • doc_search_links_to — références entrantes (LSP references)
  • doc_resolve_link — lien relatif ou wiki → URL GitHub absolue avec ancre
  • doc_definition — page#anchor → position exacte dans la source

LSP — Language Server Protocol — est ce qui permet d’accéder à la définition, de rechercher les références et d’effectuer des recherches de symboles dans VS Code. Le plugin applique le même modèle à votre arborescence de documentation locale, afin qu’un agent puisse naviguer avec une précision comparable à celle d’un IDE. Le serveur MCP hébergé reste axé sur les opérations d’espace de travail (image de marque, analytiques, webhooks, traductions), pour lesquelles le cloud possède réellement les données.

Pourquoi il s’agit d’un véritable canal de distribution#

Trois signaux entre 2025 et 2026 :

  1. Télémétrie de Mintlify. Mintlify a mesuré le trafic pendant 30 jours sur les sites de documentation qu’il héberge — environ 790 millions de requêtes — et a indiqué que les agents de codage IA représentaient 45,3 % de l’ensemble des requêtes, avec Claude Code à 25,2 % et Cursor à 18,0 % (L’état du trafic des agents dans la documentation, publié le 3 avril 2026). Sa mesure de suivi a établi la part des agents à 66 % du trafic en juillet 2026 (Rapport de mi-année 2026, publié le 29 juillet 2026). Il s’agit des données du parc d’un seul fournisseur, et non de l’ensemble du Web, mais c’est la plus grande mesure publiée du trafic des agents vers la documentation.
  2. Utilisation interne chez Anthropic. La documentation d’Anthropic elle-même et la documentation de Claude Code sont axées sur MCP.
  3. Le côté client est déjà construit. Claude Code, Cursor et ChatGPT intègrent la prise en charge de MCP : le connecteur ne nécessite donc pas d’adoption du côté du lecteur — uniquement du vôtre.

Si vous développez des produits pour les développeurs et que votre audience utilise Claude Code ou Cursor, MCP n’est plus une infrastructure facultative.

Ce qu'il en coûte de le créer soi-même#

Un serveur MCP de documentation raisonnable nécessite :

  • Un transport HTTP + un encadrement JSON-RPC
  • Un flux Authorization Code + PKCE OAuth 2.0
  • Des définitions d'outils avec des schémas typés
  • L'analyse du graphe documentaire pour les outils de lecture — généralement fournie sous forme d'un outil CLI local comme markdown-lsp plutôt que d'un endpoint hébergé, car l'analyse locale sur disque est plus rapide et moins coûteuse
  • Un accès en écriture si vous voulez modifier la configuration
  • Une limitation du débit et une journalisation d'audit

Comptez environ 4 à 6 semaines d'ingénierie si vous ne l'avez jamais fait auparavant. Le serveur MCP de Docsbook est fourni avec l'espace de travail et ne coûte rien à exécuter ; markdown-lsp est gratuit et open source pour les outils de lecture du graphe documentaire.

Docsbook fournit un serveur MCP géré avec OAuth, afin que Claude Code et Cursor puissent lire et modifier votre documentation sans que vous ayez à exécuter quoi que ce soit. Les détails de connexion sont disponibles à l'adresse docsbook.io/mcp.

Commencez gratuitement — aucune carte bancaire requise

Étapes suivantes#

Updated

Cette page vous a-t-elle été utile ?