> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/docs-as-code/gitbook-mcp.md).

# GitBook MCP

Connectez des assistants de codage IA à GitBook afin qu’ils puissent créer des sites, ouvrir des demandes de modification et éditer du contenu via l’API de GitBook

GitBook met à disposition un serveur MCP qui permet aux outils d’IA d’interagir avec 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 modification, rédiger du contenu, modifier des pages et restructurer la documentation.

<p align="center">Installez nos plugins officiels :</p>

<p align="center"><a href="https://claude.ai/directory/connectors/gitbook-mcp" class="button secondary" data-icon="claude">Installer le plugin Claude</a> <a href="https://chatgpt.com/apps/gitbook/asdk_app_6a576f075ec4819196c203b7049542be" class="button secondary" data-icon="openai">Installer le plugin ChatGPT</a> <a href="https://cursor.com/marketplace/gitbook" class="button secondary" data-icon="cursor">Installer le plugin Cursor</a></p>

{% hint style="info" %}
Besoin d’un serveur MCP en lecture seule pour un site de documentation publié ? GitBook en crée un automatiquement pour vous — consultez [Serveurs MCP pour la documentation publiée](https://gitbook.com/docs/documentation/fr/ai-for-your-readers/mcp-servers-for-published-docs.md) pour en savoir plus.
{% endhint %}

## Le point de terminaison MCP de GitBook

Configurez votre client MCP avec l’adresse suivante :

```http
https://mcp.gitbook.com/mcp
```

{% hint style="info" %}
L’ouverture de cette URL dans un navigateur renvoie une erreur. Utilisez-la dans un client MCP capable d’effectuer des requêtes HTTP.
{% endhint %}

## Connecter votre client

Ajoutez GitBook MCP au client de votre choix :

{% tabs %}
{% tab title="Claude" icon="claude" %}
Installez le plugin GitBook officiel pour Claude :

<a href="https://claude.ai/directory/connectors/gitbook-mcp" class="button secondary" data-icon="claude">Installer le plugin Claude</a>

Vous pouvez aussi ajouter le serveur depuis votre terminal :

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

Lancez ensuite Claude Code avec `claude` et exécutez `/mcp` pour terminer la connexion via le navigateur.

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

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

{% endtab %}

{% tab title="ChatGPT" icon="openai" %}
Installez le plugin GitBook officiel pour ChatGPT :

<a href="https://chatgpt.com/apps/gitbook/asdk_app_6a576f075ec4819196c203b7049542be" class="button secondary" data-icon="openai">Installer le plugin ChatGPT</a>

Vous pouvez aussi ajouter le serveur depuis votre terminal :

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

Connectez-vous ensuite dans le navigateur.

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

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

{% endtab %}

{% tab title="Cursor" icon="cursor" %}
Installez le plugin GitBook officiel pour Cursor :

<a href="https://cursor.com/marketplace/gitbook" class="button secondary" data-icon="cursor">Installer le plugin Cursor</a>

Vous pouvez aussi ajouter le serveur à `~/.cursor/mcp.json`, ou à votre projet dans `.cursor/mcp.json`:

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

Connectez-vous ensuite lorsque Cursor vous y invite.
{% endtab %}

{% tab title="VS Code" icon="vscode" %}
Ajoutez le serveur à `.vscode/mcp.json` dans votre espace de travail :

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

Démarrez-le ensuite depuis la vue MCP et connectez-vous.
{% endtab %}

{% tab title="Autres" %}
Tout client compatible avec MCP peut se connecter via HTTP en flux continu.

Configurez-le avec l’adresse suivante :

```
https://mcp.gitbook.com/mcp
```

GitBook prend uniquement en charge le protocole HTTP avec flux continu. `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 plutôt un jeton d’accès personnel, transmettez-le comme jeton porteur :

```http
Authorization: Bearer <YOUR_PAT>
```

{% endtab %}
{% endtabs %}

## Authentifier GitBook MCP

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

{% tabs %}
{% tab title="OAuth" %}
Configurez votre client avec l’URL du serveur MCP. Le client détecte le serveur d’autorisation, s’enregistre et ouvre automatiquement le processus de connexion dans le navigateur.

Si vous utilisez OAuth, n’ajoutez pas manuellement de jeton porteur. Le client en obtient un lors de la connexion.
{% endtab %}

{% tab title="Jeton d’accès personnel" %}
Pour éviter le processus dans le navigateur, transmettez votre jeton comme jeton porteur :

```http
Authorization: Bearer <YOUR_PAT>
```

Vous pouvez créer un jeton d’accès personnel dans vos [paramètres de développeur](https://app.gitbook.com/account/developer).

Utilisez cette méthode pour les configurations par script ou lorsque votre client gère déjà les secrets localement.
{% endtab %}
{% endtabs %}

## Utiliser le MCP de GitBook

Vous configurez GitBook pour la première fois ? Redirigez votre agent vers [Configurer GitBook](https://gitbook.com/docs/documentation/fr/setup.md) à la place.

{% prompt description="Create and configure a new docs site." %}

```markdown
À l’aide des outils MCP de GitBook, crée un nouveau site de documentation pour moi.

1. Liste mes organisations et demande-moi laquelle utiliser avant de créer quoi que ce soit.
2. Demande-moi à quoi servira le site et de quels contenus je dispose (dossier, dépôt ou simple description). Si je t’indique une source, résume ce que tu y trouves pour que je puisse confirmer que c’est correct.
3. Présente-moi un plan succinct — nom du site, espaces, structure des pages — et attends mon accord.
4. Crée le site, ajoute le contenu et publie-le. Récupère ensuite l’URL publique pour vérifier qu’elle fonctionne et me la communiquer.
```

{% endprompt %}

{% prompt description="Open a change request and draft content." %}

```markdown
À l’aide des outils MCP de GitBook, rédige du nouveau contenu pour ma documentation dans une demande de modification — ne modifie rien dans le contenu publié.

1. Liste mes organisations et mes sites, puis demande-moi dans quel espace travailler.
2. Demande-moi quels sujets le contenu doit couvrir, puis ouvre une demande de modification et rédige les pages correspondantes.
3. Adapte-toi au ton et à la structure de mes pages existantes — commence par en lire quelques-unes.
4. Une fois terminé, communique-moi le lien d’aperçu de la demande de modification pour que je puisse la vérifier et la fusionner dans GitBook.
```

{% endprompt %}

{% prompt description="Move, rename, or restructure pages across a site." %}

```markdown
À l’aide des outils MCP de GitBook, aide-moi à restructurer mon site de documentation.

1. Liste mes organisations et mes sites, demande-moi lequel choisir, puis récupère sa structure actuelle et présente-la-moi.
2. Demande-moi ce que je souhaite modifier, puis propose la nouvelle structure sous la forme d’un arbre avant/après simple — ne déplace rien avant d’avoir obtenu mon approbation.
3. Applique les modifications en préservant autant que possible les URL et les liens internes ; signale tout élément qui risque de ne plus fonctionner.
4. Présente-moi la structure finale ainsi que la demande de modification ou le résultat publié, afin que je puisse vérifier.
```

{% endprompt %}

## Limites d’utilisation

Actuellement, le MCP de GitBook n’impose aucun quota d’utilisation lié à votre forfait, y compris le forfait gratuit. Il appelle l’API GitBook avec votre jeton ; la limite de débit de l’API s’applique donc : 5 000 requêtes par heure et par jeton. Les appels de lecture et d’écriture sont comptabilisés de la même manière.

* Un appel à un outil MCP peut entraîner plusieurs requêtes à l’API : la limite ne correspond donc pas exactement à 5 000 appels d’outils.
* L’invitation de membres est limitée à 2 invitations par minute.
* Au-delà de cette limite, un appel échoue avec une erreur « limite de débit dépassée » qui indique le nombre de secondes à attendre avant de réessayer.

Votre forfait détermine toujours les actions possibles. Si un appel nécessite une fonctionnalité non incluse dans votre forfait, GitBook le refuse et fournit un lien pour passer à un forfait supérieur, comme dans l’application.

## Différences entre le MCP de GitBook et le MCP de la documentation publiée

GitBook propose deux types d’utilisation du MCP :

* [**Les serveurs MCP pour la documentation publiée**](https://gitbook.com/docs/documentation/fr/ai-for-your-readers/mcp-servers-for-published-docs.md) donnent aux outils d’IA un accès en lecture seule au contenu publié.
* **GitBook MCP** permet aux outils d’IA d’accéder à votre contenu et à vos workflows via l’API GitBook.

Utilisez le MCP de la documentation publiée pour permettre aux lecteurs et aux utilisateurs finaux de trouver des informations dans votre documentation publiée.

Utilisez le MCP de GitBook pour permettre aux agents de votre équipe de modifier et de gérer votre documentation au moyen de workflows automatisés.

## FAQ

<details>

<summary>Quel protocole de transport le MCP de GitBook prend-il en charge lorsque je connecte un client MCP ?</summary>

Le MCP de GitBook prend en charge HTTP diffusé en continu.

GitBook MCP ne prend pas en charge `stdio` ni `SSE`.

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

</details>

<details>

<summary>Dois-je ajouter un jeton Bearer lorsque je connecte un client au MCP de GitBook ?</summary>

Vous ne devez ajouter un jeton bearer que si vous vous authentifiez avec un [jeton d’accès personnel](https://app.gitbook.com/account/developer).

Si vous utilisez OAuth, n’ajoutez pas de jeton Bearer manuellement. Votre client le reçoit pendant le processus de connexion.

</details>

<details>

<summary>Pourquoi rien ne se passe-t-il après l’ajout du serveur MCP de GitBook à mon client ?</summary>

C'est attendu dans certains clients MCP.

L’ajout d’un serveur ne fait souvent qu’enregistrer la configuration. Certains clients ne lancent l’authentification qu’à la première connexion, à l’affichage de la liste des outils ou à l’ouverture du panneau MCP.

</details>

<details>

<summary>Pourquoi rien ne se passe-t-il après que j’ai cliqué sur « Authentifier » pour le MCP de GitBook ?</summary>

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

Ce délai peut être plus long si la connexion réseau est lente ou instable.

Si aucun onglet de navigateur ne s’ouvre au bout d’environ une minute, vérifiez votre connexion réseau, les paramètres des fenêtres pop-up et votre navigateur par défaut.

</details>

<details>

<summary>Comment se déroule le processus d’authentification du MCP de GitBook ?</summary>

Lorsque l’authentification fonctionne, le processus se déroule généralement ainsi :

1. Le client se connecte au serveur MCP.
2. Votre navigateur ouvre le processus de connexion.
3. Vous vous connectez et autorisez l’accès.
4. Le client indique que le serveur est connecté ou rend les outils MCP disponibles.

</details>

<details>

<summary>Comment savoir si mon client s’est correctement authentifié auprès du MCP de GitBook ?</summary>

L’indication exacte dépend de votre client, mais le résultat est généralement évident.

La plupart des clients masquent l’invite d’authentification, indiquent que le serveur est connecté ou permettent à l’assistant de répertorier et d’appeler les outils MCP.

Si le bouton **S’authentifier** reste visible et qu’aucun outil n’apparaît, le processus ne s’est probablement pas terminé.

</details>

<details>

<summary>Que vérifier si l’authentification du MCP de GitBook semble toujours bloquée ?</summary>

Procédez aux vérifications suivantes :

* Vérifiez que l’URL du serveur pointe vers le point de terminaison MCP.
* Confirmez que le client utilise le transport HTTP.
* Réessayez lorsque le réseau est stable.
* Supprimez le serveur, puis ajoutez-le à nouveau si le client a mis en cache un état d’échec.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/fr/docs-as-code/gitbook-mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
