Aktuelle Beiträge Zum Blog
In einfachen Worten: Worum geht es auf dieser Seite?

Ein Shop kann jetzt mit einem Programm sprechen, das selbst Aufgaben im Shop erledigt. Das Programm kann Artikel ändern und Aufträge lesen. Darum braucht es klare Grenzen. Sie legen fest, was das Programm sehen darf. Sie legen auch fest, was es ändern darf. Vor dem Speichern zeigt der Shop eine Vorschau. Ein Mensch prüft die Vorschau und gibt sie frei. Wir erklären die Schritte der Reihe nach.

Seit Shopware 6.7.11.0 enthält der Kern einen eigenen MCP-Server (Shopware Release Notes 6.7.11.0). Über das Model Context Protocol können KI-Agenten im Shopware-Backend arbeiten: Produkte suchen und pflegen, Bestellungen prüfen, Auswertungen anlegen. Aus einer Bitte im Chatfenster wird damit ein Schreibzugriff auf den Shop, und genau deshalb kommt es auf den Zuschnitt an. Laut Dokumentation wird jede MCP-Anfrage gegen die Shopware-Berechtigungen geprüft (Shopware-Dokumentation), welche Berechtigungen das sind, legen Sie selbst fest. Dieser Beitrag zeigt, wie Sie KI-Agenten über den MCP-Server kontrolliert einsetzen: mit eigener Integration je Assistent, ACL-Rolle mit minimalen Rechten, Allowlist, Probelauf vor dem Schreiben und Test in der Staging-Umgebung. Wenn Sie solche Abläufe nicht selbst aufsetzen möchten, gehört das zu unserer KI-Automation.

Was der MCP-Server im Shopware-Kern leistet

Das Model Context Protocol ist eine standardisierte Schnittstelle, über die KI-Agenten mit Shopware arbeiten (Shopware-Dokumentation). Der Server stellt drei Arten von Fähigkeiten bereit: Werkzeuge für Aktionen wie Produktsuche, Datensatzänderungen oder Statuswechsel von Bestellungen, Ressourcen mit Nachschlagedaten wie Verkaufskanälen, Währungen und Zustandsmaschinen sowie Prompts mit Hinweisen zum Datenmodell. Die Admin-Schnittstelle liegt unter /api/_mcp, eine zweite unter /store-api/_mcp arbeitet im Kontext eines Verkaufskanals. Für den Shopbetrieb nennt die Dokumentation etwa Produktbeschreibungen erzeugen, Produktdaten aktualisieren und Bestellungen prüfen.

Der Bedarf ist da. Etwas mehr als ein Viertel der Unternehmen ab zehn Beschäftigten in Deutschland nutzte 2025 künstliche Intelligenz, nämlich 26 Prozent (Destatis). Von diesen Unternehmen setzten 27 Prozent KI zur Automatisierung von Arbeitsabläufen oder zur Entscheidungsfindung ein (Destatis). Ein Agent, der im Backend Daten ändert, ist genau diese Art der Automatisierung, und er braucht dieselben Grenzen wie ein Mitarbeiter mit Backend-Zugang. Wie Rollen im Backend grundsätzlich geschnitten werden, beschreibt unser Beitrag Rollen und Rechte im Shop-Backend.

Unser Beitrag Model Context Protocol: Shop an KI-Agenten anbinden behandelt fremde Kaufagenten, die einen Shop von außen nutzen, und einen eigens angebundenen Server. Hier geht es um den Server im Kern und um Assistenten, die mit Rechten im Backend arbeiten.

Drei Versionen, drei Änderungen für Betreiber

Der Server hat sich innerhalb weniger Monate deutlich verändert. In 6.7.11.0 vom 16. Juni 2026 (GitHub, shopware/shopware) lag er noch hinter dem Feature-Flag MCP_SERVER. Seit 6.7.14.0 vom 9. September 2026 (GitHub, shopware/shopware) ist er ohne Schalter eingeschaltet (Shopware Release Notes 6.7.14.0), die MCP-Klassen bleiben aber bis 6.8.0 als experimentell markiert (Shopware Release Notes 6.7.14.0). 6.7.15.0 vom 1. Oktober 2026 (GitHub, shopware/shopware) brachte die Auswahl von Toolsets beim Verbindungsaufbau und erweitert zudem die Dokumente v2.

