> 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/getting-started/ai-documentation/gitbook-mcp.md).

# GitBook MCP

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.

{% 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 — voir [Serveurs MCP pour les docs publiées](/docs/documentation/fr/ia-et-recherche/mcp-servers-for-published-docs.md) pour en savoir plus.
{% endhint %}

## Point de terminaison MCP de GitBook

Pointez votre client MCP vers :

```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 %}

## Connectez votre client

Ajoutez GitBook MCP dans le client de votre choix :

{% tabs %}
{% tab title="Claude Code" icon="claude" %}
Enregistrez le serveur dans votre terminal :

```bash
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 :

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

{% endtab %}

{% tab title="Codex" icon="openai" %}
Ajoutez le serveur depuis votre terminal :

```bash
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`:

```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" %}
Ajoutez le serveur à `~/.cursor/mcp.json`, ou à votre projet dans `.cursor/mcp.json`:

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

Puis connectez-vous 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"
    }
  }
}
```

Puis lancez-le depuis l’affichage MCP et connectez-vous.
{% endtab %}

{% tab title="Autre" %}
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 :

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

{% endtab %}
{% endtabs %}

## Authentifier le MCP de GitBook

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

{% tabs %}
{% tab title="OAuth" %}
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.
{% endtab %}

{% tab title="Jeton d’accès personnel" %}
Pour éviter le flux du navigateur, envoyez votre jeton comme jeton Bearer :

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

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

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

## Utiliser le MCP de GitBook

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

```markdown
En utilisant les outils MCP de GitBook, créez pour moi un nouveau site de documentation.

1. Listez mes organisations et confirmez laquelle utiliser avant de créer quoi que ce soit.
2. Demandez à quoi sert le site et quel contenu j’ai (dossier, dépôt, ou simple description). Si je vous pointe vers une source, reformulez ce que vous y trouvez pour que je puisse confirmer que c’est correct.
3. Montrez-moi un bref plan — nom du site, espaces, structure des pages — et attendez mon oui.
4. Créez le site, ajoutez le contenu et publiez. Ensuite, récupérez l’URL en direct pour confirmer que tout fonctionne et partagez-la avec moi.
```

{% endprompt %}

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

```markdown
En utilisant les outils MCP de GitBook, rédigez du nouveau contenu pour ma documentation dans une demande de changement — ne modifiez rien en direct.

1. Listez mes organisations et mes sites, et confirmez dans quel espace travailler.
2. Demandez-moi ce que le contenu doit couvrir, puis ouvrez une demande de changement et rédigez les pages à l’intérieur.
3. Faites correspondre le ton et la structure de mes pages existantes — lisez-en quelques-unes d’abord.
4. Une fois terminé, partagez le lien d’aperçu de la demande de changement afin que je puisse la relire et la fusionner dans GitBook.
```

{% endprompt %}

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

```markdown
En utilisant les outils MCP de GitBook, aidez-moi à restructurer mon site de documentation.

1. Listez mes organisations et mes sites, confirmez lequel, puis récupérez sa structure actuelle et montrez-la-moi.
2. Demandez-moi ce que je veux modifier, puis proposez la nouvelle structure sous forme d’arborescence simple avant/après — ne déplacez rien avant mon approbation.
3. Appliquez les changements en conservant autant que possible les URL et les liens internes ; signalez tout ce qui cassera.
4. Montrez-moi la structure finale ainsi que la demande de changement ou le résultat en direct pour vérification.
```

{% endprompt %}

## 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**](/docs/documentation/fr/ia-et-recherche/mcp-servers-for-published-docs.md) 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.&#x20;

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

<details>

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

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.

</details>

<details>

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

Vous n’avez besoin d’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 manuellement de jeton Bearer. Votre client l’obtient pendant le flux de connexion.

</details>

<details>

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

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.

</details>

<details>

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

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.

</details>

<details>

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

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

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

</details>

<details>

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

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.

</details>

<details>

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

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.

</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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/fr/getting-started/ai-documentation/gitbook-mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.