Sylius Admin: Verwendung

Sylius Admin im Alltag: Produkt-Wizard als Skill, Beispiel-Aufträge an Claude für Produkte, Varianten, Preise, SEO, Bilder, Kategorien, Versand und Länder sowie der Umgang mit Stage und Prod.

English Version

Zurück zur Übersicht

Sylius Admin: Verwendung

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Skills des Plugins

Das Plugin liefert zwei Skills mit. Hooks und eigene Slash-Commands gibt es nicht.

Skill	Aufruf	Zweck
Setup	`/syliusadmin:setup`	Einrichtung und Reparatur: venv, Abhängigkeiten, `.env`-Dateien, siehe Installation
Produkt-Wizard	`/syliusadmin:sylius-produkt-wizard`	Geführter Dialog zum Anlegen eines Produkts, auch auslösbar mit "Produkt anlegen" oder "neues Produkt"

Der Produkt-Wizard

Ein MCP-Tool kann dem User keine Fragen stellen. Deshalb liegt der Dialog als Skill über den Tools des Servers. Der Wizard enthält keine eigene Geschäftslogik: Jede Schreiboperation läuft durch die Validierung des Servers.

Er klärt zuerst, welche Umgebung gemeint ist, wenn das nicht eindeutig ist, und arbeitet dann diese Schritte ab:

Schritt	Inhalt
1. Produkttyp	Einfach (genau eine Variante) oder konfigurierbar (Optionen wie Farbe oder Größe, mehrere Varianten)
2. Basisdaten	Code, Name und Beschreibung je Locale, Channels (per `list_channels`), Kategorie (per `list_taxons`), Preis je Channel in Cent
3. Optionen	Nur bei konfigurierbar: bestehende Optionen verwenden oder per `create_product_option` neu anlegen; Werte-Codes mit Präfix wie `color_red`
4. Produkt anlegen	`create_product`, immer deaktiviert
5. Varianten planen	Kreuzprodukt der Optionswerte, Variantencodes und Preise mit dir abstimmen
6. Varianten anlegen	`add_variant` je Kombination
7. SEO prüfen	`metaDescription` und `metaKeywords` je Übersetzung, bei Bedarf per `update_product` ergänzen
8. Aktivieren	`set_product_active`, danach Zusammenfassung mit Produktcode und Variantenzahl

Nicht Teil des Wizards sind Bilder (ein separater Schritt danach), das Löschen von Fehlversuchen (im Sylius-Admin) und spätere Preisänderungen (direkt mit update_variant_channel_pricing).

Schlägt eine Variante in einer Reihe fehl, bleiben die bereits angelegten Varianten bestehen. Der Wizard zeigt dir den Fehler und fragt, ob er mit den übrigen Kombinationen weitermachen soll.

Beispiel-Aufträge

Du formulierst Aufträge in natürlicher Sprache, Claude wählt die passenden Tools.

Produkt mit Variante anlegen:

"Lege ein neues Produkt an: Code stickmuster-blumenwiese, Channel WEB, Name 'Stickmuster Blumenwiese'. Füge eine Variante stickmuster-blumenwiese-v1 mit 4,99 EUR im Channel WEB hinzu und aktiviere das Produkt."

Claude ruft list_channels, create_product, add_variant (Preis 499 in Cent) und set_product_active auf.

Texte und SEO schreiben:

"Lies das Produkt stickmuster-blumenwiese, schreibe eine Beschreibung und Meta-Daten dazu und speichere sie."

Claude liest per get_product, formuliert den Text im Gespräch und schreibt ihn per update_product(translations=...). Der Server erzeugt selbst keine Texte.

Preis ändern:

"Setze den Preis der Variante stickmuster-blumenwiese-v1 im Channel WEB auf 5,99 EUR und behalte den Streichpreis."

Das nutzt update_variant_channel_pricing mit price=599; originalPrice bleibt unberührt.

Kategorie anlegen und verschieben:

"Lege die Kategorie ostern unter saisonal an und verschiebe fruehling unter ostern."

Bild per CDN-URL hinterlegen:

"Hinterlege für das Produkt stickmuster-blumenwiese das Bild https://cdn.example.com/bluemchen.webp."

Das nutzt add_product_image mit cdn_url. Für eine lokale Datei muss SYLIUS_IMAGE_UPLOAD_BASE_DIR gesetzt sein.

Versandart anlegen:

"Lege die Versandart standard-de für die Zone deutschland mit Pauschale 4,99 EUR für jeden Channel an."

Claude fragt zuerst list_channels ab, weil die Konfiguration einen Betrag für jeden Channel des Shops braucht.

Land deaktivieren:

"Deaktiviere das Land CH."

Stage zuerst, dann Prod

Stage und Prod sind getrennte MCP-Server. Du erkennst sie am Servernamen (syliusadmin-stage-mcp und syliusadmin-prod-mcp); außerdem nennt jeder Server in seinen Anweisungen die Umgebung, und list_channels liefert sie im Feld environment mit. Ein Tool-Aufruf kann die Umgebung nicht wechseln.

Schreibe zuerst auf Stage und prüfe das Ergebnis im Sylius-Admin, bevor du denselben Auftrag an den Prod-Server gibst. Der Server hat keinen Rollback und löscht nichts automatisch.