VersionVeröffentlichtWas sich für Betreiber ändert
6.7.11.016.06.2026MCP-Server im Kern, nur mit Feature-Flag MCP_SERVER; Allowlist je Integration in den Einstellungen
6.7.14.009.09.2026Flag entfällt, Endpunkte ohne Schalter erreichbar; neue Sitzungen sehen zunächst nur die Suchwerkzeuge; Lesen über Verknüpfungen braucht eigene Leserechte
6.7.15.001.10.2026Toolsets in der Verbindungsadresse wählbar; fehlende oder abgelaufene Token ergeben HTTP 401 statt HTTP 500
Seit 6.7.14.0 gibt es keinen Schalter mehr

Ab 6.7.14.0 läuft der MCP-Endpunkt mit, ob Sie ihn nutzen oder nicht. Die Anmeldung läuft über die Authentifizierung der Admin API, Integrationsschlüssel gehen direkt als Kopfzeilen mit (Shopware Release Notes 6.7.11.0). Ohne eigene Allowlist darf eine Integration mit Administratorrechten alle registrierten Werkzeuge, Ressourcen und Prompts aufrufen (Shopware-Dokumentation). Prüfen Sie bestehende Integrationen deshalb vor dem ersten Agenten, etwa wie in unserem Beitrag Shopware-Apps prüfen.

Drei Schichten, die jeder Aufruf passieren muss

Die Dokumentation beschreibt drei voneinander unabhängige Sicherheitsschichten, die jede Anfrage an den MCP-Endpunkt durchläuft, bevor eine Fähigkeit ausgeführt wird (Shopware-Dokumentation). Die erste ist die Anmeldung, in der Regel mit Zugangsschlüssel und geheimem Schlüssel einer Integration. Die zweite ist die MCP-Allowlist, die festlegt, welche Werkzeuge, Ressourcen und Prompts ein Zugang überhaupt aufrufen darf. Die dritte ist die ACL-Rolle der Integration: Auch ein freigegebenes Werkzeug scheitert, wenn der Rolle das nötige Recht auf der betroffenen Entität fehlt.

Jede MCP-Anfrage wird gegen die Shopware-Berechtigungen geprüft.

Shopware-Dokumentation: MCP Support in Shopware (eigene Übersetzung)

Anmeldung

Zugangsschlüssel und geheimer Schlüssel einer Integration als Kopfzeilen. Sie gelten, solange die Integration besteht (Shopware-Dokumentation).

Allowlist

Je Integration und je Benutzer: welche Werkzeuge, Ressourcen und Prompts sichtbar und aufrufbar sind. Eine leere Liste sperrt den ganzen Typ.

ACL-Rolle

Rechte je Entität und Aktion, etwa product:update. Sie entscheiden, ob ein freigegebenes Werkzeug den Datensatz wirklich ändern darf.

Zwei Ausnahmen sollten Sie kennen, weil sie die Schichten aushebeln. Benutzerkonten mit Administratorrechten umgehen die Allowlist unabhängig von der Anmeldeart (Shopware-Dokumentation). Eine Integration, die mit --admin angelegt wurde, umgeht dagegen die ACL-Prüfung, hält sich aber an ihre eigene Allowlist (Shopware-Dokumentation). Für einen Assistenten heißt das: weder mit dem Konto eines Administrators anmelden noch eine Admin-Integration verwenden, denn sonst trägt nur noch eine der beiden Schichten.

Allowlist nicht mit dem eigenen Administratorkonto testen

Ein Token aus der Anmeldung eines Administrators in der Verwaltung gehört zu dessen Benutzerkonto und umgeht damit die Allowlist. Die Dokumentation rät, das Verhalten der Allowlist mit Integrationsschlüsseln oder mit einem Benutzer ohne Administratorrechte zu prüfen (Shopware-Dokumentation). Sonst sieht der Test erfolgreich aus, obwohl er die Allowlist gar nicht berührt hat.

