--- title: "Tools" description: "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." canonical: "https://atelier201.com/docs/de/mcp/standard-tools" updated: "2026-11-06" --- # Tools Die [Abdeckung der generierten Operationen](/docs/api/surfaces) 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 1. Rufen Sie `get_account` und anschließend `list_sites` auf, um eine `site_id` zu erhalten, oder verwenden Sie `create_site`. 2. Verwenden Sie `edit_text` für sichtbare Texte, `set_field` für ein bekanntes Feld, `save_entry` und `save_entries` für Einträge und `save_singleton theme` für das Design. Verwenden Sie `read_file` und `edit_files` (oder zuerst `bash` und dann `commit_workspace`) nur, um Code zu ändern. 3. Jeder Speichervorgang startet einen Build und gibt `build` zurück: `get_build` mit dieser ID wartet (standardmäßig 50 s) und antwortet, sobald der Build den Status `ready` oder `failed` hat. Mit `preview: true` enthält ein fertiger Build einen Link zum Öffnen. Ohne Browser können Sie die Seiten mit `read_page` lesen. `build_site` dient dazu, eine bestimmte Revision zu erstellen oder einen weiteren Versuch zu starten. 4. `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 Sie `share_preview` und senden den Link. 5. Rufen Sie `review_publish` auf und anschließend `publish_site` erst, 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](/docs/api/overview) oder die [CLI](/docs/cli/commands) 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.