Mis à jour
Ce contenu vous a-t-il été utile ?
Publier vos docs avec GitBook est aussi simple que de demander à votre agent
Mis à jour
Ce contenu vous a-t-il été utile ?
Ce contenu vous a-t-il été utile ?
# 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.