Für den zweiten Endpunkt gelten andere Regeln. /store-api/_mcp kennt weder ACL noch Allowlist: Jedes dort registrierte Werkzeug ist für jeden Client erreichbar, der sich am Verkaufskanal anmelden kann (Shopware-Dokumentation). Die Grenze bildet allein der Kontext des Verkaufskanals. Wer eigene Werkzeuge für diesen Endpunkt registriert, muss Eingaben deshalb im Werkzeug selbst prüfen. Die Grundlagen dazu stehen in unserem Beitrag Store API absichern.

Eine Integration je Assistent statt eines Generalschlüssels

Der Einstieg in der Dokumentation legt die Integration mit bin/console integration:create an. Das Flag --admin gewährt dabei vollen Zugriff auf die Admin API (Shopware-Dokumentation). Für den Produktivbetrieb rät die Dokumentation, es wegzulassen, eine eigene ACL-Rolle mit den nötigen Rechten anzulegen und sie der Integration zuzuweisen. Die Best Practices gehen weiter: eine Integration je Persona oder Aufgabe, jeweils mit eigener Allowlist für Werkzeuge (Shopware-Dokumentation).

Praktisch heißt das: Der Assistent, der Lieferzeiten und Produkttexte pflegt, bekommt eine andere Integration als der Assistent, der Bestellungen auswertet. Schreibt der Produktassistent unerwartet in Bestellungen, scheitert das an der Rolle und nicht an der Hoffnung, dass das Modell die Aufgabe richtig versteht. OWASP beschreibt dieses Prinzip als vollständige Vermittlung: Die Berechtigung wird im nachgelagerten System durchgesetzt, statt das Sprachmodell entscheiden zu lassen, ob eine Aktion erlaubt ist (OWASP).

Shopware-Konsole
# Integration ohne --admin anlegen, die ACL-Rolle danach in der Verwaltung zuweisen
bin/console integration:create "Assistent Produktpflege"

# Werkzeuge aus Sicht genau dieser Integration auflisten (beachtet deren Allowlist)
bin/console debug:mcp --integration=SWIA...

Zwei Eigenschaften der Schlüssel sind für den Betrieb wichtig. Integrationsschlüssel gelten, solange die Integration besteht, ohne Ablauf und ohne Erneuerung (Shopware-Dokumentation). Ein Bearer-Token der Admin API läuft dagegen standardmäßig nach zehn Minuten ab (Shopware-Dokumentation). Gerade weil der Integrationsschlüssel nicht abläuft, braucht jede Integration eine verantwortliche Person und wird gelöscht, sobald der Assistent nicht mehr gebraucht wird. Dateien mit den Schlüsseln gehören nicht in die Versionsverwaltung.

  • Der Name der Integration nennt Zweck und Assistenten, nicht nur das Werkzeug
  • Keine Integration mit --admin, kein Benutzerkonto mit Administratorrechten
  • Eigene ACL-Rolle, nur mit den Rechten für diese Aufgabe
  • Eigene Allowlist für Werkzeuge, Ressourcen und Prompts
  • Schlüssel außerhalb der Versionsverwaltung, Ablageort dokumentiert
  • Verantwortliche Person und Prüftermin notiert, Löschung zum Ende des Einsatzes geplant

Die ACL-Rolle: was der Assistent schreiben darf

Alle MCP-Werkzeuge halten sich an die ACL-Rolle, die der Integration in der Admin API zugewiesen ist (Shopware-Dokumentation). Bei schreibenden Werkzeugen prüft Shopware das Recht je Datensatz: Ein Eintrag ohne ID braucht das Recht zum Anlegen, ein Eintrag mit ID das Recht zum Ändern (Shopware-Dokumentation). Eine Rolle, die bei Produkten nur product:update enthält, kann vorhandene Artikel ändern, aber keine neuen anlegen. Für einen Assistenten in der Produktpflege ist das oft genau der richtige Zuschnitt.

Welche Rechte die Kernwerkzeuge verlangen

