Outils
Les outils qu’un agent peut appeler pour créer, modifier et publier un site, ainsi que les autorisations nécessaires à chacun.
La couverture des opérations générées 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
- Appelez
get_account, puislist_sitespour obtenir unsite_id, oucreate_site. - Utilisez
edit_textpour tout texte visible,set_fieldpour un champ identifié,save_entryetsave_entriespour les entrées, etsave_singleton themepour l’apparence. Utilisezread_fileetedit_files(oubash, puiscommit_workspace) uniquement pour modifier le code. - Chaque enregistrement lance la compilation et renvoie
build:get_buildavec cet identifiant attend (50 s par défaut) et répond lorsque le statut estreadyoufailed. Avecpreview: true, une compilation prête inclut un lien à ouvrir ; sans navigateur,read_pagepermet de lire les pages.build_sitesert à compiler une révision donnée ou à réessayer. 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, utilisezshare_previewet transmettez-lui le lien.- Appelez
review_publish, puispublish_siteuniquement 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 ou la CLI ; 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.