# Serveurs MCP pour les docs publiées Chaque site GitBook publié inclut un serveur Model Context Protocol (MCP). Les outils d’IA peuvent l’utiliser pour lire directement votre documentation publiée. Cela fonctionne avec des outils comme Claude Desktop, Cursor et les extensions VS Code. Votre serveur MCP se trouve à l’URL de votre site publié, suivie de `/~gitbook/mcp`. Par exemple, la documentation de GitBook se trouve à `https://gitbook.com/docs`. Son serveur MCP est `https://gitbook.com/docs/~gitbook/mcp`. {% hint style="info" %} Si vous ouvrez cette URL dans un navigateur, vous verrez une erreur. Utilisez-la dans un outil capable d’effectuer des requêtes HTTP, comme un assistant IA ou un IDE. {% endhint %} ### Connecter un outil d’IA {% stepper %} {% step %} **Trouver l’URL de votre serveur MCP** Prenez l’URL de votre site GitBook publié. Puis ajoutez `/~gitbook/mcp`. {% endstep %} {% step %} **Configurer votre outil d’IA** Ouvrez les paramètres MCP de votre outil. Puis saisissez l’URL du serveur. Chaque outil gère la configuration différemment. Consultez la documentation de votre outil pour connaître les étapes exactes. {% endstep %} {% step %} **Commencer à utiliser votre documentation** Une fois connecté, l’outil peut rechercher dans votre documentation, ouvrir des pages et répondre aux questions avec votre contenu. {% endstep %} {% endstepper %} ### Exigences Pour utiliser un serveur MCP : * Votre site doit être publié. Le serveur MCP expose uniquement le contenu publié. * Votre outil doit prendre en charge MCP via HTTP. * Si votre site utilise un accès authentifié, le serveur MCP applique les mêmes règles d’accès. * Si votre site utilise des liens de partage, utilisez l’URL du site du lien de partage, puis ajoutez `/~gitbook/mcp`. * GitBook prend uniquement en charge le transport HTTP. `stdio` et `SSE` ne sont pas pris en charge. ### Ajouter le lien MCP à votre site Dans [Personnalisation du site](/docs/documentation/fr/docs-site/customization.md), ouvrez la section [Actions de page](/docs/documentation/fr/docs-site/customization/extra-configuration.md#page-actions) . Puis activez **Se connecter avec un serveur MCP**. Ce paramètre contrôle si GitBook affiche le lien du serveur MCP dans le menu des actions de page. Les visiteurs peuvent ensuite copier l’URL du serveur depuis le menu des actions de page. ### Confidentialité et accès Le serveur MCP donne un accès en lecture seule à votre documentation publiée. Les pages masquées restent accessibles via MCP. Masquer une page la supprime uniquement de la table des matières publiée. Il n’expose jamais les données du compte, les analyses ni les données internes de GitBook. Il ne sert que la dernière version publiée. Les brouillons et les modifications non publiées restent privés. ### Résolution des problèmes Si un outil ne parvient pas à se connecter : * Vérifiez que votre site publié est accessible. * Vérifiez que l’URL se termine par `/~gitbook/mcp`. * Si le site utilise l’authentification, utilisez un client qui prend en charge l’autorisation MCP. * Si l’outil a besoin de `stdio` ou `SSE`, il ne fonctionnera pas avec GitBook. ### Utiliser MCP avec des sites authentifiés Si votre site GitBook utilise [un accès authentifié](/docs/documentation/fr/acces-au-site/authenticated-access.md), le serveur MCP à `/~gitbook/mcp` utilise la même authentification. Les clients MCP qui prennent en charge la [spécification d’autorisation MCP](https://modelcontextprotocol.io/docs/tutorials/security/authorization) — y compris Claude et Claude Code — peuvent se connecter au serveur automatiquement à l’aide d’OAuth et de l’enregistrement dynamique des clients (DCR). Si votre site utilise plutôt des liens de partage, MCP fonctionne toujours. Utilisez l’URL complète du site du lien de partage, puis ajoutez `/~gitbook/mcp`. **Fonctionnement** Lorsqu’un client MCP pris en charge se connecte au serveur MCP de votre site authentifié, il : 1. Découvre le serveur OAuth via la poignée de main MCP 2. Enregistre dynamiquement un client OAuth (aucune configuration manuelle d’ID client requise) 3. Vous redirige vers le fournisseur d’authentification amont de votre site pour vous connecter 4. Échange le code d’authentification contre un jeton d’accès et le stocke localement pour toutes les requêtes suivantes GitBook vous invite à vous authentifier lors de la première connexion. Ensuite, le client réutilise le jeton jusqu’à son expiration. **Exigences** Pour que ce flux fonctionne, votre site doit utiliser l’un des backends d’authentification pris en charge par GitBook : * Auth0, Azure AD, Okta, AWS Cognito ou OIDC via les intégrations natives * Un backend personnalisé avec une URL de secours configurée GitBook ne prend pas en charge les sites utilisant des jetons d’authentification visiteurs transmis sous forme d’en-têtes statiques pour l’authentification MCP. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://gitbook.com/docs/documentation/fr/ia-et-recherche/mcp-servers-for-published-docs.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.