WerkzeugAufgabeRechte laut Dokumentation
shopware-entity-searchDatensätze suchenLeserecht auf die Entität, etwa product:read
shopware-entity-upsertDatensätze anlegen oder änderncreate ohne ID, update mit ID, jeweils je Entität
shopware-entity-deleteDatensätze löschendelete auf die Entität
shopware-order-stateStatus von Bestellung, Zahlung und Versand wechselnorder:read, beim Speichern je Aktion order:update, order_transaction:update oder order_delivery:update
shopware-system-config-writeSystemeinstellungen ändernsystem_config:update
shopware-media-uploadMedien von einer öffentlichen Adresse ladenmedia:create, mit Produktzuordnung zusätzlich product:update

Seit 6.7.14.0 prüfen die lesenden Entity-Werkzeuge auch Verknüpfungen: Wer eine Bestellung samt Kundendaten lädt, braucht neben order:read auch order_customer:read (Shopware Release Notes 6.7.14.0). Integrationen, die sich auf die fehlende Prüfung verlassen hatten, müssen die Leserechte für Verknüpfungen in ihre Rolle aufnehmen (Shopware Release Notes 6.7.14.0). Für den Betreiber ist das ein Vorteil. Ob ein Assistent Kundendaten sieht, ist damit eine eigene Entscheidung in der Rolle und kein Nebeneffekt des Bestellzugriffs.

Vorsicht mit dem Knopf für fehlende Rechte

Ist eine Rolle einer MCP-Integration zugewiesen, listet ihre Detailseite die Rechte auf, die die freigegebenen Werkzeuge verlangen. Mit einem Klick lassen sich alle fehlenden Rechte hinzufügen (Shopware-Dokumentation). Bei einer zu weiten Allowlist schließt das die Lücke in die falsche Richtung. Verkleinern Sie im Zweifel die Allowlist, statt die Rolle zu erweitern.

Plugins, Bundles und Apps können eigene Werkzeuge registrieren (Shopware-Dokumentation). Für solche Werkzeuge gilt eine Feinheit: Die Angabe #[McpToolRequires] füllt nur die Hinweise in der Verwaltung und die Ausgabe von debug:mcp, sie setzt selbst nichts durch. Die eigentliche Prüfung muss das Werkzeug mit requirePrivilege aufrufen (Shopware-Dokumentation). Bei individuellen Erweiterungen aus unserer Shopware-Entwicklung gehört diese Prüfung deshalb in den Code-Review jedes Werkzeugs.

Die Allowlist: welche Werkzeuge der Assistent überhaupt sieht

Die Allowlist setzen Sie in der Verwaltung je Integration in den Einstellungen der Integrationen und je Benutzer auf dessen Detailseite (Shopware-Dokumentation). Für jeden Typ gilt: Ein nicht gesetzter Wert erlaubt alle Fähigkeiten dieses Typs, eine Liste beschränkt auf die genannten Namen, eine leere Liste sperrt den Typ ganz. Wird ein Werkzeug freigegeben, nimmt Shopware dessen erklärte Abhängigkeiten automatisch mit (Shopware-Dokumentation). Wer shopware-entity-delete freigibt, gibt damit auch shopware-entity-search und shopware-entity-schema frei.

Die Verwaltung gruppiert die Werkzeuge nach Toolsets, sodass sich eine ganze Gruppe mit einem Klick freigeben lässt. Der Kern liefert sechs Toolsets: entity, system-config, media, order, theme und store-api (Shopware-Dokumentation). Das Toolset entity enthält lesende und schreibende Werkzeuge zugleich, vom Schema über Suche und Auswertung bis zu Anlegen, Ändern und Löschen. Wer die ganze Gruppe anklickt, gibt auch das Löschen frei. Die Best Practices nennen das Dilemma selbst: Eine Gruppe, die lesende Prüfung und zerstörende Schreibvorgänge mischt, zwingt zur Wahl zwischen zu viel und zu wenig (Shopware-Dokumentation). Für die Produktpflege genügen meist Schema, Suche, Lesen sowie Anlegen oder Ändern.

Systemeinstellungen enthalten Zugangsdaten

Die Systemkonfiguration kann laut Dokumentation SMTP-Zugangsdaten, Schlüssel von Zahlungsanbietern und weitere vertrauliche Werte enthalten (Shopware-Dokumentation). Das Toolset system-config gehört deshalb nur in die Allowlist eines Assistenten, der genau diese Aufgabe hat, und das Schreibwerkzeug shopware-system-config-write in den meisten Fällen in keine.

