Serveurs MCP pour la documentation publiée
Les docs publiées sur GitBook génèrent automatiquement un serveur MCP que vous pouvez connecter à des outils externes
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 :
Public, partagé via un 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 accessible via lien de partage encore 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, consultez le flux d’autorisation MCP.
Connecter un outil d’IA
Trouvez l’URL de votre serveur MCP
Commencez par l’URL de votre documentation publiée. Puis ajoutez le point de terminaison de Choisissez le bon point de terminaison.
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.
Posez une question de test
Exécutez l’une des invites dans Essayez-le. Si l’outil peut rechercher dans votre documentation et y répondre, la connexion fonctionne.
Ces étapes fonctionnent dans Claude sur le web et dans Claude Desktop.
Ouvrez Paramètres → Connecteurs.
Cliquez sur Ajouter un connecteur personnalisé. Puis collez l’URL de votre serveur MCP, comme {docs-site-url}/~gitbook/mcp.
Exemple :
https://gitbook.com/docs/~gitbook/mcpSi Claude n’affiche pas les connecteurs distants, votre offre actuelle ou votre déploiement ne les prend peut-être pas encore en charge.
Exécutez cette commande dans votre terminal :
claude mcp add --transport http my-docs https://gitbook.com/docs/~gitbook/mcpRemplacer my-docs par n’importe quel nom de serveur que vous souhaitez.
Si votre site utilise le point de terminaison public authentifié, remplacez le suffixe de l’URL par /~gitbook/mcp/auth.
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:
{
"mcpServers": {
"my-docs": {
"url": "https://gitbook.com/docs/~gitbook/mcp"
}
}
}Remplacer my-docs par le nom de votre propre serveur si vous le souhaitez.
Utilisez la commande codex mcp add ou ajoutez le serveur à votre config.toml.
Exemple de commande :
Exemple de configuration :
Remplacer my-docs par le nom de votre propre serveur si vous le souhaitez.
Ouvrez votre mcp.json fichier. Puis ajoutez une entrée de serveur avec transport HTTP :
Remplacer my-docs par le nom de votre propre serveur si vous le souhaitez.
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 :
Exigences
Pour utiliser un serveur MCP :
Votre site doit être publié. Le serveur MCP n’expose que le contenu publié.
Les actions de page doivent être activées dans la personnalisation du site → Les actions de page.
Votre outil doit prendre en charge MCP via HTTP.
Si votre site utilise l’accès authentifié, votre outil doit prendre en charge la spécification d’autorisation MCP.
Si votre site utilise des liens de partage, utilisez l’URL du site par lien de partage, puis ajoutez le point de terminaison de Choisissez le bon point de terminaison.
GitBook ne prend en charge que le transport HTTP.
stdioetSSEne sont pas pris en charge.
Dans le Les actions de page section de vos Personnalisation dans les 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.
Ajoutez le lien MCP à votre site
Dans la personnalisation du site, ouvrez Les actions de page. Assurez-vous que Les actions de page est activé. Puis activez Se connecter avec le serveur MCP.
Cela ajoute un lien MCP copiable au menu des actions de page. Cela ne change 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.
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 retire 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.
Dépannage
Si un outil ne parvient 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.
Si le site utilise l’authentification, utilisez un client qui prend en charge la spécification d’autorisation MCP.
Si l’outil a besoin de
stdioouSSE, cela ne fonctionnera pas avec GitBook.
Utiliser MCP avec des sites authentifiés
Si votre site GitBook utilise l’accès authentifié, le serveur MCP à /~gitbook/mcp utilise la même authentification. Les clients MCP qui prennent en charge la spécification d’autorisation MCP — y compris Claude et Claude Code — peuvent se connecter automatiquement à l’aide d’OAuth et de l’enregistrement dynamique des clients (DCR).
Si votre site utilise plutôt des liens de partage, utilisez l’URL complète du site par lien de partage, puis ajoutez le point de terminaison de Choisissez le bon point de terminaison.
GitBook ne prend pas en charge les sites uniquement par lien de partage ni les sites utilisant des jetons d’authentification de visiteur transmis comme en-têtes statiques pour l’authentification MCP.
Les clients MCP pris en charge — y compris Claude — suivent le spécification d’autorisation MCP pour se connecter.
Ce flux fonctionne avec ces backends d’accès authentifié :
Backend personnalisé avec une URL de secours configurée
L’authentification MCP ne prend pas en charge les sites qui s’appuient uniquement sur des jetons d’authentification de visiteur statiques dans les en-têtes de requête.
Utilisez plutôt l’un des backends d’accès authentifié ci-dessus.
Pour configurer cela, commencez par Accès authentifié et Activation de l’accès authentifié.
Mis à jour
Ce contenu vous a-t-il été utile ?