> 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/ai-for-your-readers/mcp-servers-for-published-docs.md).

# Serveurs MCP pour la documentation publiée

La documentation publiée sur GitBook génère automatiquement un serveur MCP que vous pouvez connecter à des outils externes

Chaque site GitBook publié inclut automatiquement un serveur Model Context Protocol (MCP).

Les outils d’IA peuvent l’utiliser pour lire directement la documentation publiée. Cela fonctionne avec Claude, Claude Code, Cursor, Codex, VS Code et d’autres clients MCP.

### Choisir le bon point de terminaison <a href="#choose-the-right-endpoint" id="choose-the-right-endpoint"></a>

Votre serveur MCP est accessible à l’URL de votre site publié, suivie de l’un de ces points de terminaison :

| Si votre site est...                                                                                      | Utilisez cette URL                  | Exemple                                      |
| --------------------------------------------------------------------------------------------------------- | ----------------------------------- | -------------------------------------------- |
| Public, partagé via un lien de partage avec tout le contenu publié accessible, ou entièrement authentifié | `{docs-site-url}/~gitbook/mcp`      | `https://gitbook.com/docs/~gitbook/mcp`      |
| Partiellement authentifié, avec certains contenus publics ou accessibles via un lien de partage           | `{docs-site-url}/~gitbook/mcp/auth` | `https://gitbook.com/docs/~gitbook/mcp/auth` |

