Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
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" |
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.
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, ChannelWEB, Name 'Stickmuster Blumenwiese'. Füge eine Variantestickmuster-blumenwiese-v1mit 4,99 EUR im ChannelWEBhinzu 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-v1im ChannelWEBauf 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
osternuntersaisonalan und verschiebefruehlingunterostern."
Bild per CDN-URL hinterlegen:
"Hinterlege für das Produkt
stickmuster-blumenwiesedas Bildhttps://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-defür die Zonedeutschlandmit 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 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.