--- title: "Outils" description: "Les outils qu’un agent peut appeler pour créer, modifier et publier un site, ainsi que les autorisations nécessaires à chacun." canonical: "https://atelier201.com/docs/fr/mcp/standard-tools" updated: "2026-11-06" --- # Outils La [couverture des opérations générées](/docs/api/surfaces) fait le lien entre REST, la CLI et MCP. Pour découvrir les opérations, consultez `atelier201://operations`, puis `atelier201://operations/{operation_id}` pour obtenir le contrat complet d’une opération. Le document complet est `atelier201://openapi`. Les arguments d’outil inconnus sont rejetés plutôt que silencieusement ignorés. `get_workspace` lit les fichiers non validés et les différences sans exécuter bash. Il utilise la même autorisation `sites:write` que le point de terminaison REST de l’espace de travail et ne modifie ni le brouillon ni le site publié. Les outils sont conçus en fonction du travail effectué par un agent, et non des points de terminaison. Leurs descriptions sont rédigées à la main, car un modèle les lit comme son interface complète : chacune indique ce qu’elle modifie, si les visiteurs peuvent le voir et quel outil appeler ensuite. Seuls les outils autorisés par les portées de vos identifiants sont proposés. Une connexion sans `sites:publish` ne voit donc jamais `publish_site`. Un outil consomme des crédits, `generate_media`, et uniquement avec l’autorisation `media:generate`. ## Ordre des opérations 1. Appelez `get_account`, puis `list_sites` pour obtenir un `site_id`, ou `create_site`. 2. Utilisez `edit_text` pour tout texte visible, `set_field` pour un champ identifié, `save_entry` et `save_entries` pour les entrées, et `save_singleton theme` pour l’apparence. Utilisez `read_file` et `edit_files` (ou `bash`, puis `commit_workspace`) uniquement pour modifier le code. 3. Chaque enregistrement lance la compilation et renvoie `build` : `get_build` avec cet identifiant attend (50 s par défaut) et répond lorsque le statut est `ready` ou `failed`. Avec `preview: true`, une compilation prête inclut un lien à ouvrir ; sans navigateur, `read_page` permet de lire les pages. `build_site` sert à compiler une révision donnée ou à réessayer. 4. `show_site` : dans un environnement qui affiche des applications (Claude, ChatGPT), le propriétaire voit le brouillon en direct dans une carte, avec le bouton Publier. Ailleurs, utilisez `share_preview` et transmettez-lui le lien. 5. Appelez `review_publish`, puis `publish_site` uniquement après l’approbation du propriétaire. ## Sites et contenu | Outil | Portée | Fonction | | --------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `list_sites`, `get_site` | `sites:read` | Consulter les sites de l’espace de travail. | | `create_site` | `sites:write` | Créer un site à partir du modèle de départ et lancer sa première compilation. | | `rename_site` | `sites:write` | Modifier le nom affiché dans Atelier201. | | `get_content_model` | `sites:read` | Consulter les collections et les éléments uniques avec leurs schémas JSON. | | `list_entries`, `get_entry` | `sites:read` | Consulter les entrées d’une collection. | | `save_entry` | `sites:write` | Enregistrer une entrée après validation. Toute nouvelle entrée est créée comme brouillon. | | `delete_entry` | `sites:write` | Supprimer une entrée du brouillon. | | `get_singleton` | `sites:read` | Consulter les informations de l’entreprise, le thème ou la navigation. | | `save_singleton` | `sites:write` | Remplacer un élément unique complet après validation. | | `set_field` | `sites:write` | Modifier un champ à l’adresse `data-atelier201-field` correspondante. | | `apply_site_plan` | `sites:write` | Créer une première version ou effectuer une refonte importante en un seul appel : informations de l’entreprise, thème, navigation, entrées et images, le tout validé ensemble. | | `place_image` | `sites:write` | Insérer une image dans un champ image (description d’image libre de droits, résultat choisi ou fichier du site) avec son texte alternatif, en un seul appel. | | `edit_text` | `sites:write` | Modifier un texte où qu’il apparaisse (contenu ou code), en le désignant tel qu’il est affiché sur la page. | ## Fichiers, historique et ensembles de modifications | Outil | Portée | Fonction | | -------------------------------------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | `list_files`, `read_file`, `read_files`, `search_files` | `sites:read` | Consulter le projet. `read_file` renvoie le hachage à transmettre comme `expected_hash` ; `read_files` lit jusqu’à 30 fichiers en un seul appel. | | `edit_files` | `sites:write` | Appliquer des opérations d’ajout, de suppression et de déplacement comme une seule entrée d’historique. | | `get_workspace` | `sites:write` | Consulter les fichiers non validés et leurs différences sans exécuter de commande. | | `open_changeset`, `stage_changes`, `commit_changeset`, `abandon_changeset` | `sites:write` | Regrouper plusieurs appels dans une seule entrée d’historique. | | `list_history`, `compare_revisions` | `sites:read` | Consulter l’historique. | | `restore_revision` | `sites:write` | Rétablir le brouillon à l’état d’une révision antérieure et créer une nouvelle entrée d’historique. | ## Médias | Outil | Portée | Fonction | | ---------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------- | | `list_media` | `sites:read` | Consulter les fichiers téléversés et l’espace de stockage restant. | | `upload_media` | `sites:write` | Téléverser un fichier encodé en base64, de 5 MB maximum via MCP. | | `delete_media` | `sites:write` | Supprimer un fichier des prochaines compilations. | | `search_stock_media` | `sites:read` | Rechercher des photos et vidéos libres de droits (Pixabay). | | `import_stock_media` | `sites:write` | Copier un résultat dans les médias du site avec son attribution. | | `list_media_models` | `sites:read` | Consulter les modèles d’IA pour les images et vidéos, ainsi que leur coût en crédits. | | `generate_media` | `media:generate` | Créer une image ou une vidéo avec l’IA. Consomme des crédits : appelez d’abord `estimate_only`, puis `max_credits`. | | `get_media_generation` | `sites:read` | Consulter l’état d’une génération et récupérer le fichier une fois celle-ci terminée. | ## Compilation et aperçu | Outil | Portée | Fonction | | ------------------------------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `build_site` | `sites:write` | Compiler le brouillon. Renvoie immédiatement une compilation `queued`. | | `list_builds`, `get_build`, `get_build_log` | `sites:read` | Consulter les compilations et le journal d’une compilation échouée. `get_build` accepte `wait` (répond à la fin de la compilation) et `preview` (lien vers une compilation prête ; nécessite `sites:write`). | | `read_page` | `sites:read` | Lire une page de la compilation comme un visiteur, avec les problèmes qu’une vérification rapide permettrait de repérer : pour un agent sans navigateur. | | `show_site` | `sites:read` | Ouvrir la carte du site, une application MCP : le brouillon en direct (rechargé automatiquement après chaque compilation), une image de la page d’accueil si l’environnement ne peut pas l’intégrer, le bouton Publier (Mettre en ligne, Publier les modifications) et Commenter, qui renvoie à la conversation la demande « modifier ceci » à propos d’un élément. Sans `sites:write`, la carte affiche uniquement l’image. | | `share_preview` | `sites:write` | Créer un lien privé vers une compilation, valable 7 jours par défaut. | | `list_previews` | `sites:read` | Consulter les liens d’aperçu. | | `revoke_preview` | `sites:write` | Désactiver un lien d’aperçu. | ## Publication et domaines Ces actions modifient ce que voient les visiteurs. Demandez d’abord l’autorisation du propriétaire. | Outil | Portée | Fonction | | ---------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `review_publish` | `sites:read` | Afficher ce qui serait mis en ligne, les éléments bloquants et `expected_generation`. | | `publish_site` | `sites:publish` | Mettre une compilation en ligne. | | `rollback_site` | `sites:publish` | Remettre en ligne une publication antérieure. | | `unpublish_site` | `sites:publish` | Mettre le site hors ligne. | | `delete_site` | `sites:publish` | Supprimer définitivement un site. `confirm_name` doit correspondre à son nom ou à son slug ; pour un site publié, `delete_published: true` est requis. Cette action est irréversible. | | `list_publications` | `sites:read` | Consulter l’historique des publications. | | `get_site_analytics` | `sites:read` | Consulter le nombre de visiteurs d’un site sur une période donnée. | | `list_domains` | `sites:read` | Consulter les domaines et les enregistrements DNS qu’il reste à configurer pour chacun. | | `add_domain`, `check_domain` | `domains:write` | Connecter un domaine et vérifier ses enregistrements DNS. | | `remove_domain` | `domains:write` | Déconnecter un domaine. | | `set_main_domain` | `domains:write` | Rediriger les autres adresses vers une seule et relancer la compilation. | La publication, le retour à une version antérieure, la mise hors ligne et la modification des domaines nécessitent également les droits d’administrateur de l’espace de travail. L’import et l’export de projets binaires se font via l’[API REST](/docs/api/overview) ou la [CLI](/docs/cli/commands) ; les agents MCP lisent et modifient plutôt des fichiers individuels. ## Compte | Outil | Portée | Fonction | | -------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `get_account` | `account:read` | Consulter l’espace de travail, l’offre et les portées de ces identifiants. | | `get_credit_balance` | `account:read` | Consulter le solde de crédits et chaque attribution. | | `get_usage` | `usage:read` | Consulter l’utilisation des crédits au fil du temps. | | `list_skills` | none | Afficher les guides : créer un site, modifier du contenu, changer le design, importer des données, corriger une compilation et publier. À appeler avant de commencer la création. | | `get_skill` | none | Lire un guide en entier au format Markdown. | | `send_feedback` | none | Signaler un problème ou un élément manquant dans l’API, la CLI ou le serveur MCP. | ## Modifier en toute sécurité Transmettez le hachage renvoyé par `read_file` comme `expected_hash` pour chaque fichier modifié. Si quelqu’un l’a modifié entre-temps, l’ensemble de la modification est refusé avec une erreur `conflict` et rien n’est écrit. Relisez les fichiers, appliquez vos modifications par-dessus, puis réessayez. `publish_site` utilise le `expected_generation` renvoyé par `review_publish` et est refusé si le site a été publié entre-temps.