Pour les sites entièrement authentifiés, les clients se connectent via la découverte MCP et OAuth. Pour en savoir plus, consultez le [Flux d’autorisation MCP](https://modelcontextprotocol.io/docs/tutorials/security/authorization#the-authorization-flow-step-by-step).

{% hint style="info" %}
Si vous ouvrez cette URL dans un navigateur, une erreur s’affichera. Utilisez-la dans un outil capable d’effectuer des requêtes HTTP, comme un assistant IA ou un IDE.
{% endhint %}

{% hint style="info" %}
**Se connecter au serveur MCP** doit figurer dans la liste **Actions activées** liste de **Personnalisation du site** → **Actions de la page** pour que le serveur MCP fonctionne. Si vous le déplacez vers **Actions disponibles**, ou désactivez **Actions de la page**, `~gitbook/mcp` renvoie `404`.
{% endhint %}

### Connecter un outil d’IA

{% stepper %}
{% step %}

#### Trouver l’URL de votre serveur MCP

Commencez par l’URL de votre documentation publiée. Ajoutez ensuite le point de terminaison à partir de [Choisir le bon point de terminaison](#choose-the-right-endpoint).

Par exemple, si le site de votre documentation est `https://gitbook.com/docs`, l’URL de votre serveur MCP est `https://gitbook.com/docs/~gitbook/mcp`.
{% endstep %}

{% step %}

#### Ajouter le serveur à votre outil

Utilisez l’onglet correspondant à votre outil ci-dessous. Remplacez `{docs-site-url}` par l’URL de votre propre site publié.

Si votre site utilise le second point de terminaison, remplacez `/~gitbook/mcp` par `/~gitbook/mcp/auth`.
{% endstep %}

{% step %}

#### Poser une question de test

Exécutez l’une des invites dans [Essayer](#try-it). Si l’outil peut rechercher dans votre documentation et répondre à partir de son contenu, la connexion fonctionne.
{% endstep %}
{% endstepper %}

{% tabs %}
{% tab title="Claude" %}
Ces étapes fonctionnent dans Claude sur le Web et dans Claude Desktop.

Ouvrez **Paramètres** → **Connecteurs**.

Cliquez sur **Ajouter un connecteur personnalisé**. Collez ensuite l’URL de votre serveur MCP, par exemple `{docs-site-url}/~gitbook/mcp`.

Exemple :

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

Si les connecteurs distants ne s’affichent pas dans Claude, votre forfait actuel ou le déploiement en cours ne les prend peut-être pas encore en charge.
{% endtab %}

{% tab title="Claude Code" %}
Exécutez cette commande dans votre terminal :

```shell
claude mcp add --transport http my-docs https://gitbook.com/docs/~gitbook/mcp
```

Remplacez `my-docs` par le nom de serveur de votre choix.

Si votre site utilise le point de terminaison public authentifié, remplacez le suffixe de l’URL par `/~gitbook/mcp/auth`.
{% endtab %}

{% tab title="Cursor" %}
Ouvrez **Paramètres** → **MCP**.

Cliquez sur **Ajouter un nouveau serveur MCP**. Puis collez `{docs-site-url}/~gitbook/mcp`.

Vous pouvez également ajouter ce fichier dans `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "my-docs": {
      "url": "https://gitbook.com/docs/~gitbook/mcp"
    }
  }
}
```

Remplacez `my-docs` par le nom de votre choix pour le serveur.
{% endtab %}

{% tab title="Codex" %}
Utilisez la `commande codex mcp add` ou ajoutez le serveur à votre `config.toml`.

Exemple de commande :

```shell
codex mcp add my-docs https://gitbook.com/docs/~gitbook/mcp
```

Exemple de configuration :

```toml
[mcp_servers.my-docs]
url = "https://gitbook.com/docs/~gitbook/mcp"
```

Remplacez `my-docs` par le nom de votre choix pour le serveur.
{% endtab %}

{% tab title="VS Code (Copilot)" %}
Ouvrez votre fichier `mcp.json` Puis ajoutez une entrée de serveur avec le transport HTTP :

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

Remplacez `my-docs` par le nom de votre choix pour le serveur.
{% endtab %}
{% endtabs %}

### Essayer <a href="#try-it" id="try-it"></a>

Collez l’une de ces instructions dans votre assistant :

* `Using the my-docs MCP server, how do I set up authenticated access?`
* `Search my docs for everything about custom domains and summarize the steps.`
* `List the tools exposed by the my-docs MCP server. Then use them to find the page about page actions.`

Si vous utilisez un outil agentique, vous pouvez également lui fournir cette instruction de configuration :

```
Ajoute un serveur MCP nommé my-docs utilisant le transport HTTP à l’adresse https://gitbook.com/docs/~gitbook/mcp. Vérifie ensuite la connexion en listant les outils disponibles.
```

### Prérequis

Pour utiliser un serveur MCP :

* Votre site doit être publié. Le serveur MCP expose uniquement le contenu publié.
* **Accéder à votre documentation via MCP** doit être activé dans **Étendre → Accès MCP**.
* **Se connecter au serveur MCP** doit figurer dans la liste **Actions activées** dans **Personnalisation du site** → **Actions de la page**.
* Votre outil doit prendre en charge MCP via HTTP.
* Si votre site utilise un [accès authentifié](https://gitbook.com/docs/documentation/fr/publish/site-audience/authenticated-access.md), votre outil doit prendre en charge la [spécification d’autorisation MCP](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization).
* Si votre site utilise des liens de partage, utilisez l’URL du site du lien de partage, puis ajoutez le point de terminaison indiqué dans [Choisir le bon point de terminaison](#choose-the-right-endpoint).
* GitBook prend uniquement en charge le transport HTTP. `stdio` et `SSE` ne sont pas pris en charge.

### Activer le serveur MCP

Ouvrez **Étendre → Accès MCP** sur votre site, puis activez **Accéder à votre documentation via MCP**. Cet écran affiche également le point de terminaison de votre site pour **MCP** et le point de terminaison MCP **authentifié**.

Ensuite, dans [Personnalisation du site](https://gitbook.com/docs/documentation/fr/manage-your-site/customization.md), ouvrez [Actions de page](https://gitbook.com/docs/documentation/fr/manage-your-site/customization/extra-configuration.md#page-actions). Assurez-vous que **Actions de page** est activé. Si **Se connecter au serveur MCP** se trouve sous **Actions disponibles**, faites-le glisser vers **Actions activées**.

Cela active le serveur MCP de votre site et ajoute un lien MCP copiable au menu des actions de la page. Le serveur et le lien vont de pair : si vous déplacez **Se connecter au serveur MCP** à nouveau vers **Actions disponibles** pour masquer le lien, GitBook désactive également le serveur MCP.

### Limites d’utilisation

Actuellement, les serveurs MCP pour la documentation publiée sont disponibles avec tous les forfaits et, dans les faits, ne sont soumis à aucune limite d’appels.

L’outil `askQuestion` utilise l’IA de votre site. Il n’est donc disponible que si l’IA est activée pour le site. Il cesse de fonctionner si l’IA de votre organisation est suspendue, par exemple lorsque les crédits d’IA sont épuisés. La recherche et la consultation des pages continuent de fonctionner.

### Confidentialité et accès

Utilisez le point de terminaison indiqué dans [Choisir le bon point de terminaison](#choose-the-right-endpoint).

Le serveur MCP fournit un accès en lecture seule à la documentation publiée.

Les pages masquées restent accessibles via MCP. Masquer une page la retire uniquement de la table des matières publiée.

Il n’expose jamais les données de compte, les statistiques ni les données internes de GitBook.

Il ne sert que la dernière version publiée. Les brouillons et les modifications non publiées restent privés.

### Dépannage

Si un outil ne parvient pas à se connecter :

* Vérifiez que votre site publié est accessible.
* Vérifiez que l’URL utilise le point de terminaison indiqué dans [Choisissez le bon point de terminaison](#choose-the-right-endpoint).
* Si le site utilise l’authentification, utilisez un client compatible avec la [spécification d’autorisation MCP](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization).
* Si l’outil nécessite `stdio` ou `SSE`, il ne fonctionnera pas avec GitBook.

### Utiliser MCP avec des sites authentifiés

Si votre site GitBook utilise l’ [accès authentifié](https://gitbook.com/docs/documentation/fr/publish/site-audience/authenticated-access.md), le serveur MCP à l’adresse `/~gitbook/mcp` utilise la même authentification. Les clients MCP compatibles avec la [spécification d’autorisation MCP](https://modelcontextprotocol.io/docs/tutorials/security/authorization) — notamment Claude et Claude Code — peuvent se connecter automatiquement à l’aide d’OAuth et de l’enregistrement dynamique des clients (DCR).

Si votre site utilise plutôt des liens de partage, utilisez l’URL complète du site du lien de partage, puis ajoutez le point de terminaison indiqué dans [Choisissez le bon point de terminaison](#choose-the-right-endpoint).

GitBook ne prend pas en charge les sites accessibles uniquement via un lien de partage ni les sites qui utilisent des jetons d’authentification des visiteurs transmis sous forme d’en-têtes statiques pour l’authentification MCP.

Les clients MCP pris en charge — notamment Claude — suivent la [spécification d’autorisation MCP](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization) pour se connecter.

{% stepper %}
{% step %}

#### Découvrir le serveur OAuth

Lors de la négociation MCP, le client découvre le serveur OAuth de votre site.
{% endstep %}

{% step %}

#### Enregistrer un client avec DCR

Le client enregistre un client OAuth à l’aide de l’enregistrement dynamique des clients.

Vous n’avez pas besoin de créer manuellement un ID client.
{% endstep %}

{% step %}

#### Se connecter avec le fournisseur d’authentification de votre site

Le client vous redirige vers le fournisseur d’authentification de votre site.

Vous vous connectez avec le même fournisseur que celui déjà utilisé par votre site de documentation.
{% endstep %}

{% step %}

#### Échanger le code contre un jeton

Après la connexion, le client échange le code d’autorisation contre un jeton d’accès.
{% endstep %}

{% step %}

#### Réutiliser le jeton

Le client envoie ce jeton avec les requêtes MCP suivantes jusqu’à son expiration.
{% endstep %}
{% endstepper %}

Ce flux fonctionne avec les systèmes d’authentification suivants :

* [Auth0](https://gitbook.com/docs/documentation/fr/publish/site-audience/authenticated-access/setting-up-auth0.md)
* [Azure AD](https://gitbook.com/docs/documentation/fr/publish/site-audience/authenticated-access/setting-up-azure-ad.md)
* [Okta](https://gitbook.com/docs/documentation/fr/publish/site-audience/authenticated-access/setting-up-okta.md)
* [AWS Cognito](https://gitbook.com/docs/documentation/fr/publish/site-audience/authenticated-access/setting-up-aws-cognito.md)
* [OIDC](https://gitbook.com/docs/documentation/fr/publish/site-audience/authenticated-access/setting-up-oidc.md)
* [Backend personnalisé](https://gitbook.com/docs/documentation/fr/publish/site-audience/authenticated-access/setting-up-a-custom-backend.md) avec une URL de secours configurée

{% hint style="warning" %}
L’authentification MCP ne prend pas en charge les sites qui s’appuient uniquement sur des jetons d’authentification statiques des visiteurs dans les en-têtes des requêtes.

Utilisez plutôt l’un des systèmes d’authentification ci-dessus.
{% endhint %}

Pour configurer cette option, commencez par [Accès authentifié](https://gitbook.com/docs/documentation/fr/publish/site-audience/authenticated-access.md) et [Activer l’accès authentifié](https://gitbook.com/docs/documentation/fr/publish/site-audience/authenticated-access/enabling-authenticated-access.md).


---

# 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/ai-for-your-readers/mcp-servers-for-published-docs.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.
