Tools
Die Tools, die ein Agent aufrufen kann, um eine Website zu erstellen, zu ändern und zu veröffentlichen, sowie die Berechtigungen, die jedes Tool benötigt.
Die Abdeckung der generierten Operationen umfasst REST, CLI und MCP.
Zur Ermittlung der verfügbaren Operationen lesen Sie atelier201://operations und anschließend
atelier201://operations/{operation_id} für einen vollständigen Vertrag. Das vollständige Dokument
finden Sie unter atelier201://openapi. Unbekannte Tool-Argumente werden abgelehnt, statt stillschweigend
ignoriert zu werden.
get_workspace liest die nicht committeten Dateien und den Diff, ohne bash auszuführen. Es
benötigt dieselbe Berechtigung sites:write wie der Workspace-REST-Endpunkt und ändert
weder den Entwurf noch die veröffentlichte Website.
Die Tools orientieren sich an der Arbeit eines Agenten, nicht an Endpunkten. Ihre Beschreibungen sind von Hand verfasst, denn für ein Modell bilden sie die gesamte Schnittstelle: Jedes Tool beschreibt, was es ändert, ob Besucher die Änderung sehen können und welcher nächste Aufruf sinnvoll ist.
Es werden nur die Tools angeboten, die von den Berechtigungsumfängen Ihres Zugangsschlüssels erlaubt sind. Eine Verbindung
ohne sites:publish sieht daher niemals publish_site. Ein Tool verbraucht Credits:
generate_media, und zwar nur mit der Berechtigung media:generate.
Die Arbeitsreihenfolge
- Rufen Sie
get_accountund anschließendlist_sitesauf, um einesite_idzu erhalten, oder verwenden Siecreate_site. - Verwenden Sie
edit_textfür sichtbare Texte,set_fieldfür ein bekanntes Feld,save_entryundsave_entriesfür Einträge undsave_singleton themefür das Design. Verwenden Sieread_fileundedit_files(oder zuerstbashund danncommit_workspace) nur, um Code zu ändern. - Jeder Speichervorgang startet einen Build und gibt
buildzurück:get_buildmit dieser ID wartet (standardmäßig 50 s) und antwortet, sobald der Build den Statusreadyoderfailedhat. Mitpreview: trueenthält ein fertiger Build einen Link zum Öffnen. Ohne Browser können Sie die Seiten mitread_pagelesen.build_sitedient dazu, eine bestimmte Revision zu erstellen oder einen weiteren Versuch zu starten. show_site: In einem Host, der Apps anzeigt (Claude, ChatGPT), sieht der Inhaber den Entwurf live in einer Karte mit der Schaltfläche Publish. Andernfalls verwenden Sieshare_previewund senden den Link.- Rufen Sie
review_publishauf und anschließendpublish_siteerst, wenn der Inhaber zugestimmt hat.
Websites und Inhalte
| Tool | Berechtigung | Funktion |
|---|---|---|
list_sites, get_site | sites:read | Websites des Workspace lesen. |
create_site | sites:write | Eine Website anhand des Starters erstellen und den ersten Build starten. |
rename_site | sites:write | Den in Atelier201 angezeigten Namen ändern. |
get_content_model | sites:read | Collections und Singletons samt ihren JSON Schemas lesen. |
list_entries, get_entry | sites:read | Einträge einer Collection lesen. |
save_entry | sites:write | Einen Eintrag validiert speichern. Ein neuer Eintrag wird zunächst als Entwurf angelegt. |
delete_entry | sites:write | Einen Eintrag aus dem Entwurf entfernen. |
get_singleton | sites:read | Unternehmensangaben, Design oder Navigation lesen. |
save_singleton | sites:write | Ein Singleton vollständig und validiert ersetzen. |
set_field | sites:write | Ein Feld anhand seiner data-atelier201-field-Adresse ändern. |
apply_site_plan | sites:write | Mit einem Aufruf eine erste Version oder eine umfassende Überarbeitung erstellen: Unternehmensangaben, Design, Navigation, Einträge und Bilder werden gemeinsam validiert. |
place_image | sites:write | Ein Bild mit Alternativtext in ein Bildfeld einsetzen, ausgehend von einer Stock-Bildbeschreibung, einem ausgewählten Ergebnis oder einer Website-Datei. |
edit_text | sites:write | Einen Text an jeder Stelle ändern, an der er vorkommt (Inhalt oder Code), anhand des Wortlauts auf der Seite. |
Dateien, Verlauf und Changesets
| Tool | Berechtigung | Funktion |
|---|---|---|
list_files, read_file, read_files, search_files | sites:read | Das Projekt lesen. read_file gibt den Hash zurück, der als expected_hash übermittelt werden muss; read_files liest bis zu 30 Dateien mit einem Aufruf. |
edit_files | sites:write | Put-, Delete- und Move-Operationen als einen Verlaufseintrag anwenden. |
get_workspace | sites:write | Nicht committete Dateien und ihren Diff lesen, ohne einen Befehl auszuführen. |
open_changeset, stage_changes, commit_changeset, abandon_changeset | sites:write | Mit mehreren Aufrufen einen Verlaufseintrag erstellen. |
list_history, compare_revisions | sites:read | Den Verlauf lesen. |
restore_revision | sites:write | Den Entwurf an eine frühere Revision anpassen und dafür einen neuen Verlaufseintrag erstellen. |
Medien
| Tool | Berechtigung | Funktion |
|---|---|---|
list_media | sites:read | Hochgeladene Dateien und den verbleibenden Speicherplatz anzeigen. |
upload_media | sites:write | Eine Base64-Datei hochladen, über MCP höchstens 5 MB. |
delete_media | sites:write | Eine Datei aus den nächsten Builds entfernen. |
search_stock_media | sites:read | Kostenlose Stockfotos und -videos suchen (Pixabay). |
import_stock_media | sites:write | Ein Ergebnis samt Quellenangabe in die Medien der Website kopieren. |
list_media_models | sites:read | Die KI-Bild- und Videomodelle sowie ihre Preise in Credits anzeigen. |
generate_media | media:generate | Mit KI ein Bild oder Video erstellen. Verbraucht Credits: zuerst estimate_only, dann max_credits verwenden. |
get_media_generation | sites:read | Den Status einer Generierung und nach ihrem Abschluss die zugehörige Datei anzeigen. |
Build und Vorschau
| Tool | Berechtigung | Funktion |
|---|---|---|
build_site | sites:write | Den Entwurf kompilieren. Gibt sofort einen Build mit dem Status queued zurück. |
list_builds, get_build, get_build_log | sites:read | Builds und das Protokoll eines fehlgeschlagenen Builds lesen. get_build akzeptiert wait (antwortet nach Abschluss des Builds) und preview (Link zu einem fertigen Build; erfordert sites:write). |
read_page | sites:read | Eine Build-Seite so lesen, wie sie Besucher sehen, einschließlich der Probleme, die bei einer kurzen Prüfung auffallen würden: für Agenten ohne Browser. |
show_site | sites:read | Die Website-Karte öffnen, eine MCP-App: den Entwurf live anzeigen (wird nach jedem Build automatisch neu geladen), ein Bild der Startseite anzeigen, wenn der Host sie nicht einbetten kann, die Publish-Schaltfläche (Go live, Publish changes) und Comment, über das ein „change this“ zu einem Element an die Unterhaltung gesendet wird. Ohne sites:write zeigt die Karte nur das Bild. |
share_preview | sites:write | Einen privaten Link zu einem Build erstellen, standardmäßig 7 Tage gültig. |
list_previews | sites:read | Vorschau-Links anzeigen. |
revoke_preview | sites:write | Einen Vorschau-Link deaktivieren. |
Veröffentlichen und Domains
Diese Tools ändern, was Besucher sehen. Fragen Sie vorher den Inhaber.
| Tool | Berechtigung | Funktion |
|---|---|---|
review_publish | sites:read | Anzeigen, was veröffentlicht würde, was die Veröffentlichung verhindert und welche expected_generation gilt. |
publish_site | sites:publish | Einen Build veröffentlichen. |
rollback_site | sites:publish | Eine frühere Veröffentlichung wieder bereitstellen. |
unpublish_site | sites:publish | Die Website offline nehmen. |
delete_site | sites:publish | Eine Website endgültig löschen. confirm_name muss ihrem Namen oder Slug entsprechen; für eine veröffentlichte Website ist delete_published: true erforderlich. Der Vorgang kann nicht rückgängig gemacht werden. |
list_publications | sites:read | Den Veröffentlichungsverlauf lesen. |
get_site_analytics | sites:read | Besucherzahlen einer Website für einen Zeitraum lesen. |
list_domains | sites:read | Domains und die noch erforderlichen DNS-Einträge anzeigen. |
add_domain, check_domain | domains:write | Eine Domain verbinden und ihre DNS-Einträge überprüfen. |
remove_domain | domains:write | Eine Domainverbindung trennen. |
set_main_domain | domains:write | Die anderen Adressen auf eine Hauptadresse umleiten und einen neuen Build erstellen. |
Zum Veröffentlichen, Zurücksetzen, Offline-Nehmen und Ändern von Domains ist außerdem die Workspace-Adminberechtigung erforderlich. Binäre Projekte lassen sich über die REST API oder die CLI importieren und exportieren. MCP-Agenten lesen und ändern stattdessen einzelne Dateien.
Konto
| Tool | Berechtigung | Funktion |
|---|---|---|
get_account | account:read | Workspace, Tarif und Berechtigungsumfänge dieses Zugangsschlüssels lesen. |
get_credit_balance | account:read | Credit-Guthaben und alle Gutschriften anzeigen. |
get_usage | usage:read | Den Credit-Verbrauch im Zeitverlauf lesen. |
list_skills | keine | Die Anleitungen auflisten: Website erstellen, Inhalte bearbeiten, Design ändern, Daten importieren, einen Build reparieren, veröffentlichen. Rufen Sie das Tool vor dem Erstellen auf. |
get_skill | keine | Eine Anleitung vollständig im Markdown-Format lesen. |
send_feedback | keine | Fehler oder fehlende Funktionen in der API, CLI oder im MCP-Server melden. |
Sicher schreiben
Übermitteln Sie bei jeder geänderten Datei den Hash aus read_file als expected_hash. Wurde
die Datei zwischenzeitlich geändert, wird die gesamte Änderung mit einem conflict-Fehler abgelehnt,
und es wird nichts geschrieben. Lesen Sie die Dateien erneut, übernehmen Sie Ihre Änderung auf dieser Grundlage und versuchen Sie es noch einmal.
publish_site verwendet den Wert expected_generation aus review_publish und
wird abgelehnt, wenn die Website inzwischen veröffentlicht wurde.