Serveurs MCP pour docs publiés

Les docs 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).

Cela permet aux assistants IA d’accéder directement au contenu de votre documentation, facilitant ainsi aux outils comme Claude Desktop, Cursor et les extensions VS Code de répondre aux questions en utilisant vos docs.

Le serveur MCP est disponible à l’URL de votre site avec /~gitbook/mcp ajouté. 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.

Connexion d’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 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, donc vous devriez consulter la documentation de l’outil choisi pour voir comment configurer un serveur MCP pour celui-ci.

3

Commencez à utiliser vos docs

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.

Exigences

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

Votre outil IA doit prendre en charge le Model Context Protocol et être capable d’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 public, le serveur MCP est accessible publiquement. Si votre site nécessite une authentification, le serveur MCP l’exigera également.

Activer ou désactiver la liaison facile au MCP

Dans le Actions de page section de votre Personnalisation paramètres, vous pouvez activer l’option Se connecter au 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 ne fournit qu’un accès en lecture seule à votre documentation publiée. Il n’expose aucune donnée utilisateur, analytics ou information interne de GitBook.

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

Problèmes courants

Si votre assistant IA ne peut 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 IA exigent des méthodes de transport spécifiques ou ont des exigences particulières de configuration MCP. Consultez la documentation de votre outil IA pour les instructions de configuration MCP.