Serveurs MCP pour les docs publiées

Les docs publiées 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 les outils comme Claude Desktop, Cursor et les extensions VS Code à répondre aux questions en utilisant vos docs.

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 est à https://gitbook.com/docs/~gitbook/mcp.

Visiter cette URL dans votre navigateur entraînera 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 dans les 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 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 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.

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 le lien MCP facile

Dans la section Actions de la page de vos Paramètres de personnalisation 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 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, analyse ou information interne de GitBook.

Seule la dernière version publiée de votre contenu est disponible via le serveur MCP. Les brouillons 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 doit 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 requièrent 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.