> 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/documentation-as-code/gitbook-mcp.md). # GitBook MCP GitBook expose un serveur MCP qui permet aux outils d’IA d’agir sur le contenu de votre organisation. Des outils comme Claude Code, Codex, Cursor et d’autres clients MCP peuvent l’utiliser pour créer et configurer des sites, ouvrir des demandes de changement, rédiger du contenu, modifier des pages et restructurer la documentation.

Installez nos plugins officiels :

Installer le plugin Claude Installer le plugin ChatGPT Installer le plugin Cursor

{% hint style="info" %} Besoin d’un serveur MCP en lecture seule pour un site de documentation publié ? GitBook en crée un automatiquement pour vous — voir [Serveurs MCP pour la documentation publiée](/docs/documentation/fr/lia-pour-vos-lecteurs/mcp-servers-for-published-docs.md) pour en savoir plus. {% endhint %} ## le point de terminaison MCP de GitBook Configurez votre client MCP sur : ```http https://mcp.gitbook.com/mcp ``` {% hint style="info" %} Ouvrir cette URL dans un navigateur renvoie une erreur. Utilisez-la dans un client MCP capable d’effectuer des requêtes HTTP. {% endhint %} ## Connectez votre client Ajoutez GitBook MCP dans le client de votre choix : {% tabs %} {% tab title="Claude" icon="claude" %} Installez le plugin officiel GitBook pour Claude : Installer le plugin Claude Ou ajoutez le serveur depuis votre terminal : ```bash claude mcp add --transport http gitbook https://mcp.gitbook.com/mcp ``` Puis lancez Claude Code avec `claude` et exécutez `/mcp` pour terminer la connexion dans le navigateur. Si vous préférez un jeton d’accès personnel, passez-le comme en-tête d’autorisation : ```bash claude mcp add --transport http gitbook https://mcp.gitbook.com/mcp \ --header "Authorization: Bearer " ``` {% endtab %} {% tab title="ChatGPT" icon="openai" %} Installez le plugin officiel GitBook pour ChatGPT : Installer le plugin ChatGPT Ou ajoutez le serveur depuis votre terminal : ```bash codex mcp add gitbook --url https://mcp.gitbook.com/mcp ``` Puis connectez-vous via le navigateur. Si vous préférez utiliser un jeton d’accès personnel, ajoutez ceci à `~/.codex/config.toml`: ```toml [mcp_servers.gitbook] url = "https://mcp.gitbook.com/mcp" bearer_token_env_var = "GITBOOK_MCP_TOKEN" enabled = true ``` {% endtab %} {% tab title="Cursor" icon="cursor" %} Installez le plugin officiel GitBook pour Cursor : Installer le plugin Cursor Ou ajoutez le serveur à `~/.cursor/mcp.json`, ou à votre projet à `.cursor/mcp.json`: ```json { "mcpServers": { "gitbook" : { "url" : "https://mcp.gitbook.com/mcp" } } } ``` Puis connectez-vous lorsque Cursor vous y invite. {% endtab %} {% tab title="VS Code" icon="vscode" %} Ajoutez le serveur à `.vscode/mcp.json` dans votre espace de travail : ```json { "servers": { "gitbook" : { "type": "http", "url" : "https://mcp.gitbook.com/mcp" } } } ``` Puis lancez-le depuis la vue MCP et connectez-vous. {% endtab %} {% tab title="Autre" %} Tout client compatible MCP peut se connecter via HTTP flux continu. Pointez-le vers : ``` https://mcp.gitbook.com/mcp ``` GitBook prend uniquement en charge HTTP flux continu. `stdio` et `SSE` ne sont pas pris en charge. Si vous utilisez OAuth, vous n’avez généralement pas besoin de champs d’authentification supplémentaires. Si vous utilisez plutôt un jeton d’accès personnel, envoyez-le comme jeton Bearer : ```http Authorization: Bearer ``` {% endtab %} {% endtabs %} ## Authentifier le MCP de GitBook GitBook MCP prend en charge deux méthodes d’authentification : OAuth et les jetons d’accès personnels. {% tabs %} {% tab title="OAuth" %} Pointez votre client vers l’URL du serveur MCP. Le client découvre le serveur d’autorisation, s’enregistre et ouvre automatiquement le flux de connexion dans le navigateur. Si vous utilisez OAuth, n’ajoutez pas manuellement de jeton Bearer. Le client en obtient un pendant la connexion. {% endtab %} {% tab title="Jeton d’accès personnel" %} Pour éviter le flux dans le navigateur, envoyez votre jeton comme jeton Bearer : ```http Authorization: Bearer ``` Vous pouvez créer un jeton d’accès personnel dans votre [paramètres développeur](https://app.gitbook.com/account/developer). Utilisez-le pour des configurations automatisées, ou lorsque votre client gère déjà les secrets localement. {% endtab %} {% endtabs %} ## Utiliser le MCP de GitBook {% prompt description="Create and configure a new docs site." %} ```markdown En utilisant les outils MCP de GitBook, créez-moi un nouveau site de documentation. 1. Listez mes organisations et confirmez laquelle utiliser avant de créer quoi que ce soit. 2. Demandez à quoi sert le site et quel contenu j’ai (dossier, dépôt ou simple description). Si je vous indique une source, reformulez ce que vous y trouvez pour que je puisse confirmer que c’est correct. 3. Montrez-moi un court plan — nom du site, espaces, structure des pages — et attendez mon accord. 4. Créez le site, ajoutez le contenu et publiez. Ensuite, récupérez l’URL en ligne pour confirmer que cela fonctionne et partagez-la avec moi. ``` {% endprompt %} {% prompt description="Open a change request and draft content." %} ```markdown En utilisant les outils MCP de GitBook, rédigez du nouveau contenu pour ma documentation dans une demande de changement — ne modifiez rien en production. 1. Listez mes organisations et mes sites, et confirmez dans quel espace travailler. 2. Demandez-moi ce que le contenu doit couvrir, puis ouvrez une demande de changement et rédigez les pages à l’intérieur. 3. Faites correspondre le ton et la structure de mes pages existantes — lisez-en quelques-unes d’abord. 4. Une fois terminé, partagez le lien d’aperçu de la demande de changement afin que je puisse la relire et la fusionner dans GitBook. ``` {% endprompt %} {% prompt description="Move, rename, or restructure pages across a site." %} ```markdown En utilisant les outils MCP de GitBook, aidez-moi à restructurer mon site de documentation. 1. Listez mes organisations et mes sites, confirmez lequel, puis récupérez sa structure actuelle et montrez-la-moi. 2. Demandez-moi ce que je veux changer, puis proposez la nouvelle structure sous forme d’un simple arbre avant/après — ne déplacez rien avant mon approbation. 3. Appliquez les changements en conservant autant que possible les URL et les liens internes ; signalez tout ce qui cassera. 4. Montrez-moi la structure finale ainsi que la demande de changement ou le résultat en direct pour vérification. ``` {% endprompt %} ## La différence entre le MCP de GitBook et le MCP de la documentation publiée GitBook propose deux modèles MCP : * [**Serveurs MCP pour la documentation publiée**](/docs/documentation/fr/lia-pour-vos-lecteurs/mcp-servers-for-published-docs.md) donne aux outils d’IA un accès en lecture seule au contenu publié. * **MCP de GitBook** donne aux outils d’IA l’accès à votre contenu et à vos flux de travail via l’API GitBook. Utilisez le MCP de la documentation publiée lorsque vous voulez que les lecteurs de la documentation et les utilisateurs finaux trouvent des informations dans votre documentation publiée. Utilisez le MCP de GitBook lorsque vous voulez que les agents de votre équipe modifient et gèrent votre documentation via des flux de travail automatisés. ## FAQ
Quel transport GitBook MCP prend-il en charge lorsque je connecte un client MCP ? GitBook MCP prend en charge HTTP flux continu. GitBook MCP ne prend pas en charge `stdio` ou `SSE`. Si votre client demande des champs supplémentaires, vous pouvez généralement les laisser vides.
Dois-je ajouter un jeton Bearer lorsque je connecte un client à GitBook MCP ? Vous devez ajouter un jeton Bearer uniquement si vous vous authentifiez avec un [jeton d’accès personnel](https://app.gitbook.com/account/developer). Si vous utilisez OAuth, n’ajoutez pas manuellement de jeton Bearer. Votre client l’obtient pendant le flux de connexion.
Pourquoi rien ne se passe après avoir ajouté le serveur MCP de GitBook à mon client ? Oui. C’est attendu dans certains clients MCP. L’ajout d’un serveur enregistre souvent seulement la configuration. Certains clients ne lancent l’authentification que lorsqu’ils se connectent pour la première fois, listent les outils ou ouvrent le panneau MCP.
Pourquoi rien ne se passe après avoir cliqué sur Authentifier pour GitBook MCP ? Certains clients ouvrent le flux de connexion dans le navigateur après un court délai. Ce délai peut être plus long sur un réseau lent ou instable. Si aucun onglet du navigateur ne s’ouvre après environ une minute, vérifiez votre réseau, les paramètres des fenêtres contextuelles et le navigateur par défaut.
Que se passe-t-il pendant le flux d’authentification de GitBook MCP ? Lorsque l’authentification fonctionne, le flux ressemble généralement à ceci : 1. Le client se connecte au serveur MCP. 2. Votre navigateur ouvre le flux de connexion. 3. Vous vous connectez et approuvez l’accès. 4. Le client affiche le serveur comme connecté, ou les outils MCP deviennent disponibles.
Comment puis-je savoir si mon client s’est authentifié avec succès auprès de GitBook MCP ? Le signal exact dépend de votre client, mais le résultat est généralement clair. La plupart des clients suppriment l’invite d’authentification, affichent le serveur comme connecté ou permettent à l’assistant de lister et d’appeler les outils MCP. Si le **Authentifier** bouton reste visible et qu’aucun outil n’apparaît, le flux ne s’est probablement pas terminé.
Que dois-je vérifier si l’authentification GitBook MCP semble toujours bloquée ? Essayez ces vérifications : * Confirmez que l’URL du serveur pointe vers le point de terminaison MCP. * Confirmez que le client utilise le transport HTTP. * Réessayez sur un réseau stable. * Supprimez puis rajoutez le serveur si le client a mis en cache un état d’échec.
--- # 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/documentation-as-code/gitbook-mcp.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.