¶ MCP Server: Shopware 6 Admin API
Diese Dokumentation bezieht sich immer auf den aktuellen Stand des main-Branches.
Status: Der Nachfolger dieses Servers ist Sylius Admin. Laut dessen README ist Shopware nicht mehr im Einsatz. Das GitHub-Repository dieses Servers ist nicht archiviert und enthält selbst keinen Hinweis auf eine Ablösung.
¶ Überblick
claude-mcp-shopwareadmin ist ein MCP-Server (Model Context Protocol), über den Claude die Admin API eines Shopware-6-Shops bedient. Er stellt 42 Tools bereit: Produkte anlegen und ändern, Beschreibungen und SEO-Daten vorbereiten und speichern, Kategorien, Medien mit Alt-Text-Audit, Mail-Templates, Flows, Bestellungen (nur lesend), Cross-Selling und SEO-URLs.
Claude erledigt Shop-Pflege direkt im Shop, ohne Copy-Paste und ohne Browser-Wechsel. Produkte entstehen immer inaktiv, und Bestellungen lassen sich nur lesen.
Die Arbeitsteilung: Du legst Varianten und Bilder im Shopware-Admin an, Claude übernimmt Texte, SEO und Verwaltung. Die Content-Tools erzeugen keine Texte selbst, sie liefern Kontext und Vorgaben aus konfigurierbaren Stil-Profilen, die Texte schreibt Claude.
¶ Dokumentation
| Seite | Inhalt |
|---|---|
| Installation | Voraussetzungen, Build, Deployment, Registrierung in Claude Code, Update, Deinstallation |
| Konfiguration | Umgebungsvariablen, Shopware-Integration, Content-Profile |
| Tool-Referenz | Alle 42 Tools mit Parametern, Grenzwerten und Rückgaben |
| Verwendung | Typische Abläufe von der Produktanlage bis zum SEO-URL-Audit |
| Sicherheit und Datenschutz | Zugangsdaten, Token, Schutzmechanismen, Protokollierung, Datenflüsse |
| Fehlerbehebung | Meldungen, Ursachen, Lösungen und häufige Fragen |
| Technische Details | Aufbau, Request-Ablauf, Cache, Fehlerformat, Entwicklung |
¶ Features
| Feature | Beschreibung |
|---|---|
| Produkte | Anlegen (immer inaktiv), lesen, listen, suchen, ändern, aktivieren und deaktivieren, mit Tags, Suchbegriffen und Custom Fields |
| Content und SEO | Vorgaben für Beschreibung, SEO-Metadaten und Varianten-Texte, Speichern per content_update |
| Content-Profile | Ton, Anrede, Aufbau und Zielgruppe je Stil in einer JSON-Datei, automatische Zuordnung über die Produktkategorie |
| Kategorien | Liste, Details mit Produkten, SEO-Texte und SEO-Felder |
| Medien | Liste, Suche, Alt-Text und Titel ändern, Alt-Text-Audit für Produktbilder, Upload per URL |
| Mail-Templates und Flows | Templates lesen und ändern, Test-Mail senden, Flows ansehen und ein- oder ausschalten |
| Bestellungen | Liste, Details und Statistiken, nur lesend |
| Cross-Selling | Gruppen lesen, anlegen, ändern und Kandidaten für Empfehlungen ermitteln |
| SEO-URLs | Liste, Audit auf gelöschte, doppelte und fehlende kanonische URLs, Ändern |
| Anbindung | OAuth2 Client Credentials, stdio-Transport, Wiederholung bei Ablauf des Tokens und bei 429 |
¶ Anforderungen
| Anforderung | Hinweise |
|---|---|
| Node.js | 20 oder neuer |
| Claude Code | Oder ein anderer MCP-Client mit stdio-Transport |
| Shopware 6 | Admin API erreichbar, Integration mit Client-ID und Secret, siehe Konfiguration |
| Optional | Plugin mit der Entität mmd-product-snippet für Textbausteine |
¶ Lizenz
MIT License - Lizenztext auf GitHub
¶ Support
Repository: github.com/markus-michalski/claude-mcp-shopwareadmin
Issues: GitHub Issues