Serveur MCP pour la documentation : ce que c'est et pourquoi il gagne

Le Protocole de Contexte de Modèle (MCP) est la norme de connecteur qu'Anthropic a publiée fin 2024. D'ici mi-2026, il est pris en charge par Claude Code, Cursor, ChatGPT et une liste croissante d'agents. Pour la documentation, le MCP transforme vos documents d'un actif uniquement web en une surface programmatique que les agents IA peuvent lire et sur laquelle ils peuvent agir.

Ce post explique ce qu'est le MCP, quels outils un serveur MCP de documentation expose, et comment Docsbook en livre un.

TL;DR#

MCP = méthode standard pour les agents IA d'appeler des outils externes
Un serveur MCP de docs expose des outils comme get_analytics, update_branding, set_chat_hooks
Les agents découvrent les capacités, demandent OAuth, puis appellent des outils dans le cadre de leur travail
Docsbook expédie un serveur MCP géré à docsbook.io/api/mcp/server
Ceci est maintenant un canal de distribution AI principal — Mintlify a mesuré les agents de codage AI à 45,3 % des demandes vers les sites de documentation qu'il héberge 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 avez-vous ?", reçoit un schéma typé et appelle des outils. L'authentification est OAuth 2.0 avec PKCE.

La façon la plus simple d'y penser : API REST + OAuth + un point de découverte + des outils au lieu de ressources.

Pourquoi la documentation bénéficie de MCP#

Trois flux de travail :

1. Lire les documents en tant que données structurées#

Sans MCP, un agent récupère une page HTML, l'analyse et espère que la structure est intacte. Avec markdown-lsp exécuté localement (npx markdown-lsp <subcommand> ./docs), l'agent analyse le graphe de documents 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 au lieu de pages complètes
Voient les liens croisés comme des arêtes de graphe, et non comme des correspondances regex
Obtiennent des métadonnées stables par version

2. Modification de la configuration des docs depuis l'agent#

Un utilisateur dans Claude Code peut dire "définir ma couleur d'accent des docs sur le violet de la marque et ajouter un lien Discord dans le pied de page." L'agent appelle update_branding et update_navigation sur le serveur MCP. Pas de changement de tableau de bord, pas de copier-coller, pas d'édition de markdown.

3. Interroger les analyses de documents depuis l'agent#

"Quelles pages ont eu le plus d'échecs de recherche la semaine dernière ?" — l'agent appelle get_failed_searches, voit la liste et propose de rédiger le contenu manquant sur place.

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 est la forme, pas l'inventaire :

Catégorie	Exemples
Espace de travail	`list_workspaces`, `get_workspace`, `create_workspace`
Contenu et documentation	`search_docs`, `get_doc_outline`, `write_docs`
Marque	`update_branding`, `update_ui_settings`, `update_navigation`
Paramètres d'IA	`update_ai_settings`, `set_chat_system_prompt`, `set_chat_hooks`
SEO et domaine	`update_seo`, `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 autorisez, les outils apparaissent dans Claude Code. Pas de clés API à gérer, pas de fichier de configuration à éditer.

Cursor utilise le même serveur MCP avec une UX similaire. ChatGPT et Gemini ajoutent le support HTTP MCP jusqu'en 2026.

Les outils de style LSP sont la moitié sous-estimée (plugin local, pas MCP hébergé)#

La plupart des documents marketing de MCP se concentrent sur la lecture/écriture — dans le cas de Docsbook, search_docs pour trouver des sections citables, get_doc_outline pour voir le titre de chaque page, le nombre de titres et la taille avant de rechercher ou d'écrire, et write_docs pour valider les modifications (sous réserve du consentement OAuth : le client choisit la portée en lecture seule ou en lecture-écriture lors de l'autorisation de la connexion). La valeur ajoutée pour les agents est la surface de recherche et de navigation de style LSP — mais pour un dépôt fonctionnel, cette surface est mieux fournie en tant que plugin Claude Code local plutôt qu'en tant qu'outil MCP hébergé. L'analyse locale sur disque est plus rapide, moins chère et ne nécessite pas que les documents soient publiés.

Docsbook expédie cela via markdown-lsp — exécutez-le localement et l'agent obtient :

doc_outline — hiérarchie des titres pour une page (sans corps)
doc_search_symbols — sous-séquence floue sur tous les titres ("oaf" → "flux OAuth")
doc_search_text — texte intégral avec extraits et ligne/col exacte
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 source exacte

LSP — Protocole de serveur de langage — est ce qui alimente la définition de destination, la recherche de références et la recherche de symboles dans VS Code. Le plugin applique le même modèle à votre arbre de documents local, de sorte qu'un agent navigue avec une précision semblable à celle d'un IDE. Le serveur MCP hébergé reste concentré sur les opérations de l'espace de travail (branding, analytics, webhooks, traductions) où le cloud possède réellement les données.

Pourquoi c'est un véritable canal de distribution#

Trois signaux de 2025 à 2026 :

Télémetrie Mintlify. Mintlify a mesuré 30 jours de trafic sur les sites de documentation qu'il héberge — environ 790 millions de requêtes — et a rapporté que les agents de codage IA représentaient 45,3 % de toutes les 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 placé la part des agents à 66 % du trafic en juillet 2026 (rapport de mi-année 2026, publié le 29 juillet 2026). C'est la flotte d'un seul fournisseur plutôt que l'ensemble du web, mais c'est la plus grande mesure publiée du trafic des agents vers la documentation.
Dogfooding d'Anthropic. La propre documentation d'Anthropic et les docs de Claude Code sont axés sur MCP.
Le côté client est déjà construit. Claude Code, Cursor et ChatGPT prennent en charge MCP, donc le connecteur n'a pas besoin d'adoption du côté du lecteur — seulement du vôtre.

Si vous construisez pour les développeurs et que votre public utilise Claude Code ou Cursor, MCP n'est plus une infrastructure optionnelle.

Ce que cela coûte de construire soi-même#

Un serveur MCP raisonnable nécessite :

Transport HTTP + encadrement JSON-RPC
Code d'autorisation OAuth 2.0 + flux PKCE
Définitions d'outils avec des schémas typés
Analyse de graphes de documents pour les outils de lecture — généralement livré en tant qu'outil CLI local comme markdown-lsp plutôt qu'un point de terminaison hébergé, car l'analyse locale sur disque est plus rapide et moins coûteuse
Accès en écriture si vous souhaitez modifier la configuration
Limitation de débit et journalisation des audits

Environ 4 à 6 semaines d'ingénierie si vous ne l'avez pas fait auparavant. Le serveur MCP de Docsbook est livré avec l'espace de travail et ne coûte rien à exécuter ; markdown-lsp est gratuit et open source pour les outils de lecture de graphes de documents.

Docsbook propose un serveur MCP géré avec OAuth, donc Claude Code et Cursor lisent et modifient vos documents sans que vous n'ayez à exécuter quoi que ce soit. Les détails de connexion se trouvent sur docsbook.io/mcp.

Commencez gratuitement — pas de carte de crédit

Étapes suivantes#

docs-skills : capacités modulaires pour les agents IA — la couche qui se trouve au-dessus de MCP
llms.txt expliqué — la norme compagnon pour les agents sans MCP
Comparaison des plateformes de documentation IA — laquelle des quatre expédie un serveur MCP
Comment faire citer votre documentation par ChatGPT — le côté découverte du même canal