MCP-Tool-Referenz
Jedes Tool, das der MCP-Server einem verbundenen LLM-Client bereitstellt, nach Domaene gruppiert. Damit entscheidest du, welche Scopes ein Token braucht, und verstehst, welche Aufrufe in den Entwurf und welche auf die Live-Seite schreiben.
Zum Einrichten siehe LLM mit dem CMS verbinden.
So liest du diese Tabellen
| Spalte | Bedeutung |
|---|---|
| Tool | Der Tool-Name, den der Client aufruft. |
| Zweck | Was das Tool tut. |
| Modus | Lesen = inspiziert nur; Schreiben = aendert Daten. |
| Entwurf / Live | Wohin ein Schreibzugriff geht — Entwurf (bis zum Publish unsichtbar) oder Live (sofort). Read-Tools zeigen —. |
| Scope | Der benoetigte Token-Scope. Read-Tools akzeptieren read oder den Schreib-Scope der Domaene. |
Draft-First
Pagebuilder-Struktur, Seiteninhalt, Seiten-SEO-Meta und Versions-Wiederherstellungen schreiben in den Entwurf. Design/LESS, E-Mail-Design, Stammdaten, Menues, SEO-Site-Einstellungen, Medien und Weiterleitungen schreiben Live. Nur publish_page hebt einen Entwurf auf Live — und nur mit dem expliziten publish-Scope.
Lesen & inspizieren
Nur-Lese-Tools. Jedes akzeptiert den read-Scope oder den passenden Schreib-Scope der Domaene.
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
ping | Health-Check; gibt pong plus den authentifizierten Tenant und die vergebenen Scopes zurueck. | Lesen | — | jedes gueltige Token |
get_design_tokens | Liest die Live-Design-Tokens / Custom-LESS-Variablen (Farben, Schriften, Abstaende). | Lesen | — | read oder design |
get_settings | Liest die Stammdaten der Seite: Firmen-/Kontaktinfo, Logo, Favicon, Analytics-IDs, Social-Links. | Lesen | — | read oder content |
get_menu | Liest die Navigations-Menues und ihre Eintraege (Basissprache). | Lesen | — | read oder menu |
list_pages | Listet alle Inhaltsseiten mit id, ident, Titel, Slug und Entwurfsstatus. | Lesen | — | read oder content |
get_page_structure | Liest die vollstaendige Pagebuilder-Struktur einer Seite: Rows → Columns → Widgets, mit Typen, Custom CSS, Sichtbarkeit. | Lesen | — | read oder content |
get_seo_meta | Liest das SEO-Meta einer Seite (Titel, Slug, Meta-Description, Meta-Keywords) fuer eine Sprache. | Lesen | — | read oder content |
get_preview_url | Liefert die Frontend-Vorschau-URL einer Seite (zeigt den aktuellen Entwurfsstand). | Lesen | — | read oder content |
get_widget_catalog | Listet alle nativen Pagebuilder-Widgets und ihr Feldschema. Hier startest du, bevor du eine Seite baust. | Lesen | — | read oder content |
get_widget_fields | Liefert das Feldschema und die aktuellen Werte einer Widget-Instanz (per base_id). | Lesen | — | read oder content |
get_element_details | Liest den aktuellen Spacing-/Border-/CSS-/Flex-/Hintergrund-/Breiten-/Sichtbarkeits-/Animations-Stand eines Elements. | Lesen | — | read oder content |
search_media | Durchsucht die Mediathek nach Namen; gibt Media-Items zur Referenzierung per id zurueck. | Lesen | — | read oder media |
Design
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
save_design_less | Speichert das Custom LESS (Design-Tokens) der Seite und kompiliert es sofort. Ersetzt das gesamte LESS — erst lesen, dann das vollstaendige Ergebnis uebergeben. | Schreiben | Live | design |
E-Mail-Design
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
get_email_design | Liest die E-Mail-Design-Tokens (Schrift + Farben fuer Transaktions-/Benachrichtigungs-E-Mails) und ihre Defaults. Vor update_email_design aufrufen. | Lesen | — | read oder design |
update_email_design | Aktualisiert die E-Mail-Design-Tokens — Schrift plus #hex-Farben (bg / surface / subtle / text / heading / muted / accent / accent_text / border). Read-Merge, serverseitig validiert. | Schreiben | Live | design |
Seiten
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
create_page | Legt eine neue Inhaltsseite mit Titel und URL-Slug an (erreichbar unter /{slug}). Wird nicht ins Navigationsmenue aufgenommen. | Schreiben | Entwurf | content |
duplicate_page | Dupliziert eine Seite: legt eine neue Seite an (new_title + new_slug) und kopiert den vollstaendigen Pagebuilder-Inhalt der Quellseite in ihren Entwurf. SEO-Meta wird nicht kopiert. | Schreiben | Entwurf | content |
update_page_slug | Aendert den URL-Slug einer Seite fuer eine Sprache. Die alte URL wird nicht automatisch weitergeleitet. | Schreiben | Live | content |
set_page_options | Setzt Seiten-Optionen: searchindex (Aufnahme in Suche / Sitemap / llms.txt) und fullwidth (volle Breite vs. begrenztes Layout). Erhaelt das SEO-Meta. | Schreiben | Live | content |
Pagebuilder — Struktur
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
pagebuilder_add_row | Fuegt einer Seite eine neue leere Row hinzu (stellt zuerst eine veroeffentlichte Baseline sicher). Gibt die neue row_id zurueck. | Schreiben | Entwurf | content |
pagebuilder_add_column | Fuegt einer Row eine Column hinzu (Standard volle Breite, 12/12). Gibt die neue column_id zurueck. | Schreiben | Entwurf | content |
pagebuilder_add_widget | Fuegt einer Column ein Widget hinzu. widget_type_id stammt aus get_widget_catalog. Gibt die neue id und base_id zurueck. | Schreiben | Entwurf | content |
reorder_elements | Ordnet Rows in einer Seite, Columns in einer Row oder Widgets in einer Column je Breakpoint neu. | Schreiben | Entwurf | content |
move_element | Verschiebt ein Widget in eine andere Column oder eine Column in eine andere Row/Sektion. | Schreiben | Entwurf | content |
delete_element | Loescht eine Row, Column oder ein Widget (inkl. Kinder). Die Live-Seite bleibt bis zum Publish unveraendert. | Schreiben | Entwurf | content |
duplicate_element | Dupliziert eine Row, Column oder ein Widget an Ort und Stelle — kopiert Kinder, Styles, Sprachvarianten, Items. | Schreiben | Entwurf | content |
copy_element | Kopiert eine Row, Column oder ein Widget und fuegt es woanders ein (auch auf einer anderen Seite) mit frischen IDs. target_id ist die Zielseite (Row) / Row (Column) / Column (Widget). | Schreiben | Entwurf | content |
discard_draft | Verwirft alle unveroeffentlichten Aenderungen einer Seite — setzt den Entwurf auf den Live-Stand zurueck. | Schreiben | Entwurf | content |
Pagebuilder — Inhalt
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
set_widget_content | Setzt den Inhalt einer Widget-Instanz. content_json bildet Feld → Wert anhand der widget_menu-Row-Keys ab. | Schreiben | Entwurf | content |
Pagebuilder — Styling & Layout
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
set_spacing | Setzt Padding/Margin einer Row, Column oder eines Widgets je Breakpoint (px). | Schreiben | Entwurf | content |
set_border | Setzt Border und Border-Radius einer Row, Column oder eines Widgets je Breakpoint. | Schreiben | Entwurf | content |
set_custom_css | Setzt scoped Custom CSS (nur Inner-CSS; das CMS wrappt es in .row_{id} / .col_{id} / .widget_{id}). | Schreiben | Entwurf | content |
set_column_width | Setzt die Column-Grid-Breite (1–12) je Breakpoint. Die Columns einer Row sollten 12 ergeben. | Schreiben | Entwurf | content |
set_flex | Setzt die Flexbox-Ausrichtung einer Row (align, justify) je Breakpoint. | Schreiben | Entwurf | content |
set_row_background | Setzt den Hintergrund einer Row (Farbe/Bild) und den Full-Width-Schalter. | Schreiben | Entwurf | content |
set_visibility | Blendet eine Row, Column oder ein Widget je Breakpoint ein oder aus. | Schreiben | Entwurf | content |
Pagebuilder — Animationen
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
get_animation_schema | Gibt das vollstaendige animation_data-Schema zurueck (Properties, Trigger, ScrollTrigger, Stagger, Easings, Beispiele). Vor set_animation aufrufen. | Lesen | — | read oder content |
set_animation | Setzt oder entfernt eine GSAP-Scroll-/Entrance-Animation an einer Row, Column oder einem Widget. "" / "null" entfernt sie. | Schreiben | Entwurf | content |
Widget-Items (Repeater)
Wiederholbare Items nativer Widgets (Slides, Eintraege, Cards).
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
get_widget_items | Listet die wiederholbaren Items einer Widget-Instanz plus das Item-Feldschema. | Lesen | — | read oder content |
save_widget_item | Erstellt oder aktualisiert ein wiederholbares Widget-Item. item_base_id weglassen zum Erstellen; uebergeben zum Aktualisieren. | Schreiben | Entwurf | content |
delete_widget_item | Loescht ein Widget-Item (alle Sprachvarianten). | Schreiben | Entwurf | content |
reorder_widget_items | Ordnet die Items eines Widgets nach ihren base_ids neu. | Schreiben | Entwurf | content |
Vibecode-Widgets
Massgeschneiderte HTML+CSS-Widgets, von der KI generiert. Vibecode ist nur fuer visuelle/dekorative Layouts gedacht — funktionale Sektionen (Formulare, Shop, Suche, E-Learning, Konto) muessen native Widgets nutzen.
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
vibecode_generate | Generiert oder verfeinert ein Vibe-Code-AI-Widget (HTML+CSS) aus einer Beschreibung. Async; wartet ~45s. Das Ziel-Widget muss bereits ein Vibecode-Widget sein. | Schreiben | Entwurf | content |
get_vibecode_items | Listet die wiederholbaren Items eines Vibecode-Widgets plus das Feldschema je Instanz. | Lesen | — | read oder content |
save_vibecode_item | Erstellt oder aktualisiert ein Vibecode-Widget-Item. item_base_id weglassen zum Erstellen; uebergeben zum Aktualisieren. | Schreiben | Entwurf | content |
delete_vibecode_item | Loescht ein Vibecode-Widget-Item aus allen Sprachen. | Schreiben | Entwurf | content |
reorder_vibecode_items | Ordnet die Items eines Vibecode-Widgets neu. | Schreiben | Entwurf | content |
Menue
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
create_menu_item | Legt einen neuen Menueeintrag (Basissprache) in einem Menue an. item_type: link / page / anchor / label / megamenu. | Schreiben | Live | menu |
update_menu_item | Aktualisiert einen Menueeintrag (partiell): label, link_url, page_ident, badge_text, image, icon, item_type, target, is_active. | Schreiben | Live | menu |
delete_menu_item | Loescht einen Menueeintrag samt seiner Untereintraege. | Schreiben | Live | menu |
reorder_menu_items | Ordnet gleichrangige Menueeintraege nach ihren ids in der gewuenschten Reihenfolge neu. | Schreiben | Live | menu |
SEO & Suche / KI
update_seo_meta schreibt in den Seiten-Entwurf; die site-weiten Suche-&-KI-Einstellungen schreiben Live.
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
update_seo_meta | Aktualisiert das SEO-Meta einer Seite (title, meta_description, meta_tags, slug) fuer eine Sprache. Ausgelassene Felder behalten ihren Wert. | Schreiben | Entwurf | content |
get_seo_settings | Liest die Suche-&-KI-Einstellungen der Seite: indexing_enabled, ai_crawler_blocked und die aktuelle llms.txt. | Lesen | — | read oder content |
set_search_indexing | Aktiviert/deaktiviert die Suchmaschinen-Indexierung site-weit (schreibt robots.txt + Meta-Robots neu). | Schreiben | Live | content |
set_ai_crawler_block | Blockiert/entsperrt KI-Crawler (GPTBot, ClaudeBot, …) site-weit ueber robots.txt. | Schreiben | Live | content |
generate_llms_txt | Generiert einen llms.txt-Entwurf aus dem Seiteninhalt. Gibt ihn ohne Speichern zurueck — pruefen, dann update_llms_txt. | Lesen | — | read oder content |
update_llms_txt | Ersetzt den llms.txt-Inhalt der Seite (ausgeliefert unter /llms.txt). | Schreiben | Live | content |
Stammdaten
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
update_settings | Aktualisiert die Stammdaten der Seite (Firmen-/Kontaktinfo, Logo, Favicon, Analytics-IDs). Zuerst get_settings aufrufen. | Schreiben | Live | content |
Medien
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
create_media_folder | Legt einen Media-Ordner/Unterordner an. Gibt die neue Ordner-Node-id zurueck. | Schreiben | Live | media |
rename_media_folder | Benennt einen Media-Ordner um. | Schreiben | Live | media |
rename_media | Benennt eine Mediendatei um (nur Anzeigename; die Datei bleibt erhalten). | Schreiben | Live | media |
upload_media | Laedt ein Bild aus einer oeffentlichen http(s)-URL in einen Ordner. | Schreiben | Live | media |
upload_media_file | Laedt eine lokale Datei per base64 in einen Ordner. Max. 20 MB. | Schreiben | Live | media |
move_media | Verschiebt eine Mediendatei in einen anderen Ordner (logischer Tree-Move; die Datei-URL bleibt gleich). | Schreiben | Live | media |
delete_media | Loescht eine Mediendatei dauerhaft. | Schreiben | Live | media |
delete_media_folder | Loescht einen Media-Ordner. | Schreiben | Live | media |
Weiterleitungen
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
list_redirects | Listet URL-Weiterleitungen (id, Quelle, Ziel, Statuscode, aktiv, Hit-Count). | Lesen | — | read oder content |
create_redirect | Legt eine URL-Weiterleitung an: source_url (eindeutig) → target_url, Status 301 (Standard) oder 302. | Schreiben | Live | content |
update_redirect | Aktualisiert eine Weiterleitung (partiell): source_url, target_url, status_code, active, notes. | Schreiben | Live | content |
delete_redirect | Loescht eine URL-Weiterleitung dauerhaft. | Schreiben | Live | content |
Versionen
Benannte Seiten-Snapshots als Wiederherstellungspunkte. Speichern und Listen aendern die Seite nicht; Wiederherstellen ueberschreibt den Entwurf.
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
save_page_version | Speichert einen benannten Snapshot einer Seite als Wiederherstellungspunkt. Aendert Live/Entwurf nicht. | Schreiben | Entwurf | content |
list_page_versions | Listet die gespeicherten benannten Versionen einer Seite (id, label, created_by, created_at). | Lesen | — | read oder content |
restore_page_version | Stellt eine gespeicherte Version in den Seiten-Entwurf wieder her (ueberschreibt den aktuellen Entwurf; Live bleibt bis zum Publish). | Schreiben | Entwurf | content |
delete_page_version | Loescht eine gespeicherte Seiten-Version. Beeinflusst Live/Entwurf nicht. | Schreiben | Entwurf | content |
Publish
| Tool | Zweck | Modus | Entwurf / Live | Scope |
|---|---|---|---|---|
publish_page | Publiziert eine Seite: hebt ihren Entwurf auf Live. Optionales scheduled_at (zukuenftiges ISO-Datum) plant stattdessen. | Schreiben | Live | publish |
publish ist explizit und separat
publish_page erfordert den literalen publish-Scope — er wird niemals von einem anderen Scope gewaehrt. Der Client fuehrt es nur aus, wenn du ausdruecklich darum bittest, eine bestimmte Seite zu publizieren, nie als Teil eines Bau- oder Edit-Flows.
Siehe auch
- LLM mit dem CMS verbinden — Token-Erstellung, Client-Konfiguration, Pruefung.
- Entwuerfe, Publish, Versionen — das Entwurf/Live-Zustandsmodell.
- Design-Tokens — was
save_design_lessschreibt. - Suchmaschinen & KI — was die SEO-/Suche-Tools steuern.
- Audit-Log — jeder MCP-Tool-Aufruf wird hier protokolliert.