Serveurs MCP pour la documentation publiée

La documentation publiée sur GitBook génère automatiquement un serveur MCP que vous pouvez connecter à des outils externes

Chaque site GitBook publié inclut automatiquement un serveur Model Context Protocol (MCP).

Cela permet aux assistants IA d’accéder directement au contenu de votre documentation, ce qui facilite la réponse aux questions à l’aide de vos docs pour des outils comme Claude Desktop, Cursor et les extensions VS Code.

Le serveur MCP est disponible à l’URL de votre site avec /~gitbook/mcp ajouté à la fin. Par exemple, la documentation de GitBook se trouve à https://gitbook.com/docs, donc le serveur MCP se trouve à https://gitbook.com/docs/~gitbook/mcp.

Visiter cette URL dans votre navigateur renverra une erreur. À la place, vous pouvez la partager avec des outils capables d’effectuer des requêtes HTTP, comme des LLM ou des IDE.

Connecter un assistant IA

1

Trouvez l’URL de votre serveur MCP

Prenez l’URL de votre site GitBook publié et ajoutez /~gitbook/mcp à la fin.

2

Configurez 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

Commencez à utiliser votre documentation

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

Exigences

Votre site GitBook doit être publié pour que le serveur MCP fonctionne. Le serveur fournit uniquement l’accès au contenu publié, jamais aux brouillons ni aux modifications non publiées.

Votre outil d’IA doit prendre en charge le Model Context Protocol et pouvoir effectuer des requêtes HTTP vers votre site. La plupart des assistants IA modernes qui prennent en charge MCP fonctionneront avec les serveurs de GitBook.

Le serveur MCP respecte les paramètres de visibilité de votre site. Si votre site est सार्वजनिक, le serveur MCP est accessible publiquement. Si votre site nécessite une authentification, le serveur MCP aussi.

Le serveur MCP utilise uniquement le transport HTTP. Les outils qui nécessitent un transport stdio ou SSE ne sont pas pris en charge.

Activer ou désactiver la liaison MCP facile

Dans la Actions de page section de vos Personnalisation paramètres, vous pouvez activer l’option Se connecter avec le serveur MCP . Cela 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.

Confidentialité et accès

Le serveur MCP fournit uniquement un accès en lecture seule à votre documentation publiée. Il n’expose aucune donnée utilisateur, aucune analyse ni aucune information interne de GitBook.

Seule la dernière version publiée de votre contenu est disponible via le serveur MCP. Le contenu de brouillon et les modifications non publiées restent privés jusqu’à leur publication.

Problèmes courants

Si votre assistant IA ne parvient pas à se connecter à votre serveur MCP, vérifiez d’abord que votre site GitBook est publié et accessible. L’URL doit répondre lorsque vous la visitez dans un navigateur.

Assurez-vous d’utiliser le bon format d’URL avec /~gitbook/mcp à la fin. L’URL doit correspondre exactement à ce que vous voyez lorsque vous visitez votre site publié.

Certains outils d’IA nécessitent des méthodes de transport spécifiques ou ont des exigences particulières de configuration MCP. Consultez la documentation de votre outil d’IA pour obtenir les instructions de configuration MCP.