Serveurs MCP pour les docs publiées

Chaque site GitBook publié inclut un serveur MCP auquel vous pouvez connecter des outils externes

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.

L’URL de 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.

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.

Connecter un outil d’IA

1

Trouver l’URL de votre serveur MCP

Prenez l’URL de votre site GitBook publié. Puis ajoutez /~gitbook/mcp.

2

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.

3

Commencer à utiliser votre documentation

Une fois connecté, l’outil peut rechercher dans votre documentation, ouvrir des pages et répondre à des questions à partir de votre contenu.

Conditions requises

Pour utiliser un serveur MCP :

• Votre site doit être publié. Le serveur MCP expose uniquement le contenu publié.

• Votre outil doit prendre en charge MCP via HTTP.

• Si votre site utilise l’authentification, le serveur MCP doit utiliser les mêmes règles d’accès.

• 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, ouvrez la section Actions de la page . Puis activez Se connecter avec le serveur MCP.

Les visiteurs peuvent alors copier l’URL du serveur depuis le menu des actions de la page.

Confidentialité et accès

Le serveur MCP donne un accès en lecture seule à votre documentation 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 peut pas se connecter :

• Vérifiez que votre site publié est accessible.

• Vérifiez 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 nécessite 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é, 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 au serveur à l’aide d’OAuth et de l’enregistrement dynamique de client (DCR).

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 la poignée de main MCP

2. Enregistre dynamiquement un client OAuth (aucune configuration manuelle d’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.

Conditions requises

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 secours configurée

GitBook ne prend pas en charge les sites accessibles uniquement via un lien de partage ni les sites utilisant des jetons d’authentification visiteurs transmis sous forme d’en-têtes statiques pour l’authentification MCP.