MCP Server: Sylius Admin API
Claude-Code-Plugin mit MCP-Server für Sylius 2.2: Produkte, Varianten, Kategorien, SEO, Länder, Zonen und Versandarten verwalten. Getrennte Server für Stage und Prod, Produkt-Wizard als Skill.
Sylius Admin: Claude-Code-Plugin mit MCP-Server
Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Überblick
claude-plugin-syliusadmin ist ein Claude-Code-Plugin. Es bringt einen MCP-Server (Model Context Protocol) mit, über den Claude den Katalog eines Sylius-2.2-Shops und die zugehörige Shop-Konfiguration verwaltet: Produkte, Varianten und Preise, Kategorien, Attribute, Optionen, Bilder, Content und SEO, Länder, Zonen, Versandarten und Steuerklassen. Dazu kommt ein Skill, der durch das Anlegen eines Produkts führt. Das Plugin ist der Nachfolger von claude-mcp-shopwareadmin, Shopware ist im zugrundeliegenden Shop nicht mehr im Einsatz.
Claude erledigt Katalogpflege direkt im Shop, ohne Copy-Paste und ohne Browser-Wechsel. Jeder Server bedient strukturell nur eine Umgebung (Stage oder Prod), und eine feste Allowlist hält ihn auf Katalog und Shop-Konfiguration beschränkt.
Bewusst nicht enthalten sind Bestellungen, Kunden, Promotions und die Verwaltung von Admin-Usern. "Versand" meint die Versand-Konfiguration, nicht das Verschicken einzelner Bestellungen.
graph LR
A["Claude Code"] --> B["syliusadmin-stage-mcp"]
A --> C["syliusadmin-prod-mcp"]
A --> D["Skills: setup, sylius-produkt-wizard"]
B --> E["Sylius Stage Admin API"]
C --> F["Sylius Prod Admin API"]
Dokumentation
| Seite | Inhalt |
|---|---|
| Installation | Plugin installieren, Setup-Skill, manuelle Installation, Deinstallation |
| Konfiguration | Umgebungsvariablen, .env für Stage und Prod, Admin-User, Stage-Key, Bild-Upload |
| Tool-Referenz | Alle 55 Tools mit Parametern und Regeln |
| Verwendung | Produkt-Wizard, Beispiel-Aufträge, Arbeiten mit Stage und Prod |
| Sicherheit und Datenschutz | Zugangsdaten, Allowlist, Löschschutz, Upload-Beschränkung, Datenflüsse |
| Fehlerbehebung | Häufige Probleme, Lösungen und FAQ |
| Technische Details | Plugin-Aufbau, Request-Ablauf, Verzeichnisstruktur, Abhängigkeiten |
Features
| Feature | Beschreibung |
|---|---|
| Katalog | Produkte, Varianten, Kategorien (Taxons), Attribute und Optionen anlegen und ändern, inklusive Channel-Preisen |
| Content und SEO | Name, Slug, Beschreibung, Meta-Felder und SEO-Felder über das translations-Feld; die Texte schreibt Claude im Gespräch |
| Bilder | Upload lokaler Dateien oder Registrierung von CDN-Bildern per URL, für Produkte und Kategorien |
| Shop-Konfiguration | Länder, Zonen, Versandarten, Versandkategorien und Steuerklassen |
| Plugin-Daten | Marketplace-Links (anlegen, ändern, löschen) und Eingabefeld-Definitionen (nur lesen) |
| Produkt-Wizard | Skill /syliusadmin:sylius-produkt-wizard mit geführtem Dialog für einfache und konfigurierbare Produkte |
| Stage/Prod-Trennung | Zwei Server mit eigener .env, kein Umgebungs-Parameter pro Tool-Aufruf |
| Schutz | Pfad-Allowlist, kein Löschen außer bei Marketplace-Links, Aktivierungsschutz, Beschränkung des Datei-Uploads |
| Protokoll | MCP-konform, Transport stdio |
Anforderungen
| Anforderung | Version | Hinweise |
|---|---|---|
| Claude Code | aktuell | mit Plugin-Unterstützung |
| Python | 3.12 oder neuer | für venv und Server |
| Sylius | 2.2 | Admin API (/api/v2/admin/) erreichbar |
| Sylius-Admin-User | eigener User | mit Rolle ROLE_API_ACCESS, siehe Konfiguration |
| Optionale Shop-Plugins | - | sylius-seo-suite-pro, sylius-cdn-product-images, sylius-marketplace-redirect, sylius-product-custom-inputs für die jeweiligen Funktionen |
Granulare Admin-Rollen gibt es nur in Sylius Plus. In der Community Edition ist jeder Admin-User technisch Voll-Admin. Die Beschränkung auf den Katalog erzwingt der Server selbst per Pfad-Allowlist, nicht Sylius.
Lizenz
MIT License - Markus Michalski
Support
Repository: github.com/markus-michalski/claude-plugin-syliusadmin
Issues: GitHub Issues