Zusätzlich gibt es einen installationsweiten Sicherheitsschalter. Die Liste allowed_tools unter shopware.mcp begrenzt die verfügbaren Werkzeuge für alle Integrationen schon beim Kompilieren des Containers (Shopware-Dokumentation). Eine leere Liste bedeutet keine Einschränkung. Wer sie füllt, muss die drei Suchwerkzeuge mit aufnehmen, sonst finden Clients die übrigen Werkzeuge nicht mehr. Auf einem Live-System kann der Schalter zum Beispiel nur lesende Werkzeuge zulassen, während die Staging-Umgebung den vollen Satz anbietet.

config/packages/shopware.yaml
shopware:
  mcp:
    allowed_tools:
      - shopware-tool-search
      - shopware-toolsets-list
      - shopware-toolset-enable
      - shopware-entity-schema
      - shopware-entity-search
      - shopware-entity-read
      - shopware-entity-aggregate

Toolsets in der Verbindungsadresse: Sichtbarkeit ist kein Recht

Seit 6.7.14.0 zeigt eine neue MCP-Sitzung zunächst nur drei Werkzeuge: die Werkzeugsuche, die Liste der Toolsets und das Einschalten eines Toolsets (Shopware Release Notes 6.7.14.0). Alle anderen Werkzeuge findet der Agent über die Suche, oder er schaltet ihr Toolset für die laufende Sitzung ein. Die Suche liefert dabei nur Werkzeuge, die die Allowlist ohnehin erlaubt. Seit 6.7.15.0 lassen sich Toolsets auch direkt in der Verbindungsadresse nennen, etwa /api/_mcp?toolsets=entity. Das hilft Clients, die die Werkzeugliste nur einmal je Verbindung lesen.

Wichtig ist die Grenze dieses Parameters. Er ändert laut Release Notes nur die Sichtbarkeit, was aufgerufen werden darf, entscheiden weiter Allowlist und Rolle (Shopware Release Notes 6.7.15.0). Ebenso gewährt das Einschalten eines Toolsets kein Recht, seine Werkzeuge aufzurufen (Shopware-Dokumentation). toolsets=all gibt dem Agenten also keine zusätzlichen Rechte, füllt aber sein Kontextfenster: Jedes Werkzeugschema kostet etwa 550 bis 1.400 Token (Shopware-Dokumentation), und die Werkzeugliste kommt mit 50 Einträgen je Seite (Shopware-Dokumentation). Die Dokumentation rät deshalb zu einer kurzen Liste gezielter Toolsets.

Zwei Fragen, zwei Stellen

„Was sieht der Agent?“ beantworten Toolsets und Verbindungsadresse. „Was darf der Agent?“ beantworten Allowlist und ACL-Rolle. Wer eine Einschränkung über die Adresse lösen will, hat nichts eingeschränkt. Die Begrenzung gehört in Allowlist und Rolle, die Adresse sorgt nur für Ordnung im Kontextfenster.

Der Probelauf: was dryRun prüft und was nicht

Schreibende Werkzeuge laufen standardmäßig als Probelauf, sodass ein Agent Änderungen vor dem Speichern ansehen kann (Shopware-Dokumentation). Technisch öffnet Shopware dabei eine Datenbanktransaktion, führt die Operation aus und rollt die Transaktion anschließend zurück (Shopware-Dokumentation). Aktionen aus dem Flow Builder werden im Probelauf unterdrückt (Shopware-Dokumentation), und erst ein erneuter Aufruf mit dryRun=false schreibt die Änderung. Beim Löschen liefert der Probelauf eine Vorschau der mitgelöschten Datensätze, bei Systemeinstellungen einen Vergleich von altem und neuem Wert.

Zwei Grenzen sollten Sie kennen. Erstens gilt der Probelauf nicht für alle schreibenden Werkzeuge: shopware-media-upload lädt sofort hoch und hat keinen Probelauf (Shopware-Dokumentation). Zweitens ist der Probelauf keine Freigabe durch einen Menschen. Den zweiten Aufruf mit dryRun=false stellt der Agent selbst. Die Best Practices begründen den Standard gerade damit, dass Agenten zur Selbstüberschätzung neigen und Schreibwerkzeuge schon beim ersten Versuch ohne Prüfung der Parameter aufrufen (Shopware-Dokumentation). Der Probelauf erzwingt zwei Schritte, aber er entscheidet nicht, wer den zweiten auslöst.

