> 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/vue-densemble.md).
# Vue d'ensemble
{% columns %}
{% column width="33.33333333333333%" %}
## Publiez votre documentation en moins de 5 minutes
Publier vos docs avec GitBook est aussi simple que de demander à votre agent
S'inscrireDemander une démo
{% endcolumn %}
{% column width="66.66666666666667%" %}
{% code overflow="wrap" expandable="true" %}
```markdown
# Agent de configuration GitBook
## Objectif
Mettez mes docs en ligne sur un site GitBook publié. Terminé = vous me donnez l'URL en direct et confirmez qu'elle se charge. Dites-moi clairement quand une étape a besoin de moi — faites tout le reste vous-même.
**D'abord, vérifiez vos outils :** si les outils MCP GitBook sont déjà connectés, passez l'étape de connexion ci-dessous. Cette invite a peut-être déjà été collée auparavant (par exemple après un redémarrage) — dans ce cas, reprenez là où les choses se sont arrêtées au lieu de recommencer depuis le début.
## Préparer (démarrer immédiatement)
Demandez-moi mes docs — un dossier local ou un dépôt. Vérifiez la source avant de construire : répétez exactement ce que vous lisez et listez son contenu de niveau supérieur afin que je puisse confirmer que c'est correct. Si vous ne pouvez pas accéder à quelque chose que j'ai nommé (les dépôts privés renvoient 404, comme s'ils n'existaient pas), arrêtez-vous et demandez — ne remplacez jamais la source par une autre. Montrez-moi le plan du site avant de créer quoi que ce soit dans GitBook.
## Connexion
Connectez-vous au serveur MCP de GitBook : `https://mcp.gitbook.com/mcp` (HTTP diffusible, OAuth).
- **Claude Code** : `claude plugin marketplace add GitbookIO/gitbook-skills` puis `claude plugin install gitbook@gitbook-skills` — je lance `/reload-plugins` et `/mcp` pour me connecter.
- **Codex** : `codex mcp add gitbook --url https://mcp.gitbook.com/mcp`
- **Cursor** : ajoutez l'URL sous `mcpServers` dans `.cursor/mcp.json`, puis je l'active dans Paramètres → MCP.
- **Application de chat sans terminal** : dites-moi d'ajouter l'URL comme connecteur personnalisé dans les paramètres de mon application.
- **Tout autre cas** : récupérez https://gitbook.com/docs/getting-started/ai-documentation/gitbook-mcp.md pour les instructions de configuration, ou revenez à l'API REST avec un PAT depuis https://app.gitbook.com/account/developer.
La plupart des outils ne chargent pas de nouveaux serveurs MCP en cours de session. Si les outils GitBook n'apparaissent pas après la configuration, dites-moi de redémarrer l'application et de coller à nouveau cette invite — vous détecterez la connexion et continuerez. Si vous pouvez exécuter des commandes, installez aussi les skills de GitBook : `npx -y skills add GitbookIO/gitbook-skills -y`
Si la connexion échoue parce que je n'ai pas de compte, envoyez-moi sur https://app.gitbook.com/join pour en créer un, puis faites-moi réessayer.
## Vérifier avant de créer
Une fois connecté, vérifiez si ces docs ont déjà un site GitBook — examinez l'état de Git Sync du dépôt et listez les sites de mon organisation. Si un site existe, n'en créez pas un en double : passez à sa mise à jour (modifiez localement et poussez si Git Sync est configuré, ou ouvrez une demande de modification). Créez un nouveau site uniquement si rien n'existe.
## Construire et publier
Créez le site avec les outils MCP GitBook, importez mon contenu et publiez. Ignorez Git Sync pour cette première publication — proposez-le une fois le site en ligne. Récupérez l'URL en direct pour confirmer qu'elle se charge, puis donnez-la-moi.
```
{% endcode %}
#### Vous cherchez autre chose ?
---
# 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/vue-densemble.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.