Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
| Anforderung | Hinweise |
|---|---|
| Claude Code | Mit Plugin-Unterstützung (Marketplace) |
| Python | 3.12 oder neuer (requires-python = ">=3.12") |
| Sylius | 2.2 mit erreichbarer Admin API (/api/v2/admin/) |
| Admin-User | Eigener Sylius-Admin-User für die API, siehe Konfiguration |
Die Python-Abhängigkeiten (mcp, httpx, python-dotenv, anyio) installiert der Setup-Skill aus der requirements.txt des Plugins.
claude plugin marketplace add markus-michalski/claude-plugin-syliusadminsyliusadmin aus diesem Marketplace aktivieren./syliusadmin:setup.env-Dateien eintragen (siehe unten und Konfiguration).Der Setup-Skill erledigt folgende Schritte:
| Schritt | Ergebnis |
|---|---|
| Python finden | Probiert python3, python und py -3, unter Windows zusätzlich bekannte Installationspfade |
| Version prüfen | Python 3.12 oder neuer |
| Venv anlegen | ~/.claude-plugin-syliusadmin/venv (Windows: %USERPROFILE%\.claude-plugin-syliusadmin\venv) |
| Abhängigkeiten installieren | pip install -r requirements.txt aus dem Plugin-Verzeichnis |
.env-Dateien anlegen |
~/.claude-plugin-syliusadmin/stage/.env und ~/.claude-plugin-syliusadmin/prod/.env, jeweils aus .env.example; in der Prod-Datei wird SYLIUS_ENVIRONMENT=prod gesetzt |
| Layout prüfen | Server-Modul importierbar, bin/run-server und beide .env-Dateien vorhanden |
Der Skill trägt niemals Zugangsdaten für dich ein, er legt nur die Dateien an. Er läuft bei jedem Aufruf erneut und korrigiert dabei auch eine falsch beschriftete prod/.env, ist also zugleich der Reparaturweg.
Nach dem Setup registriert das Plugin zwei MCP-Server:
| Server | Umgebung | Konfigurationsdatei |
|---|---|---|
syliusadmin-stage-mcp |
Stage | ~/.claude-plugin-syliusadmin/stage/.env |
syliusadmin-prod-mcp |
Prod | ~/.claude-plugin-syliusadmin/prod/.env |
Direkt nach der Installation steht
syliusadmin-prod-mcpauffailed. Das ist erwartet: Dieprod/.enventhält noch keine echten Zugangsdaten. Erst nach dem Befüllen und einem Neustart wird auch der Prod-Serverconnected.
Der Starter
bin/run-serverruft den Python-Interpreter aus~/.claude-mcp-syliusadmin/venvauf (Windows:%USERPROFILE%\.claude-mcp-syliusadmin\venv), während der Setup-Skill das venv unter~/.claude-plugin-syliusadmin/venvanlegt. Bleiben beide Server trotz befüllter.env-Dateien auffailed, fehlt das venv am vom Starter erwarteten Pfad. Lege es dort mit denselben Abhängigkeiten an, siehe Fehlerbehebung.
Dieser Weg verzichtet auf das Plugin-System. Es gibt dann keine Skills (Setup, Produkt-Wizard), der MCP-Server selbst funktioniert gleich.
mkdir -p ~/.claude/mcp-servers/syliusadmin-stage
cp -r servers/syliusadmin-server/src servers/syliusadmin-server/run.py requirements.txt \
~/.claude/mcp-servers/syliusadmin-stage/
cp .env ~/.claude/mcp-servers/syliusadmin-stage/.env
cd ~/.claude/mcp-servers/syliusadmin-stage && python3 -m venv venv && ./venv/bin/pip install -r requirements.txt
claude mcp add --scope user --transport stdio syliusadmin-stage -- \
~/.claude/mcp-servers/syliusadmin-stage/venv/bin/python3 \
~/.claude/mcp-servers/syliusadmin-stage/run.py
Für Prod wiederholst du die Schritte in einem eigenen Verzeichnis (zum Beispiel ~/.claude/mcp-servers/syliusadmin-prod/) mit SYLIUS_ENVIRONMENT=prod und den Prod-Zugangsdaten.
Ohne SYLIUS_ENV_NAME und SYLIUS_ENV_FILE liest run.py die .env direkt neben sich selbst.
Zum Ausführen der Tests reicht ein venv im Projektordner, ein MCP-Betrieb ist dafür nicht nötig:
python3 -m venv venv
./venv/bin/pip install -r requirements-dev.txt
cp .env.example .env
./venv/bin/python3 -m pytest
/mcp in Claude Code öffnen: syliusadmin-stage-mcp muss connected sein.list_channels auf.Nach dem Eintragen der Zugangsdaten lädt Claude Code die MCP-Server beim nächsten Start neu. run.py liest die .env bei jedem Start und die Datei gewinnt gegen bereits gesetzte SYLIUS_*-Variablen im Prozess.
~/.claude-plugin-syliusadmin/ löschen (Windows: %USERPROFILE%\.claude-plugin-syliusadmin). Er enthält das venv und beide .env-Dateien mit den Zugangsdaten.~/.claude-mcp-syliusadmin/ löschen.claude mcp remove --scope user syliusadmin-stage (und syliusadmin-prod) ausführen und das Verzeichnis unter ~/.claude/mcp-servers/ löschen.Auf dem Sylius-Shop selbst bleibt nichts zurück, der Server installiert dort nichts.
Lief der Server bisher als git clone unter ~/.claude/mcp-servers/syliusadmin-stage, geh so vor:
.env-Dateien sichern./syliusadmin:setup ausführen..env-Dateien unter ~/.claude-plugin-syliusadmin/ eintragen.claude mcp remove --scope user syliusadmin-stage (und -prod).git pull ausführen, weil run.py im Repo inzwischen unter servers/syliusadmin-server/ liegt.