Die Freigabe muss deshalb an anderer Stelle sitzen. Die MCP-Spezifikation empfiehlt, dass ein Mensch Werkzeugaufrufe ablehnen kann und Anwendungen vor heiklen Operationen eine Bestätigung einholen (Model Context Protocol). OWASP rät, Aktionen mit großer Wirkung erst nach Zustimmung eines Menschen auszuführen (OWASP). Im Shopware-Umfeld heißt das: Der Client, über den der Assistent arbeitet, fragt vor jedem Schreibaufruf nach, oder der Assistent bekommt für das Live-System gar kein Schreibwerkzeug und erstellt nur eine Vorschau, die ein Mitarbeiter umsetzt.

  1. Auftrag eingrenzen: welche Artikel, welches Feld, welcher Zielwert
  2. Probelauf mit dryRun=true anfordern und die Vorschau ausgeben lassen
  3. Vorschau prüfen: Zahl der Datensätze, betroffene Felder, auffällige Ausreißer
  4. Freigabe durch einen Mitarbeiter im Client oder im Ticket festhalten
  5. Schreibaufruf mit dryRun=false auslösen und das Ergebnis im Backend stichprobenartig kontrollieren
Auch ein Probelauf liest echte Daten

Der Probelauf führt die Operation in einer Transaktion aus und liest dabei die Daten des Shops. Er schützt vor ungewollten Änderungen, nicht vor ungewollter Einsicht. Was der Assistent nicht lesen soll, schließen Allowlist und Rolle aus, nicht der Parameter dryRun.

Prompt Injection über Produkttexte und Bestellnotizen

Ein Agent liest, was im Shop steht, und kann Gelesenes wie eine Anweisung behandeln. Die Shopware-Dokumentation warnt: Werkzeugergebnisse mit nutzergenerierten Inhalten wie Bestellnotizen, Kundennamen oder Produktbeschreibungen können Text enthalten, der das Verhalten des Agenten umlenken soll. ACL und Allowlist begrenzen den möglichen Schaden, verhindern aber nicht, dass der Agent durch gelesene Daten in die Irre geführt wird (Shopware-Dokumentation). OWASP beschreibt das als indirekte Prompt Injection: Das Modell nimmt Eingaben aus externen Quellen auf, etwa aus Websites oder Dateien (OWASP).

Kommentare aus dem Checkout

Was Kunden ins Kommentarfeld schreiben, steht später in der Bestellung und wird beim Prüfen mitgelesen.

Produkttexte aus Importen

Texte aus Lieferantendaten oder ausgelesenen Datenblättern stammen nicht aus Ihrer Redaktion.

Namen und Adressen

Auch Stammdaten sind Eingaben von außen und können wie eine Anweisung formuliert sein.

Bewertungen

Wer Bewertungen zusammenfassen lässt, holt fremden Text in den Kontext des Agenten.

Die Dokumentation zieht daraus eine klare Folgerung: Für Abläufe, die Daten aus Kundenhand zeigen, sind lesende Integrationen vorzuziehen, und ein Agent sollte keinen Schreibzugriff bekommen, wenn die Aufgabe nur Lesen verlangt (Shopware-Dokumentation). Ein Assistent, der Bestellungen auswertet, braucht kein shopware-entity-upsert, einer für Produkttexte keinen Zugriff auf Bestellungen. Beide Aufgaben in einer Integration verbinden den riskantesten Lesekanal mit dem stärksten Schreibkanal. Mehr zu Angriffswegen und Gegenmaßnahmen steht in unserem Beitrag Prompt Injection: KI-Features im Shop absichern.

Datenschutz: Kundendaten im Kontextfenster

