> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/lia-pour-vos-lecteurs/mcp-servers-for-published-docs.md). # Serveurs MCP pour la documentation publiée Chaque site GitBook publié inclut automatiquement un serveur Model Context Protocol (MCP). Les outils d’IA peuvent l’utiliser pour lire directement votre documentation publiée. Cela fonctionne avec Claude, Claude Code, Cursor, Codex, VS Code et d’autres clients MCP. ### Choisissez le bon point de terminaison Votre serveur MCP se trouve à l’URL de votre site publié, plus l’un de ces points de terminaison : | Si votre site est… | Utilisez cette URL | Exemple | | -------------------------------------------------------------------------------------------------- | ----------------------------------- | -------------------------------------------- | | Public, partagé par lien de partage avec tout le contenu publié exposé, ou entièrement authentifié | `{docs-site-url}/~gitbook/mcp` | `https://gitbook.com/docs/~gitbook/mcp` | | Partiellement authentifié, avec du contenu public ou partagé par lien de partage toujours exposé | `{docs-site-url}/~gitbook/mcp/auth` | `https://gitbook.com/docs/~gitbook/mcp/auth` | Pour les sites entièrement authentifiés, les clients se connectent via la découverte MCP et OAuth. Pour plus de détails, voir le [flux d’autorisation MCP](https://modelcontextprotocol.io/docs/tutorials/security/authorization#the-authorization-flow-step-by-step). {% 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 %} {% hint style="info" %} **Actions de page** doit être activé pour que le serveur MCP fonctionne. Si vous désactivez **Personnalisation du site** → **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 %} ### Connecter un outil d’IA {% stepper %} {% step %} #### Trouvez l’URL de votre serveur MCP Commencez par l’URL de votre documentation publiée. Ensuite, ajoutez le point de terminaison de [Choisissez le bon point de terminaison](#choose-the-right-endpoint). Par exemple, si votre site de documentation est `https://gitbook.com/docs`, l’URL de votre serveur MCP est `https://gitbook.com/docs/~gitbook/mcp`. {% endstep %} {% step %} #### Ajoutez le serveur à votre outil Utilisez l’onglet correspondant à votre outil ci-dessous. Remplacez `{docs-site-url}` par l’URL de votre propre site publié. Si votre site utilise le deuxième point de terminaison, remplacez `/~gitbook/mcp` par `/~gitbook/mcp/auth`. {% endstep %} {% step %} #### Posez une question de test Exécutez l’une des invites dans [Essayez-le](#try-it). Si l’outil peut rechercher dans votre documentation et répondre à partir de celle-ci, la connexion fonctionne. {% endstep %} {% endstepper %} {% tabs %} {% tab title="Claude" %} Ces étapes fonctionnent dans Claude sur le web et dans Claude Desktop. Ouvrez **Paramètres** → **Connecteurs**. Cliquez sur **Ajouter un connecteur personnalisé**. Ensuite, collez l’URL de votre serveur MCP, par exemple `{docs-site-url}/~gitbook/mcp`. Exemple : ``` https://gitbook.com/docs/~gitbook/mcp ``` Si Claude n’affiche pas les connecteurs distants, votre plan actuel ou votre déploiement ne les prend peut-être pas encore en charge. {% endtab %} {% tab title="Claude Code" %} Exécutez cette commande dans votre terminal : ```shell claude mcp add --transport http my-docs https://gitbook.com/docs/~gitbook/mcp ``` Remplacer `my-docs` par le nom de serveur de votre choix. Si votre site utilise le point de terminaison public authentifié, remplacez le suffixe de l’URL par `/~gitbook/mcp/auth`. {% endtab %} {% tab title="Cursor" %} Ouvrez **Paramètres** → **MCP**. Cliquez sur **Ajouter un nouveau serveur MCP**. Puis collez `{docs-site-url}/~gitbook/mcp`. Vous pouvez aussi ajouter ce fichier dans `.cursor/mcp.json`: ```json { "mcpServers": { "my-docs": { "url": "https://gitbook.com/docs/~gitbook/mcp" } } } ``` Remplacer `my-docs` par le nom de votre propre serveur si vous le souhaitez. {% endtab %} {% tab title="Codex" %} Utilisez la commande `codex mcp add` ou ajoutez le serveur à votre `config.toml`. Exemple de commande : ```shell codex mcp add my-docs https://gitbook.com/docs/~gitbook/mcp ``` Exemple de configuration : ```toml [mcp_servers.my-docs] url = "https://gitbook.com/docs/~gitbook/mcp" ``` Remplacer `my-docs` par le nom de votre propre serveur si vous le souhaitez. {% endtab %} {% tab title="VS Code (Copilot)" %} Ouvrez votre `mcp.json` fichier. Puis ajoutez une entrée de serveur avec le transport HTTP : ```json { "servers": { "my-docs": { "type": "http", "url": "https://gitbook.com/docs/~gitbook/mcp" } } } ``` Remplacer `my-docs` par le nom de votre propre serveur si vous le souhaitez. {% endtab %} {% endtabs %} ### Essayez-le Collez l’une de ces invites dans votre assistant : * `Avec le serveur MCP my-docs, comment configurer un accès authentifié ?` * `Recherchez dans ma documentation tout ce qui concerne les domaines personnalisés et résumez les étapes.` * `Listez les outils exposés par le serveur MCP my-docs. Puis utilisez-les pour trouver la page sur les actions de page.` Si vous utilisez un outil agentique, vous pouvez aussi lui donner cette invite de configuration : ``` Ajoutez un serveur MCP nommé my-docs avec le transport HTTP à https://gitbook.com/docs/~gitbook/mcp. Puis vérifiez qu’il se connecte en listant les outils disponibles. ``` ### Exigences Pour utiliser un serveur MCP : * Votre site doit être publié. Le serveur MCP n’expose que le contenu publié. * **Actions de page** doit être activé dans **Personnalisation du site** → **Actions de page**. * Votre outil doit prendre en charge MCP sur HTTP. * Si votre site utilise [un accès authentifié](/docs/documentation/fr/publier/site-audience/authenticated-access.md), votre outil doit prendre en charge la [spécification d’autorisation MCP](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization). * Si votre site utilise des liens de partage, utilisez l’URL du site du lien de partage, puis ajoutez le point de terminaison de [Choisissez le bon point de terminaison](#choose-the-right-endpoint). * GitBook ne prend en charge que le transport HTTP. `stdio` et `SSE` ne sont pas pris en charge. Dans le **Actions de page** section de vos [Personnalisation](/docs/documentation/fr/gerer-votre-site/customization.md) paramètres, vous pouvez activer l’option **Se connecter avec le serveur MCP** Cela permet aux visiteurs de copier l’URL du serveur MCP de votre site depuis [le menu des actions de page](/docs/documentation/fr/gerer-votre-site/customization/extra-configuration.md#page-actions). ### Ajoutez le lien MCP à votre site Dans [Personnalisation du site](/docs/documentation/fr/gerer-votre-site/customization.md), ouvrez [Actions de page](/docs/documentation/fr/gerer-votre-site/customization/extra-configuration.md#page-actions). Assurez-vous que **Actions de page** est activé. Puis activez **Se connecter avec le serveur MCP**. Cela ajoute un lien MCP copiables au menu des actions de page. Cela ne modifie pas le point de terminaison utilisé par votre outil. ### Confidentialité et accès Utilisez le point de terminaison de [Choisissez le bon point de terminaison](#choose-the-right-endpoint). Le serveur MCP donne un accès en lecture seule à votre documentation publiée. Les pages masquées restent disponibles via MCP. Masquer une page ne la retire que 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. ### Dépannage Si un outil ne peut pas se connecter : * Vérifiez que votre site publié est accessible. * Vérifiez que l’URL utilise le point de terminaison de [Choisissez le bon point de terminaison](#choose-the-right-endpoint). * Si le site utilise l’authentification, utilisez un client qui prend en charge la [spécification d’autorisation MCP](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization). * 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/publier/site-audience/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 à l’aide d’OAuth et de l’enregistrement dynamique de client (DCR). Si votre site utilise plutôt des liens de partage, utilisez l’URL complète du site du lien de partage, puis ajoutez le point de terminaison de [Choisissez le bon point de terminaison](#choose-the-right-endpoint). GitBook ne prend pas en charge les sites utilisant uniquement des liens de partage ni les sites utilisant des jetons d’authentification visiteur transmis comme en-têtes statiques pour l’authentification MCP. Les clients MCP pris en charge — y compris Claude — suivent [spécification d’autorisation MCP](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization) pour se connecter. {% stepper %} {% step %} #### Découvrir le serveur OAuth Pendant la négociation MCP, le client découvre le serveur OAuth de votre site. {% endstep %} {% step %} #### Enregistrer un client avec DCR Le client enregistre un client OAuth avec l’enregistrement dynamique de client. Vous n’avez pas besoin de créer manuellement un ID client. {% endstep %} {% step %} #### Connectez-vous avec le fournisseur d’authentification de votre site Le client vous redirige vers le fournisseur d’authentification de votre site. Vous vous connectez avec le même fournisseur que celui déjà utilisé par votre site de documentation. {% endstep %} {% step %} #### Échanger le code contre un jeton Après la connexion, le client échange le code d’autorisation contre un jeton d’accès. {% endstep %} {% step %} #### Réutiliser le jeton Le client envoie ce jeton avec les requêtes MCP suivantes jusqu’à son expiration. {% endstep %} {% endstepper %} Ce flux fonctionne avec ces backends d’accès authentifié : * [Auth0](/docs/documentation/fr/publier/site-audience/authenticated-access/setting-up-auth0.md) * [Azure AD](/docs/documentation/fr/publier/site-audience/authenticated-access/setting-up-azure-ad.md) * [Okta](/docs/documentation/fr/publier/site-audience/authenticated-access/setting-up-okta.md) * [AWS Cognito](/docs/documentation/fr/publier/site-audience/authenticated-access/setting-up-aws-cognito.md) * [OIDC](/docs/documentation/fr/publier/site-audience/authenticated-access/setting-up-oidc.md) * [Backend personnalisé](/docs/documentation/fr/publier/site-audience/authenticated-access/setting-up-a-custom-backend.md) avec une URL de secours configurée {% hint style="warning" %} L’authentification MCP ne prend pas en charge les sites qui s’appuient uniquement sur des jetons d’authentification visiteur statiques dans les en-têtes de requête. Utilisez plutôt l’un des backends d’accès authentifié ci-dessus. {% endhint %} Pour configurer cela, commencez par [Accès authentifié](/docs/documentation/fr/publier/site-audience/authenticated-access.md) et [Activation de l’accès authentifié](/docs/documentation/fr/publier/site-audience/authenticated-access/enabling-authenticated-access.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://gitbook.com/docs/documentation/fr/lia-pour-vos-lecteurs/mcp-servers-for-published-docs.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.