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 :

Si votre site est...

Utilisez cette URL

Exemple

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.

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.

Les actions de page doivent être activées pour que le serveur MCP fonctionne. Si vous désactivez la 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.

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.

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.

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/mcp

Si 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/mcp

Remplacer 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 :

codex mcp add my-docs https://gitbook.com/docs/~gitbook/mcp

Exemple de configuration :

[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.

Ouvrez votre mcp.json fichier. Puis ajoutez une entrée de serveur avec transport HTTP :

{
  "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.

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 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é.
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. stdio et SSE ne 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 stdio ou SSE, 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.

Découvrir le serveur OAuth

Pendant la poignée de main MCP, le client découvre le serveur OAuth de votre site.

Enregistrer un client avec DCR

Le client enregistre un client OAuth avec Dynamic Client Registration.

Vous n’avez pas besoin de créer manuellement un ID client.

Se connecter 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 documentation.

Échanger le code contre un jeton

Après la connexion, le client échange le code d’autorisation contre un jeton d’accès.

Réutiliser le jeton

Le client envoie ce jeton avec les requêtes MCP suivantes jusqu’à son expiration.

Ce flux fonctionne avec ces backends d’accès authentifié :

Auth0
Azure AD
Okta
AWS Cognito
OIDC
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 il y a 29 jours

Ce contenu vous a-t-il été utile ?