# Serveurs MCP pour la documentation publiée 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 {% hint style="info" %} **Les actions de page** doivent être activées pour que le serveur MCP fonctionne. Si vous désactivez **Personnalisation du site** → **Les actions de page**, GitBook désactive `~gitbook/mcp` et le point de terminaison renvoie `404`. **Se connecter avec le serveur MCP** contrôle uniquement si le lien MCP apparaît dans le menu des actions de page. {% endhint %} {% 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 à l’aide de votre contenu. {% endstep %} {% endstepper %} ### Prérequis Pour utiliser un serveur MCP : * Votre site doit être publié. Le serveur MCP expose uniquement le contenu publié. * **Les actions de page** doit être activé dans **Personnalisation du site** → **Les actions de page**. * Votre outil doit prendre en charge MCP via HTTP. * Si votre site utilise un accès authentifié, le serveur MCP utilise 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 en charge uniquement 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 [Les actions de page](/docs/documentation/fr/docs-site/customization/extra-configuration.md#page-actions). Assurez-vous que **Les actions de page** est activé. Puis activez **Se connecter avec le serveur MCP**. Si **Les actions de page** est désactivé, GitBook désactive `~gitbook/mcp` et le point de terminaison renvoie `404`. **Se connecter avec le serveur MCP** contrôle uniquement si GitBook affiche le lien du serveur MCP dans le menu des actions de page. Les visiteurs peuvent alors 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 ne la supprime que de la table des matières publiée. Il n’expose jamais les données du compte, les analyses ou 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. ### Dépannage Si un outil ne parvient pas à se connecter : * Confirmez que votre site publié est accessible. * Confirmez 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 automatiquement au serveur à l’aide d’OAuth et de l’enregistrement dynamique de client (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 le handshake MCP 2. Enregistre dynamiquement un client OAuth (aucune configuration manuelle de l’ID client requise) 3. Vous redirige vers le fournisseur d’authentification en 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 votre première connexion. Ensuite, le client réutilise le jeton jusqu’à son expiration. **Prérequis** 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 repli configurée GitBook ne prend pas en charge les sites utilisant des jetons d’authentification visiteur 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.