Wie das Model Context Protocol funktioniert, welche Clients es unterstützen und was der native MCP Server in Shopware 6.7 leistet: Tools, Rechte, Freigaben, Risiken, Einrichtung und Kosten.
Ein MCP Server ist eine standardisierte Schnittstelle, über die KI-Assistenten wie Claude oder ChatGPT auf Daten und Funktionen eines Systems zugreifen. Das zugrunde liegende Model Context Protocol hat Anthropic im November 2024 als offenen Standard veröffentlicht, seit Dezember 2025 liegt es bei der Linux Foundation.
Shopware 6.7 enthält einen eigenen MCP Server, seit Version 6.7.14 ist er ohne weitere Einstellung aktiv. Er läuft unter /api/_mcp, nutzt die Rechte der Admin API, also der Verwaltungsschnittstelle von Shopware, und erlaubt Suchen, Auswerten und, nach Freigabe, Ändern von Produkten, Bestellungen und Einstellungen.
Die Technik ist kostenlos, der Aufwand liegt in Rechten, Freigaben und Protokollierung. Eine saubere Einrichtung mit Rollen und einem Audit-Log, das jede Aktion festhält, kostet nach unserer Erfahrung 1.500 bis 5.000 €, individuelle Tools für eigene Prozesse 5.000 bis 20.000 €.
Wir haben vor der Gründung von solution25 selbst einen Online-Shop auf mehr als 500 Bestellungen am Tag gebracht und setzen seit 2017 Shopware-Projekte um, inzwischen auch Anbindungen an Claude, ChatGPT und die Workflow-Plattform n8n. Mit AI Connect, unserem MCP Connector für Shopware, haben wir eine eigene Erweiterung entwickelt, die diese Verbindung mit Rollen, Freigaben und Protokoll absichert.
Weil der MCP Server zum Kern gehört, stellt sich in jedem aktuellen Shopware-Shop die Frage, wer darüber was lesen und ändern darf. Dieser Beitrag richtet sich an Shop-Betreiber und E-Commerce-Leiter mit eigenem Shopware-6-Shop, die Claude, ChatGPT oder n8n an Produkte, Bestellungen und Berichte anbinden wollen, und an die Entwickler, die das umsetzen.
Nach dem Lesen können Sie entscheiden, ob MCP Server, der Copilot in der Shopware-Administration, n8n oder die Admin API zu Ihrer Aufgabe passt, und einen Zugang einrichten, der nicht mehr darf als nötig. Alle Preise Stand Oktober 2026, zuzüglich Mehrwertsteuer.
Das Model Context Protocol (MCP) ist ein offener Standard, der KI-Anwendungen mit externen Datenquellen und Werkzeugen verbindet. Anthropic hat es am 25. November 2024 veröffentlicht, zusammen mit SDKs, also Programmierbibliotheken, und ersten Servern für Google Drive, Slack, GitHub, Git, Postgres und Puppeteer (Ankündigung von Anthropic).
Der Grundgedanke: Statt für jede Kombination aus KI-Assistent und Fachsystem eine eigene Integration zu bauen, spricht jedes System einmal MCP und ist damit für alle Clients erreichbar. Am 9. Dezember 2025 hat Anthropic das Protokoll an die Agentic AI Foundation unter dem Dach der Linux Foundation übergeben, mit Block und OpenAI als Mitgründern, und nannte dabei mehr als 10.000 aktive öffentliche MCP Server sowie über 97 Millionen SDK-Downloads im Monat (Mitteilung zur Übergabe).
MCP folgt einer Client-Server-Architektur mit drei Rollen (Architekturbeschreibung):
Die Kommunikation läuft über JSON-RPC 2.0, also über strukturierte Nachrichten. Das Protokoll regelt nur diesen Austausch, nicht, wie die KI den Kontext verwendet.
Umgekehrt kann ein Server den Client bitten, beim Nutzer nachzufragen (Elicitation), etwa um eine Änderung bestätigen zu lassen.
Bei stdio startet der Client den Server als lokalen Prozess und tauscht Nachrichten über die Standard-Ein- und Ausgabe aus. Streamable HTTP schickt jede Nachricht als HTTP-POST an einen Endpunkt und erlaubt entfernte Server mit vielen Clients gleichzeitig (Transports in der Spezifikation). Der ältere Transport HTTP+SSE (Server-Sent Events) gilt seit Protokollversion 2025-03-26 als veraltet.
MCP versioniert nach Datum, aktuell ist die Revision 2026-07-28 (Versionierung). Sie macht das Protokoll zustandslos, der Abgleich von Version und Fähigkeiten zu Beginn einer Verbindung entfällt (Changelog). Shopware hat diese Revision noch deaktiviert und arbeitet mit dem bisherigen Verbindungsaufbau, den aktuelle Clients weiterhin beherrschen.
Inzwischen unterstützen alle großen KI-Assistenten das Protokoll, mit Unterschieden bei Transport, Anmeldung und Freigaben.
| Client | MCP-Unterstützung | Freigabe von Schreibzugriffen |
|---|---|---|
| Claude.ai und Claude Desktop | Entfernte Server als „Custom Connector“ auf allen Plänen (Free: ein Connector), lokale Server per Konfigurationsdatei oder .mcpb-Erweiterung | Jeder Tool-Aufruf wird zur Freigabe vorgelegt |
| Claude Code | stdio, HTTP und SSE; Konfiguration per Befehl oder .mcp.json; OAuth-Login über /mcp | Projekt-Server müssen bestätigt werden, Tool-Rechte über Permissions |
| ChatGPT | Developer Mode mit vollem MCP-Client auf Plus, Pro, Business, Enterprise und Edu; SSE und Streamable HTTP; OAuth oder ohne Anmeldung | Schreibaktionen verlangen standardmäßig eine Bestätigung |
| OpenAI Responses API und Agents SDK | Entfernte Server als Tool-Typ „mcp“, im Agents SDK auch stdio und Streamable HTTP | require_approval je Tool, Standard ist Freigabe |
| Cursor | stdio, SSE, Streamable HTTP; .cursor/mcp.json; OAuth | Fragt standardmäßig vor jedem Tool-Aufruf |
| n8n | MCP Client Tool im AI-Agent-Node, MCP Server Trigger, Instanz-MCP-Server für externe Clients | Keine Rückfrage im Workflow, Freigaben bauen Sie selbst |
| Shopware Copilot | Verbindet sich mit dem MCP-Endpunkt des eigenen Shops | Vorschau per Dry-Run, Änderung erst nach Freigabe |
Quellen: Claude Connectors, Claude Code, ChatGPT Developer Mode, OpenAI API, Cursor, n8n Trigger, n8n Instanz-Server. Entwickler greifen meist zu Claude Code oder Cursor, Fachabteilungen zu Claude Desktop oder ChatGPT, Prozesse ohne menschlichen Eingriff laufen über n8n.
MCP gibt einem Sprachmodell Zugriff auf echte Systeme. Die Spezifikation enthält deshalb eigene Sicherheitsleitlinien, und die Clients setzen Freigaben um. Die wichtigsten Punkte für Shop-Betreiber:
Shopware hat zunächst mit einem separaten Node.js-Paket experimentiert (shopware-admin-mcp auf GitHub, inzwischen archiviert). Seit Juni 2026 liefert Shopware einen nativen MCP Server mit dem Kern aus, gebaut auf dem Symfony MCP Bundle des PHP-Frameworks unter Shopware (Dokumentation des Shopware MCP Servers).
Der Endpunkt für die Administration lautet /api/_mcp, der für die Storefront /store-api/_mcp, beide über Streamable HTTP. Shopware kennzeichnet den Server bis Version 6.8 als experimentell, Tool-Namen können sich also noch ändern. Aktuell ist laut endoflife.date Version 6.7.15.1 vom 2. Oktober 2026.
Der Kern bringt keine Spezial-Tools für „Produkt anlegen“ oder „Kunde suchen“ mit, sondern generische Werkzeuge auf Basis der Admin API, die mit jeder Entität arbeiten (Tools-Referenz). Dazu kommen Resources mit Referenzdaten wie Verkaufskanälen, Währungen und Statusmaschinen sowie der Prompt shopware-context.
| Toolset | Tools | Zugriff | Benötigte Rechte |
|---|---|---|---|
| Discovery | shopware-tool-search, shopware-toolsets-list, shopware-toolset-enable | Suchen und Aktivieren in der Sitzung | keine |
| Entity | shopware-entity-schema, shopware-entity-search, shopware-entity-read, shopware-entity-aggregate, shopware-entity-upsert, shopware-entity-delete | Lesen, Auswerten, Schreiben, Löschen | Lesen, Anlegen, Ändern oder Löschen je Entität |
| System-Config | shopware-system-config-read, shopware-system-config-write | Lesen, Schreiben | system_config:read beziehungsweise system_config:update |
| Media | shopware-media-upload | Schreiben, ohne Dry-Run | media:create, bei Produktbild zusätzlich product:update |
| Order | shopware-order-state | Status von Bestellung, Zahlung und Lieferung ändern | order:read plus Update-Rechte je Aktion |
| Theme | shopware-theme-config | Lesen oder Schreiben | theme:read beziehungsweise theme:update |
Alle schreibenden Tools laufen standardmäßig als Dry-Run: Das Modell bekommt eine Vorschau der Änderung und muss den Aufruf mit dryRun=false wiederholen, um sie auszuführen. Einzige Ausnahme ist der Medien-Upload, der sofort hochlädt.
Je Integration und je Benutzer pflegen Sie eine Allowlist der erlaubten Tools, Resources und Prompts. Sie ist die Sicherheitsgrenze zur Laufzeit, denn das Aktivieren eines Toolsets vergibt keine Rechte. Administratoren umgehen die Benutzer-Allowlist, deshalb gehört ein MCP-Zugang nie an ein Admin-Konto.
Außerdem begrenzt Shopware die Aufrufe: 300 pro Minute und 1.000 pro zehn Minuten am Admin-Endpunkt, 120 und 600 am Store-API-Endpunkt (Konfiguration). Für Massenänderungen bleibt die Sync API, über die Shopware viele Datensätze in einem Aufruf schreibt, der bessere Weg.
Der Copilot, der Chat-Assistent in der Administration, verbindet sich mit dem MCP-Endpunkt des Shops und arbeitet mit den Rechten des angemeldeten Händlers. Ändernde Tools ruft er zuerst als Dry-Run auf, zeigt eine Freigabekarte und führt die Änderung erst nach Bestätigung aus (Copilot Tool Approval).
Laut Shopware steht der Copilot ab Version 6.7.1.0 allen Händlern offen, auch in der Community Edition, seine agentischen Funktionen sind seit 6.7.15.0 stabil (Release News Oktober 2026). Sie gehören zu Shopware Intelligence+, dem KI-Zusatzabo von Shopware, für 19 € im Monat, in der Community Edition 29 € (Shopware zu KI-Funktionen, Preisseite).
Für Händler ohne Entwickler sind die generischen Entity-Tools sperrig, weil das Modell erst das Schema abfragen und dann Kriterien im Format der Admin API bauen muss. Shopware liefert deshalb das experimentelle Paket swag/mcp-merchant-tools mit fertigen Workflows wie merchant-order-summary und merchant-revenue-report, das aber zugunsten des Copilot wieder entfallen kann (Shopware Extensions).
Unser Plugin AI Connect (MCP Connector für Shopware) setzt auf dem nativen Server auf und ergänzt, was im Betrieb fehlt: Fertige Konfigurationen für Claude Desktop, Claude Code und OpenAI Codex entstehen in der Administration, jede Verbindung nutzt eine Shopware-ACL-Rolle, jede Änderung erscheint vor der Ausführung als Vorschau, und das Audit-Log macht Aktivitäten nach Tool, Modus, Ergebnis und Konto nachvollziehbar. Dazu kommt eine Suche in natürlicher Sprache für Mitarbeiter und Kunden, mit eigenem API-Schlüssel bei OpenAI oder Anthropic.
Abbildung: Die Grafik zeigt, an welchen Stellen ein Tool-Aufruf gestoppt oder nachvollzogen wird; wer Rolle und Allowlist eng fasst und Freigaben nicht pauschal erteilt, begrenzt die Fehler des Modells. Quelle: developer.shopware.com (MCP Server, Tools Reference, Configuration), solution25.com/mcp-connector; Stand Oktober 2026
Alles, was die Admin API kann, lässt sich über MCP in natürlicher Sprache anstoßen, immer im Rahmen der Rechte der Integration. Diese Anwendungsfälle haben sich in Projekten bewährt:
Je konkreter der Prompt Entität, Zeitraum und gewünschte Ausgabe nennt, desto weniger Rückfragen entstehen. Eine Sammlung geprüfter Prompts je Team zahlt sich schnell aus.
MCP ist nicht der einzige Weg, Shopware mit KI oder anderen Systemen zu verbinden. Die Tabelle ordnet die fünf gängigen Wege ein.
| Weg | Geeignet für | Stärken | Grenzen |
|---|---|---|---|
| MCP Server (nativ in Shopware) | Interaktive Arbeit im Chat, Auswertungen, Pflege mit Freigabe | Im Kern enthalten, ACL, Dry-Run, alle MCP-Clients | Experimentell bis 6.8, Rate Limits, fachliche Tools nur per Erweiterung |
| n8n | Wiederkehrende Prozesse ohne Mensch, Drittsysteme | Fertige Shopware-Nodes, AI-Agent mit MCP Client Tool, Self-Hosting | Freigaben und Fehlerbehandlung bauen Sie im Workflow |
| Admin API direkt | Eigene Software, Massenimporte, ERP-Schnittstellen | Volle Kontrolle, Sync API, keine Token-Kosten | Entwicklung nötig, kein Dialog in natürlicher Sprache |
| Shopware Nexus | Ereignisgesteuerte Workflows zwischen Shopware, ERP und CRM | Von Shopware betrieben, Trigger auf Entitäts-Events, Kontingent im Plan | Beta, kein KI- oder MCP-Node, kein Self-Hosting |
| Shopware Copilot | Start ohne Konfiguration in der Administration | Keine Einrichtung, Freigabe eingebaut, Daten laut Shopware in Europa | Nur in der Administration, agentische Funktionen über Intelligence+ |
Unsere n8n Nodes für Shopware decken Produkte, Kunden und Bestellungen ab, typische Workflows zeigt der Beitrag zur Automatisierung von Shopware 6 mit n8n. Da das MCP Client Tool von n8n seit Node-Version 1.2 standardmäßig HTTP Streamable spricht (Quellcode des Nodes), kann ein AI-Agent in n8n den Shopware MCP Server direkt ansprechen.
Shopware Nexus bindet laut Dokumentation in der Beta unter anderem Microsoft Dynamics Business Central, Slack und S3 an, einen MCP- oder KI-Node gibt es dort nicht. Wie die Admin API direkt funktioniert, erklären wir auf unserer Seite zur Shopware Admin API, einen Überblick über KI-Anbindungen gibt die KI-Integrationsplattform für Shopware.
claude mcp add --transport http shopware https://ihr-shop.de/api/_mcp --header "sw-access-key: …" --header "sw-secret-access-key: …". In Claude Desktop und Cursor tragen Sie denselben Endpunkt mit dem Typ streamable-http und den beiden Headern in die Konfigurationsdatei ein (Getting Started von Shopware). In n8n verbinden Sie den AI Agent über das MCP Client Tool mit Header-Authentifizierung.Ein typischer Aufbau aus unseren Beratungen, als Szenario mit Erfahrungswerten: Ein Händler mit rund 4.000 Artikeln will Claude für Auswertungen, Kundenservice und Katalogpflege nutzen. Statt eines Admin-Zugangs richten wir drei Integrationen ein.
| Integration | Wer sie nutzt | Allowlist (Kurznamen der Tools) | Rechte der Rolle |
|---|---|---|---|
| Auswertung | Geschäftsführung in Claude Desktop | schema, search, read, aggregate | Bestellung und Produkt lesen |
| Service | Team im Kundenservice | schema, search, read, order-state | Bestellung und Kunde lesen, Lieferstatus ändern |
| Katalog | Shop-Manager | schema, search, read, upsert, media-upload | Produkt lesen und ändern, Medien anlegen, keine Löschrechte |
Den Medien-Upload, der ohne Vorschau speichert, bekommt nur der Katalog, Kundendaten sieht nur der Service. Die Einrichtung dieser drei Zugänge mit Schulung liegt nach unserer Erfahrung im unteren Bereich der genannten 1.500 bis 5.000 €.
Dasselbe Prinzip setzen wir außerhalb von KI-Projekten um: Für einen deutschen Logistikkunden haben wir ein Lagerportal mit rollenbasiertem Bestellmanagement und Anbindung an SAP, HubSpot und Shopware gebaut. Dort sorgen rollenbasierte Berechtigungen dafür, dass sensible Informationen nur autorisiertem Personal zugänglich sind, und Audit-Logs machen Vorgänge nachvollziehbar.
Als Werkzeuge dienen das Audit-Log einer Erweiterung wie AI Connect oder ein eigenes Logging, die Kostenübersicht Ihres KI-Anbieters und in n8n die Liste der Ausführungen. Diese Richtwerte haben sich bei uns bewährt:
Prüfen Sie die Werte in den ersten vier Wochen wöchentlich, danach monatlich und nach jedem Shopware-Update. Nachsteuern sollten Sie, sobald die Freigabequote sinkt, eine Stichprobe abweicht oder ein bewährter Prompt nach einem Update kein passendes Tool mehr findet.
Kosten entstehen beim KI-Client, bei Zusatzfunktionen von Shopware und bei der Einrichtung.
| Kostenblock | Betrag | Quelle |
|---|---|---|
| MCP Server in Shopware | 0 €, ab 6.7.14 im Kern enthalten | Shopware-Dokumentation |
| Claude für Einzelnutzer | Pro 20 US-Dollar im Monat (17 bei Jahreszahlung), Max ab 100, Team ab 20 je Nutzer | claude.com/pricing |
| ChatGPT für Einzelnutzer | Plus 20 US-Dollar im Monat, Developer Mode ab Plus | openai.com |
| API-Nutzung, etwa aus n8n | Claude Sonnet 5.5: 2 US-Dollar je Million Eingabe-Tokens, 10 US-Dollar je Million Ausgabe-Tokens; OpenAI berechnet bei entfernten MCP Servern nur Tokens | Anthropic, OpenAI |
| n8n Cloud | Starter 20 € im Monat bei Jahreszahlung, Pro 50 €; Community Edition selbst gehostet ohne Lizenzkosten | n8n.io/pricing |
| Shopware Intelligence+ | 19 € im Monat, Community Edition 29 €, für agentische Copilot-Funktionen | shopware.com/de/preise |
| Einrichtung durch eine Agentur | 1.500 bis 5.000 € für Rollen, Allowlists, Client-Konfiguration, Audit-Log und Schulung | Erfahrungswert solution25 |
| Individuelle Tools | 5.000 bis 20.000 € je nach Zahl und Komplexität der Prozesse | Erfahrungswert solution25 |
Die Einrichtungskosten hängen vor allem davon ab, wie viele Rollen und Clients Sie brauchen. Was Shopware-Agenturen grundsätzlich berechnen, steht im Beitrag zu den Shopware Agentur Preisen, die Gesamtkosten eines Shops behandelt unser Artikel zu den Shopware Kosten.
Individuelle Tools lohnen sich, wenn ein Prozess täglich läuft: Ein Tool „Retoure anlegen“, das Bestellung, Rückerstattung und Lagerbuchung in einem Schritt mit einer Freigabe abwickelt, spart mehr Zeit als zehn generische Entity-Aufrufe. Solche Tools entstehen als Plugin oder App (Shopware Plugin Entwicklung).
Unsere Einschätzung: Für die meisten Shopware-Händler ist der native MCP Server mit einer lesenden Integration der richtige Einstieg, weil Rollen, Allowlist und Dry-Run schon eingebaut sind und keine Lizenz anfällt. Schreibrechte vergeben wir erst nach einem Testbetrieb auf Staging, und Shops auf 6.6 raten wir zum Update statt zu einem separaten MCP Server, der mit 6.7 überflüssig wird.
Ein MCP Server ist ein Programm, das einer KI-Anwendung über das Model Context Protocol Werkzeuge, Daten und Vorlagen anbietet und die Aufrufe ausführt, die der Client nach Freigabe sendet. Bei Shopware ist der MCP Server ein Teil des Shops und unter /api/_mcp erreichbar.
MCP ist ein offener Standard, der KI-Anwendungen mit Werkzeugen und Daten verbindet. Eine Host-Anwendung wie Claude oder ChatGPT fragt die Tools eines Servers ab und stellt sie dem Sprachmodell vor. Wählt das Modell ein Tool, führt der Host den Aufruf nach Ihrer Freigabe aus und gibt das Ergebnis an das Modell zurück.
Das MCP-Projekt pflegt Referenzserver wie Filesystem, Git, Fetch, Memory und Time (GitHub) sowie ein öffentliches Verzeichnis. Im E-Commerce sind neben dem nativen Shopware-Server der Instanz-Server von n8n und der MCP-Endpunkt je Shopify-Shop relevant (Shopify).
Offizielle SDKs gibt es unter anderem für TypeScript, Python, PHP, Java und Go (SDK-Übersicht). Sie definieren Tools mit Name, Beschreibung und Eingabeschema und wählen stdio oder Streamable HTTP als Transport. In Shopware ergänzen Sie den vorhandenen Server: Plugins registrieren Tools als Symfony-Service, Apps deklarieren sie in der Datei Resources/mcp.xml, jeweils mit ACL-Rechten und einem dryRun-Parameter für die Freigabe.
So sicher wie ihre Rechte und ihre Konfiguration. Die Spezifikation beschreibt Angriffe wie Token-Weitergabe, Prompt Injection über Tool-Ergebnisse und manipulierte lokale Server, und sie verlangt Freigaben durch den Nutzer. In Shopware kommen ACL-Rollen, Allowlists je Integration, Dry-Run vor jeder Änderung und Rate Limits hinzu.
Das Protokoll ist frei, der Shopware MCP Server ab Version 6.7.14 im Kern enthalten. Laufende Kosten entstehen beim Client, etwa 20 US-Dollar im Monat für Claude Pro oder ChatGPT Plus, die Einrichtung mit Rollen, Allowlists und Audit-Log liegt nach unserer Erfahrung bei 1.500 bis 5.000 €.
Ja, über den Developer Mode in Plus, Pro, Business, Enterprise und Edu. Weil ChatGPT sich nur per OAuth oder ohne Anmeldung verbindet, braucht es einen Gateway vor dem Shop, der OAuth übernimmt, und der Shop muss öffentlich per HTTPS erreichbar sein.
Sie möchten wissen, welche Aufgaben in Ihrem Shop sich über einen MCP Server erledigen lassen und welche Rechte dafür nötig sind? Schreiben Sie uns, wir prüfen Ihre Shopware-Version, schlagen Rollen und Allowlists vor und richten AI Connect mit Freigaben und Audit-Log ein. Am Ende hat jedes Team einen eigenen Zugang, der nur sieht und ändert, was seine Aufgabe braucht.
Sie betreiben bereits einen Shop und wollen zuerst wissen, wo er heute steht? Unsere kostenlose Shop-Analyse zeigt Ihnen in zwei Werktagen als PDF, wo Ihr Shop Umsatz verliert, von Ladezeit und SEO bis zur Sichtbarkeit in KI-Assistenten.
Besnik Bilalli ist Gründer und CEO von solution25, der Shopware Agentur aus Bremen. Vor der Agenturgründung 2017 hat er selbst einen Online-Shop aufgebaut und auf mehr als 500 Bestellungen am Tag gebracht. Seitdem begleitet er Händler bei Shopware-Projekten, von der ersten Kalkulation bis zum laufenden Betrieb. Fragen zum Artikel beantwortet er gern persönlich: Kontakt aufnehmen.
Verantwortlich für Inhalt und Aktualisierung: Besnik Bilalli. Stand: Oktober 2026. Nächste inhaltliche Prüfung: Januar 2027.
