/MCP-Server

Shopware MCP Server

Shopware

Im Shopware-Kern eingebauter MCP-Server: Produkte, Bestellungen und Einstellungen per Chat abfragen und ändern – mit Vorschau vor jeder Änderung.

Offiziell Open Source
Software
Shopware
Typ
Offiziell
Lizenz
Open Source
Anbindung
Remote (HTTP)
Authentifizierung
API-Key

Einrichtung

Installation 
bin/console integration:create "MCP Client"

claude mcp add --transport http shopware https://<IHR_SHOP>/api/_mcp \
  --header "sw-access-key: <ACCESS_KEY>" \
  --header "sw-secret-access-key: <SECRET_ACCESS_KEY>"

Was der Server kann

Der MCP-Server ist ab Shopware 6.7.14 fester Bestandteil des Kerns und läuft auf dem eigenen Shop. Er bietet zwei Endpunkte: einen für die Shop-Verwaltung (Admin API) und einen für kundenseitige Agenten (Store API).

  • Daten lesen und auswerten: beliebige Shopware-Entitäten wie Produkte, Kategorien, Kunden oder Bestellungen suchen, lesen und aggregieren
  • Daten ändern: Datensätze anlegen, aktualisieren und löschen, inklusive Vorschau der Folgen beim Löschen
  • Bestellungen: den Status von Bestellung, Zahlung und Lieferung weiterschalten
  • Konfiguration: Systemeinstellungen und die Theme-Konfiguration eines Verkaufskanals lesen und ändern
  • Medien: Bilder von einer öffentlichen URL hochladen und als Produktbild setzen
  • Store API (experimentell): Grundlage für Shopping-Assistenten, die im Kontext eines Verkaufskanals mit denselben Daten wie die Storefront arbeiten

Typische Anwendungen

  • „Welche Produkte haben weniger als fünf Stück auf Lager?"
  • Preise einer Kategorie um einen Prozentsatz anpassen, erst als Vorschau, dann bestätigt
  • Offene Bestellungen prüfen und als versendet markieren
  • Umsätze und Bestellmengen nach Zeitraum oder Kategorie auswerten

Sicherheit & Berechtigungen

Schreibende Werkzeuge laufen standardmäßig im Probelauf: Shopware prüft die Änderung, zeigt sie an und verwirft sie wieder. Gespeichert wird erst, wenn der Agent den Probelauf ausdrücklich abschaltet. Ausnahme ist der Medien-Upload, der sofort ausgeführt wird.

Zugriff und Rechte steuert eine Shopware-Integration. Für den Produktivbetrieb empfiehlt Shopware, keine Admin-Integration zu verwenden, sondern eine Rolle mit genau den benötigten Rechten zuzuweisen.

Achtung: Das Werkzeug für Systemeinstellungen kann sensible Werte wie SMTP-Zugangsdaten oder API-Schlüssel betreffen. Diese Rechte sollten Sie nur gezielt vergeben.

Einrichtung

Auf Shopware 6.7.11 bis 6.7.13 lässt sich der Server über MCP_SERVER=1 in der .env aktivieren. Zugangsdaten gehören nicht in die Versionskontrolle.

Links