Jedes Werkzeugergebnis landet im Kontext des Sprachmodells und damit bei dem Dienst, der das Modell ausführt. Die DSGVO verlangt, dass durch Voreinstellung grundsätzlich nur personenbezogene Daten verarbeitet werden, deren Verarbeitung für den jeweiligen Zweck erforderlich ist (Art. 25 Abs. 2 DSGVO). Die getrennten Leserechte für Verknüpfungen seit 6.7.14.0 passen genau dazu: Ein Assistent, der nur Umsätze je Tag zusammenzählt, braucht die Verknüpfung zu den Kundendaten nicht und damit auch nicht das Recht order_customer:read.

Läuft das Modell bei einem externen Dienstleister, braucht es in der Regel einen Vertrag zur Auftragsverarbeitung, der unter anderem Gegenstand, Dauer, Art und Zweck der Verarbeitung festlegt (Art. 28 Abs. 3 DSGVO). Klären Sie das, bevor ein Assistent die erste Bestellung liest, und dokumentieren Sie je Integration, welche Entitäten sie lesen darf. Bei ERP-Anbindungen gilt dasselbe, und wir schneiden solche Schnittstellen nach demselben Prinzip zu.

Erst Staging, dann ein enger Zuschnitt im Live-Shop

Shopware bezeichnet den MCP-Server derzeit ausdrücklich als experimentell (Shopware-Dokumentation). Schnittstellen, Fähigkeiten und Erweiterungspunkte können sich je nach Rückmeldungen noch ändern. Wie schnell das geht, zeigt 6.7.15.0: Interne Dienstnamen wurden umbenannt, jeder der beiden Server bekam einen eigenen Sitzungsspeicher, und bestehende Sitzungen wurden nicht übernommen (Shopware-Dokumentation). Deshalb gehört jeder Assistent zuerst in eine Staging-Umgebung mit anonymisierten Testdaten, und jedes Update ist ein Anlass, die Abläufe dort erneut zu prüfen. Wie wir Updates planen, steht im Beitrag Shopware 6.8 vorbereiten.

Für den Betrieb setzt Shopware selbst Grenzen. Der Endpunkt /api/_mcp hat eigene Kontingente: 300 Aufrufe je Minute und 1.000 Aufrufe je zehn Minuten, gezählt je Zugangstoken und ersatzweise je IP-Adresse (Shopware-Dokumentation). Das bremst Angriffe auf die Anmeldung und Agenten, die in einer Schleife hängen. Über der Grenze antwortet Shopware mit HTTP 429 und nennt die Wartezeit im Antworttext, ohne Retry-After-Kopfzeile (Shopware-Dokumentation). Außerdem muss der Scheduler im Produktivbetrieb laufen, weil eine tägliche Aufgabe verwaiste Toolset-Sitzungen aufräumt (Shopware-Dokumentation). Auf unserem Shopware-Hosting konfigurieren und überwachen wir die dafür nötigen Cronjobs.

Protokoll und regelmäßige Überprüfung

Ein Assistent ist ein Zugang, der gepflegt werden muss. Die MCP-Spezifikation empfiehlt Clients, Werkzeugaufrufe für Prüfzwecke zu protokollieren (Model Context Protocol). Legen Sie fest, wo es liegt und wer es liest. Auf der Shopware-Seite hilft bin/console debug:mcp --integration=SWIA...: Der Befehl zeigt die Werkzeuge aus Sicht genau einer Integration und berücksichtigt deren Allowlist (Shopware-Dokumentation). So lässt sich prüfen, ob der Zuschnitt noch dem entspricht, was beim Einrichten beschlossen wurde. Unsere Shopware-Wartung spielt Updates zuerst in einer Kopie des Shops ein, dort lässt sich der Zuschnitt nach jedem Update prüfen.

  • Liste aller Integrationen mit Zweck, verantwortlicher Person und letzter Nutzung
  • Allowlist je Integration gegen die freigegebene Aufgabe abgleichen
  • ACL-Rolle auf Rechte prüfen, die über die Aufgabe hinausgehen oder per Klick auf fehlende Rechte hinzugekommen sind
  • Benutzerkonten mit Administratorrechten: Kein Assistent meldet sich damit an
  • Release Notes jeder neuen Shopware-Version auf Änderungen am MCP-Server lesen
  • Integrationen ohne Einsatz löschen, damit ihre Schlüssel ungültig werden

So setzen wir KI-Assistenten im Shopware-Backend auf

