> 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/ia-et-recherche/mcp-servers-for-published-docs.md).
# Serveurs MCP pour les docs publiées
Chaque site GitBook publié inclut automatiquement un serveur Model Context Protocol (MCP).
Les outils d’IA peuvent l’utiliser pour lire directement votre documentation publiée. Cela fonctionne avec Claude, Claude Code, Cursor, Codex, VS Code et d’autres clients MCP.
### Choisissez le bon point de terminaison
Votre serveur MCP se trouve à l’URL de votre site publié, plus l’un de ces points de terminaison :
| Si votre site est... | Utilisez cette URL | Exemple |
| -------------------------------------------------------------------------------------------------- | ----------------------------------- | -------------------------------------------- |
| Public, partagé par lien de partage avec tout le contenu publié exposé, ou entièrement authentifié | `{docs-site-url}/~gitbook/mcp` | `https://gitbook.com/docs/~gitbook/mcp` |
| Partiellement authentifié, avec du contenu public ou partagé par lien de partage encore exposé | `{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 plus de détails, 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, vous verrez une erreur. Utilisez-la dans un outil capable d’effectuer des requêtes HTTP, comme un assistant IA ou un IDE.
{% endhint %}
{% hint style="info" %}
**Actions de page** doivent être activées pour que le serveur MCP fonctionne. Si vous désactivez **Personnalisation du site** → **Actions de page**, GitBook désactive `~gitbook/mcp` et le point de terminaison renvoie `404`. **Se connecter avec le serveur MCP** contrôle uniquement si le lien MCP apparaît dans le menu des actions de page.
{% endhint %}
### Connecter un outil d’IA
{% stepper %}
{% step %}
#### Trouvez l’URL de votre serveur MCP
Commencez avec l’URL de votre documentation publiée. Ajoutez ensuite le point de terminaison depuis [Choisissez le bon point de terminaison](#choose-the-right-endpoint).
Par exemple, si votre site de documentation est `https://gitbook.com/docs`, l’URL de votre serveur MCP est `https://gitbook.com/docs/~gitbook/mcp`.
{% endstep %}
{% step %}
#### Ajoutez 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 deuxième point de terminaison, remplacez `/~gitbook/mcp` par `/~gitbook/mcp/auth`.
{% endstep %}
{% step %}
#### Posez une question de test
Exécutez l’une des invites dans [Essayez-le](#try-it). Si l’outil peut rechercher dans votre documentation et répondre à partir de celle-ci, 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é**. Puis collez l’URL de votre serveur MCP, par exemple `{docs-site-url}/~gitbook/mcp`.
Exemple :
```
https://gitbook.com/docs/~gitbook/mcp
```
Si Claude n’affiche pas les connecteurs distants, votre offre actuelle ou votre déploiement 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 aussi ajouter ce fichier dans `.cursor/mcp.json`:
```json
{
"mcpServers": {
"my-docs": {
"url": "https://gitbook.com/docs/~gitbook/mcp"
}
}
}
```
Remplacez `my-docs` avec le nom de votre propre serveur si vous le souhaitez.
{% 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` avec le nom de votre propre serveur si vous le souhaitez.
{% endtab %}
{% tab title="VS Code (Copilot)" %}
Ouvrez votre `mcp.json` fichier. Ajoutez ensuite une entrée de serveur avec transport HTTP :
```json
{
"servers": {
"my-docs": {
"type": "http",
"url": "https://gitbook.com/docs/~gitbook/mcp"
}
}
}
```
Remplacez `my-docs` avec le nom de votre propre serveur si vous le souhaitez.
{% endtab %}
{% endtabs %}
### Essayez-le
Collez l’une de ces invites dans votre assistant :
* `Avec le serveur MCP my-docs, comment configurer un accès authentifié ?`
* `Recherchez dans ma documentation tout ce qui concerne les domaines personnalisés et résumez les étapes.`
* `Listez les outils exposés par le serveur MCP my-docs. Puis utilisez-les pour trouver la page sur les actions de page.`
Si vous utilisez un outil agentique, vous pouvez aussi lui donner cette invite de configuration :
```
Ajoutez un serveur MCP nommé my-docs avec transport HTTP à https://gitbook.com/docs/~gitbook/mcp. Vérifiez ensuite qu’il se connecte en listant ses outils disponibles.
```
### Exigences
Pour utiliser un serveur MCP :
* Votre site doit être publié. Le serveur MCP n’expose que le contenu publié.
* **Actions de page** doivent être activées dans **Personnalisation du site** → **Actions de page**.
* Votre outil doit prendre en charge MCP via HTTP.
* Si votre site utilise [l’accès authentifié](/docs/documentation/fr/acces-au-site/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 depuis [Choisissez le bon point de terminaison](#choose-the-right-endpoint).
* GitBook ne prend en charge que le transport HTTP. `stdio` et `SSE` ne sont pas pris en charge.
Dans la **Actions de page** section de vos [Personnalisation](/docs/documentation/fr/docs-site/customization.md) paramètres, vous pouvez activer l’option **Se connecter avec le serveur MCP** Cela permet aux visiteurs de copier l’URL du serveur MCP de votre site depuis [le menu Actions de page](/docs/documentation/fr/docs-site/customization/extra-configuration.md#page-actions).
### Ajoutez le lien MCP à votre site
Dans [Personnalisation du site](/docs/documentation/fr/docs-site/customization.md), ouvrez [Actions de page](/docs/documentation/fr/docs-site/customization/extra-configuration.md#page-actions). Assurez-vous que **Actions de page** est activé. Puis activez **Se connecter avec le serveur MCP**.
Cela ajoute un lien MCP copiable au menu des actions de page. Cela ne modifie pas le point de terminaison utilisé par votre outil.
### Confidentialité et accès
Utilisez le point de terminaison depuis [Choisissez le bon point de terminaison](#choose-the-right-endpoint).
Le serveur MCP donne un accès en lecture seule à votre documentation publiée.
Les pages masquées restent accessibles via MCP. Masquer une page la supprime uniquement de la table des matières publiée.
Il n’expose jamais les données du compte, les analyses 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 peut pas se connecter :
* Confirmez que votre site publié est accessible.
* Confirmez que l’URL utilise le point de terminaison depuis [Choisissez le bon point de terminaison](#choose-the-right-endpoint).
* Si le site utilise l’authentification, utilisez un client qui prend en charge la [spécification d’autorisation MCP](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization).
* Si l’outil nécessite `stdio` ou `SSE`, cela ne fonctionnera pas avec GitBook.
### Utiliser MCP avec des sites authentifiés
Si votre site GitBook utilise [l’accès authentifié](/docs/documentation/fr/acces-au-site/authenticated-access.md), le serveur MCP à `/~gitbook/mcp` utilise la même authentification. Les clients MCP qui prennent en charge la [spécification d’autorisation MCP](https://modelcontextprotocol.io/docs/tutorials/security/authorization) — y compris 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 depuis [Choisissez le bon point de terminaison](#choose-the-right-endpoint).
GitBook ne prend pas en charge les sites uniquement basés sur des liens de partage ni les sites utilisant des jetons d’authentification de visiteur transmis comme en-têtes statiques pour l’authentification MCP.
Les clients MCP pris en charge — y compris Claude — suivent le [spécification d’autorisation MCP](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization) pour se connecter.
{% stepper %}
{% step %}
#### Découvrir le serveur OAuth
Pendant 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 avec Dynamic Client Registration.
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 lors des requêtes MCP suivantes jusqu’à son expiration.
{% endstep %}
{% endstepper %}
Ce flux fonctionne avec ces backends d’accès authentifié :
* [Auth0](/docs/documentation/fr/acces-au-site/authenticated-access/setting-up-auth0.md)
* [Azure AD](/docs/documentation/fr/acces-au-site/authenticated-access/setting-up-azure-ad.md)
* [Okta](/docs/documentation/fr/acces-au-site/authenticated-access/setting-up-okta.md)
* [AWS Cognito](/docs/documentation/fr/acces-au-site/authenticated-access/setting-up-aws-cognito.md)
* [OIDC](/docs/documentation/fr/acces-au-site/authenticated-access/setting-up-oidc.md)
* [Backend personnalisé](/docs/documentation/fr/acces-au-site/authenticated-access/setting-up-a-custom-backend.md) avec une URL de repli configurée
{% hint style="warning" %}
L’authentification MCP ne prend pas en charge les sites qui reposent uniquement sur des jetons d’authentification de visiteur statiques dans les en-têtes de requête.
Utilisez plutôt l’un des backends d’accès authentifié ci-dessus.
{% endhint %}
Pour configurer cela, commencez par [Accès authentifié](/docs/documentation/fr/acces-au-site/authenticated-access.md) et [Activation de l’accès authentifié](/docs/documentation/fr/acces-au-site/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 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/ia-et-recherche/mcp-servers-for-published-docs.md?ask=&goal=
```
`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.