GitBook MCP

Connectez les assistants de codage IA à GitBook afin qu’ils puissent créer des sites, ouvrir des demandes de changement et modifier le contenu via l’API de GitBook

GitBook expose un serveur MCP qui permet aux outils d’IA d’agir sur le contenu de votre organisation.

Des outils comme Claude Code, Codex, Cursor et d’autres clients MCP peuvent l’utiliser pour créer et configurer des sites, ouvrir des demandes de changement, rédiger du contenu, modifier des pages et restructurer la documentation.

Pour connecter votre assistant de codage IA à MCP de GitBook, vous avez besoin de l’URL du serveur, d’une méthode d’authentification et d’un client MCP pris en charge. Les sections ci-dessous vous guident pas à pas.

Besoin d’un serveur MCP en lecture seule pour un site de documentation publié ? GitBook en crée un automatiquement pour vous — voir Serveurs MCP pour les docs publiées pour en savoir plus.

Point de terminaison MCP de GitBook

Pointez votre client MCP vers :

https://mcp.gitbook.com/mcp

L’ouverture de cette URL dans un navigateur renvoie une erreur. Utilisez-la dans un client MCP capable d’effectuer des requêtes HTTP.

Connectez votre client

Ajoutez GitBook MCP dans le client de votre choix :

Enregistrez le serveur dans votre terminal :

claude mcp add --transport http gitbook https://mcp.gitbook.com/mcp

Puis démarrez Claude Code avec claude et exécutez /mcp pour terminer la connexion dans le navigateur.

Si vous préférez un jeton d’accès personnel, transmettez-le comme en-tête d’autorisation :

claude mcp add --transport http gitbook https://mcp.gitbook.com/mcp \
  --header "Authorization: Bearer <YOUR_TOKEN>"

Ajoutez le serveur depuis votre terminal :

codex mcp add gitbook --url https://mcp.gitbook.com/mcp

Puis connectez-vous via le navigateur.

Pour utiliser à la place un jeton d’accès personnel, ajoutez ceci à ~/.codex/config.toml:

[mcp_servers.gitbook]
url = "https://mcp.gitbook.com/mcp"
bearer_token_env_var = "GITBOOK_MCP_TOKEN"
enabled = true

Ajoutez le serveur à ~/.cursor/mcp.json, ou à votre projet dans .cursor/mcp.json:

{
  "mcpServers": {
    "gitbook": {
      "url": "https://mcp.gitbook.com/mcp"
    }
  }
}

Puis connectez-vous lorsque Cursor vous y invite.

Ajoutez le serveur à .vscode/mcp.json dans votre espace de travail :

{
  "servers": {
    "gitbook": {
      "type": "http",
      "url": "https://mcp.gitbook.com/mcp"
    }
  }
}

Puis lancez-le depuis l’affichage MCP et connectez-vous.

Tout client compatible MCP peut se connecter via HTTP streamable.

Pointez-le vers :

https://mcp.gitbook.com/mcp

GitBook ne prend en charge que HTTP streamable. stdio et SSE ne sont pas pris en charge.

Si vous utilisez OAuth, vous n’avez généralement pas besoin de champs d’authentification supplémentaires.

Si vous utilisez à la place un jeton d’accès personnel, envoyez-le comme jeton Bearer :

Authorization: Bearer <YOUR_PAT>

Authentifier le MCP de GitBook

GitBook MCP prend en charge deux méthodes d’authentification : OAuth et les jetons d’accès personnels.

Pointez votre client vers l’URL du serveur MCP. Le client détecte le serveur d’autorisation, s’enregistre et ouvre automatiquement le flux de connexion dans le navigateur.

Si vous utilisez OAuth, n’ajoutez pas manuellement de jeton Bearer. Le client en obtient un lors de la connexion.

Pour éviter le flux du navigateur, envoyez votre jeton comme jeton Bearer :

Authorization: Bearer <YOUR_PAT>

Vous pouvez créer un jeton d’accès personnel dans vos paramètres de développement.

Utilisez cela pour les configurations automatisées, ou lorsque votre client gère déjà les secrets localement.

Utiliser le MCP de GitBook

Create and configure a new docs site.

Open a change request and draft content.

Move, rename, or restructure pages across a site.

La différence entre le MCP de GitBook et le MCP des docs publiées

GitBook propose deux modèles MCP :

Serveurs MCP pour les docs publiées donne aux outils d’IA un accès en lecture seule au contenu publié.
GitBook MCP donne aux outils d’IA accès à votre contenu et à vos flux de travail via l’API GitBook.

Utilisez le MCP des docs publiées lorsque vous voulez que les lecteurs de la documentation et les utilisateurs finaux trouvent des informations dans vos docs publiées.

Utilisez GitBook MCP lorsque vous voulez que les agents de votre équipe modifient et gèrent votre documentation via des flux de travail automatisés.

FAQ

Quel transport GitBook MCP prend-il en charge lorsque je connecte un client MCP ?

GitBook MCP prend en charge HTTP streamable.

GitBook MCP ne prend pas en charge stdio ou SSE.

Si votre client demande des champs supplémentaires, vous pouvez généralement les laisser vides.

Dois-je ajouter un jeton Bearer lorsque je connecte un client à GitBook MCP ?

Vous n’avez besoin d’ajouter un jeton Bearer que si vous vous authentifiez avec un jeton d’accès personnel.

Si vous utilisez OAuth, n’ajoutez pas manuellement de jeton Bearer. Votre client l’obtient pendant le flux de connexion.

Pourquoi rien ne se passe après avoir ajouté le serveur MCP de GitBook à mon client ?

Oui. C’est attendu dans certains clients MCP.

L’ajout d’un serveur enregistre souvent seulement la configuration. Certains clients ne lancent l’authentification que lorsqu’ils se connectent pour la première fois, listent les outils ou ouvrent le panneau MCP.

Pourquoi rien ne se passe après avoir cliqué sur Authentifier pour GitBook MCP ?

Certains clients ouvrent le flux de connexion dans le navigateur après un court délai.

Ce délai peut être plus long sur un réseau lent ou instable.

Si aucun onglet de navigateur ne s’ouvre après environ une minute, vérifiez votre réseau, les paramètres des fenêtres contextuelles et le navigateur par défaut.

Que se passe-t-il pendant le flux d’authentification de GitBook MCP ?

Lorsque l’authentification fonctionne, le flux ressemble généralement à ceci :

Le client se connecte au serveur MCP.
Votre navigateur ouvre le flux de connexion.
Vous vous connectez et approuvez l’accès.
Le client affiche le serveur comme connecté, ou les outils MCP deviennent disponibles.

Comment puis-je savoir si mon client s’est authentifié avec succès auprès de GitBook MCP ?

Le signal exact dépend de votre client, mais le résultat est généralement clair.

La plupart des clients suppriment l’invite d’authentification, affichent le serveur comme connecté, ou permettent à l’assistant de lister et d’appeler les outils MCP.

Si le Authentifier bouton reste visible et qu’aucun outil n’apparaît, il est probable que le flux n’ait pas abouti.

Que dois-je vérifier si l’authentification de GitBook MCP semble toujours bloquée ?

Essayez ces vérifications :

Confirmez que l’URL du serveur pointe vers le point de terminaison MCP.
Confirmez que le client utilise le transport HTTP.
Réessayez sur un réseau stable.
Supprimez puis rajoutez le serveur si le client a mis en cache un état d’échec.

Mis à jour il y a 6 jours

Ce contenu vous a-t-il été utile ?