Wir richten KI-Assistenten für Shopware so ein, dass jede Schicht ihre Aufgabe erfüllt und der Probelauf in einen echten Freigabeablauf mündet. Der Weg führt in der Regel über drei Schritte.

Bestandsaufnahme

Wir erfassen vorhandene Integrationen, Rollen und Benutzerkonten mit Administratorrechten und prüfen, welche davon den MCP-Endpunkt heute erreichen würden.

Zuschnitt je Assistent

Für jede Aufgabe eine eigene Integration, eine ACL-Rolle mit minimalen Rechten und eine Allowlist ohne unnötige Schreib- und Löschwerkzeuge.

Staging und Freigabe

Test in der Staging-Umgebung, Probelauf mit Freigabe durch Ihr Team und ein Prüfplan für jedes Shopware-Update. Mehr zu unseren Leistungen rund um künstliche Intelligenz.

Ob ein Assistent im Backend sinnvoll ist, hängt von der Aufgabe ab. Lieferzeiten für eine Warengruppe setzen, fehlende Produktbeschreibungen finden oder die Bestellungen eines Tages auswerten sind gute Kandidaten, weil sich das Ergebnis vor dem Speichern prüfen lässt. Zahlungen, Stornierungen und Systemeinstellungen bleiben besser beim Team. Den Einstieg finden Sie über unsere KI-Automation.

Quellen und Studien

Dieser Beitrag stützt sich auf die Shopware-Dokumentation zum MCP-Server, die Shopware Release Notes 6.7.11.0, 6.7.14.0 und 6.7.15.0, die Veröffentlichungsdaten im Repository shopware/shopware auf GitHub, die Spezifikation des Model Context Protocol (Fassung 2025-11-25), die OWASP Top 10 for LLM Applications 2025 (LLM01, LLM06), die IKT-Erhebung 2025 von Destatis sowie Art. 25 und Art. 28 DSGVO. Abgerufen am 03.11.2026. Der MCP-Server ist experimentell, Werkzeuge und Verhalten können sich mit jeder Version ändern.

Ab Version 6.7.14.0 ist er ohne Feature-Flag eingeschaltet (Shopware Release Notes 6.7.14.0). In 6.7.11.0 bis 6.7.13.x muss das Flag MCP_SERVER gesetzt sein. Was ein Assistent damit tun kann, hängt von Integrationsschlüssel, Allowlist und ACL-Rolle ab.

In der Regel nicht. Der Probelauf zeigt die Änderung, den Aufruf zum Speichern kann der Agent aber selbst stellen. Die Freigabe gehört in den Client oder den Arbeitsablauf. Zudem hat shopware-media-upload keinen Probelauf und lädt sofort hoch (Shopware-Dokumentation).

Nur teilweise. Eine mit --admin angelegte Integration umgeht die ACL-Prüfung, hält sich aber an ihre Allowlist. Ein Benutzerkonto mit Administratorrechten umgeht die Allowlist dagegen vollständig (Shopware-Dokumentation). Für Assistenten empfiehlt sich deshalb eine Integration ohne Administratorrechte mit eigener Rolle.

Er bestimmt seit 6.7.15.0, welche Werkzeuge der Client beim ersten Abruf der Werkzeugliste sieht. Rechte verleiht er nicht, darüber entscheiden weiter Allowlist und Rolle (Shopware Release Notes 6.7.15.0).

Das ist eine Frage des Zwecks. Nach Art. 25 Abs. 2 DSGVO sollen durch Voreinstellung nur die Daten verarbeitet werden, die für den Zweck erforderlich sind. Shopware trennt seit 6.7.14.0 die Leserechte für Verknüpfungen, etwa order_customer:read. Läuft das Modell bei einem externen Dienstleister, ist in der Regel ein Vertrag zur Auftragsverarbeitung nötig (Art. 28 Abs. 3 DSGVO).

Shopware kennzeichnet den Server als experimentell, Schnittstellen und Verhalten können sich noch ändern (Shopware-Dokumentation). Sinnvoll ist zuerst ein Test in der Staging-Umgebung, danach ein enger Zuschnitt im Live-Shop mit Freigabe vor jedem Schreiben. Welcher Ablauf passt, besprechen wir gern über unser Kontaktformular.