Serveurs MCP pour la documentation publiée

Les documents publiés 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 des outils comme Claude Desktop, Cursor et les extensions VS Code.

Votre serveur MCP se trouve à l’URL de votre site publié, plus /~gitbook/mcp.

Par exemple, la documentation de GitBook se trouve à https://gitbook.com/docs. Son serveur MCP est https://gitbook.com/docs/~gitbook/mcp.

Utilisez ce point de terminaison pour les sites publics, les sites à lien de partage où tout le contenu publié est exposé, et les sites entièrement authentifiés.

Pour les sites entièrement authentifiés, les clients MCP s’authentifient via la découverte MCP et le flux OAuth avant de pouvoir accéder aux outils. Pour plus de détails, consultez le flux d’autorisation MCP.

Si votre site est partiellement authentifié et expose tout de même du contenu public ou via lien de partage, utilisez /~gitbook/mcp/auth à la place. Par exemple, https://gitbook.com/docs/~gitbook/mcp/auth.

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é et ajoutez le point de terminaison qui correspond à votre site :

• Utilisez /~gitbook/mcp pour les sites publics, les sites à lien de partage où tout le contenu publié est exposé, ou les sites entièrement authentifiés qui utilisent la découverte MCP et OAuth.

• Utilisez /~gitbook/mcp/auth si votre site est partiellement authentifié et expose encore du contenu public ou via lien de partage.

2

Configurer votre outil d’IA

Ajoutez l’URL du serveur MCP aux paramètres de votre assistant IA. Chaque outil a un processus de configuration légèrement différent, vous devriez donc consulter la documentation de l’outil de votre choix pour voir comment configurer un serveur MCP pour celui-ci.

3

Commencer à utiliser votre documentation

Une fois connecté, votre assistant IA peut rechercher dans votre documentation, récupérer des pages spécifiques et répondre aux questions en utilisant votre contenu. L’assistant aura un accès en temps réel à votre documentation publiée.

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.

1

Trouver l’URL de votre serveur MCP

Prenez l’URL de votre site GitBook publié. Ajoutez ensuite /~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 aux questions à partir de votre contenu.

Exigences

Le serveur MCP respecte les paramètres de visibilité de votre site. Utilisez /~gitbook/mcp pour les sites publics, les sites à lien de partage où tout le contenu publié est exposé, ou les sites entièrement authentifiés qui utilisent la découverte MCP et OAuth. Utilisez /~gitbook/mcp/auth si votre site est partiellement authentifié et expose encore du contenu public ou via lien de partage.

Dans la Actions de page section de vos Personnalisation paramètres, vous pouvez activer l’option Se connecter avec le serveur MCP Cette option permet aux visiteurs de votre site de documentation de copier rapidement un lien vers le serveur MCP de votre site directement depuis le menu Actions de page.

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 l’accès authentifié, le serveur MCP utilise les mêmes règles d’accès.

• Si votre site utilise des liens de partage, utilisez l’URL du site à lien de partage, puis ajoutez /~gitbook/mcp.

• GitBook ne prend en charge que le transport HTTP. stdio et SSE ne sont pas pris en charge.

Ajouter le lien MCP à votre site

Dans Personnalisation du site, ouvrez Actions de page. Assurez-vous que Actions de page est activé. Puis activez Se connecter avec le serveur MCP.

Si Actions de page est désactivé, GitBook désactive ~gitbook/mcp et le point de terminaison renvoie 404.

Se connecter avec le serveur MCP contrôle uniquement si GitBook affiche le lien vers le serveur MCP dans le menu des actions de page.

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

Confidentialité et accès

Assurez-vous d’utiliser le bon format d’URL. Utilisez /~gitbook/mcp pour les sites publics, les sites à lien de partage où tout le contenu publié est exposé, ou les sites entièrement authentifiés qui utilisent la découverte MCP et OAuth. Utilisez /~gitbook/mcp/auth pour les sites partiellement authentifiés avec du contenu public ou via lien de partage.

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 la supprime seulement de la table des matières 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 parvient pas à se connecter :

• Confirmez que votre site publié est accessible.

• Confirmez que l’URL se termine par /~gitbook/mcp.

• Si le site utilise l’authentification, utilisez un client qui prend en charge le spécification d’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 l’accès authentifié, le serveur MCP à /~gitbook/mcp utilise la même authentification. Les clients MCP qui prennent en charge le 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 des clients (DCR).

Si votre site utilise plutôt des liens de partage, MCP fonctionne toujours. Utilisez l’URL complète du site à lien de partage, puis ajoutez /~gitbook/mcp.

GitBook ne prend pas en charge les sites à lien de partage uniquement ni les sites qui utilisent des jetons d’authentification de visiteur transmis sous forme d’en-têtes statiques pour l’authentification MCP.

Si votre site utilise l’accès authentifié, le serveur MCP utilise les mêmes règles d’accès. Les sites publics restent publics. Les sites protégés nécessitent la même connexion.

Les clients MCP pris en charge — y compris Claude — suivent le spécification d’autorisation MCP pour se connecter.

1

Découvrir le serveur OAuth

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

2

Enregistrer un client avec DCR

Le client enregistre un client OAuth avec l’enregistrement dynamique des clients.

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

3

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 site de documentation.

4

Échanger le code contre un jeton

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

5

Réutiliser le jeton

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

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

• 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é.