Shopware MCP-Server: KI-Agenten aus der EU mit Shopware verbinden

Die shopware AG aus Schöppingen entwickelt Shopware 6, eine Open-Source-E-Commerce-Plattform, die viele europäische Händler und Marken nutzen. Seit Version 6.7.11.0 enthält der Kern einen MCP-Server unter /api/_mcp für die Admin-API und einen zweiten unter /store-api/_mcp für Agenten auf Kundenseite.

Beide nutzen Streamable HTTP. Ab 6.7.14.0 ist der Server standardmäßig aktiv und bietet schrittweise Tool-Ermittlung: einen kleinen Standardsatz plus Suche, sodass der Agent nur die Toolsets lädt, die er braucht. Shopware nennt die Funktion bis 6.8 experimentell, Toolnamen können sich also noch ändern.

Ein Merchandising-Agent findet Produkte einer Kategorie ohne Beschreibung oder Bilder, entwirft fehlende Texte auf Deutsch und Französisch und pflegt sie nach Prüfung ein. Ein Kundenservice-Agent sucht eine Bestellung per Nummer, liest Liefer- und Zahlungsstatus und schaltet sie nach Bestätigung durch eine Person weiter.

Operations-Teams fragen nach Bestellungen, die seit über drei Tagen „in Bearbeitung“ hängen, oder listen Kunden auf, die ein zurückgerufenes Produkt gekauft haben. Entwickler prüfen beim Debuggen die Systemkonfiguration über mehrere Verkaufskanäle hinweg.

Legen Sie in Shopware eine Integration für den Agenten an. Verzichten Sie im Produktivbetrieb auf die Option --admin; erstellen Sie stattdessen eine ACL-Rolle mit genau den nötigen Rechten und weisen Sie sie der Integration zu. Sie erhalten eine Access-Key-ID und einen Secret-Access-Key.

Fügen Sie auf inference.eu den Shopware-Connector zu einem Agenten hinzu und geben Sie die URL /api/_mcp Ihres Shops sowie die beiden Zugangsdaten an. Sie werden verschlüsselt in der EU gespeichert und als Header sw-access-key und sw-secret-access-key gesendet. In der Shopware-Administration begrenzen Sie zusätzlich, welche Tools die Integration aufrufen darf.

Der MCP-Server läuft in Ihrer eigenen Shopware-Installation, wo immer Sie sie betreiben. Shopdaten laufen also nicht über Server der shopware AG, solange Sie nicht deren Cloud-Angebot nutzen. Anfragen gehen vom Agenten direkt an Ihren Shop.

Auf inference.eu läuft das Modell, das Bestellungen und Kundendaten liest, in Rechenzentren in der EU, und Ihre Integrations-Zugangsdaten werden verschlüsselt in der EU gespeichert. Bestellungen enthalten Namen, Adressen und Kaufhistorie; geben Sie Agenten nur die Entitäten frei, die ihre Aufgabe erfordert.

Shopware prüft bei jedem Tool-Aufruf die ACL, begrenzt die Rate pro Principal und erlaubt Tool-Freigabelisten je Integration und Benutzer. Beachten Sie, dass MCP-Ressourcen noch nicht ACL-geprüft werden; behandeln Sie alles in einer angemeldeten Sitzung als lesbar.

Auf inference.eu können Sie für Schreibaufrufe wie Statuswechsel einer Bestellung, Preisänderungen oder Änderungen der Systemkonfiguration eine Freigabe durch eine Person verlangen, während Produkt- und Bestellabfragen frei laufen. Testen Sie zuerst in einem Staging-Shop, da die Funktion noch experimentell ist.