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 à votre contenu de documentation, facilitant ainsi la tâche d'outils comme Claude Desktop, Cursor et les extensions VS Code pour 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 est à https://gitbook.com/docs/~gitbook/mcp.

Visiter cette URL dans votre navigateur affichera une erreur. À la place, vous pouvez la partager avec des outils capables d'effectuer des requêtes HTTP, comme des LLM ou des environnements de développement.

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, vous devriez donc consulter la documentation de l'outil de votre choix pour savoir comment configurer un serveur MCP pour celui-ci.

3

Commencez à utiliser vos docs

Une fois connecté, votre assistant IA peut parcourir 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 ni 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 supportent 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 requiert une authentification, le serveur MCP en exigera également.

Le serveur MCP utilise uniquement le transport HTTP. Les outils nécessitant le 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 votre Personnalisation paramètres, vous pouvez activer le Se connecter avec le serveur MCP option. 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 la page.

Confidentialité et accès

Le serveur MCP fournit uniquement un accès en lecture à votre documentation publiée. Il n'expose aucune donnée utilisateur, statistique 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'à leur publication.

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 devrait répondre lorsque vous la visitez dans un navigateur.

Assurez-vous d'utiliser le format d'URL correct 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.