Shopware 6 per Model Context Protocol an Claude, ChatGPT und Cursor anbinden. Installation des offiziellen Servers, Sicherheits-Leitplanken und die Workflows, für die Merchants tatsächlich zahlen.
Das Model Context Protocol (MCP) ist ein offener Standard, mit dem KI-Assistenten wie Claude, ChatGPT und Cursor über eine einheitliche Schnittstelle mit Ihren Tools sprechen. Shopware liefert einen offiziellen MCP-Server, shopware/shopware-admin-mcp, der die Admin-API als Set von Tools bereitstellt, die jeder MCP-kompatible Client aufrufen kann. Damit kann ein Merchant seinen KI-Assistenten Dinge fragen wie „Welche Produkte haben weniger als 5 auf Lager?" oder „Entwirf deutsche Meta-Titel für Produkte in der Kategorie Outdoor", und das Modell führt die Arbeit in natürlicher Sprache am echten Shop aus, ohne dass der Merchant die Administration je öffnet.
Diese Anleitung erklärt, was MCP ist, wie Sie den offiziellen Shopware Admin MCP Server von vorne bis hinten aufsetzen, wie Sie verhindern, dass er etwas tut, was Sie später bereuen, und welche Workflows Merchants 2026 tatsächlich produktiv einsetzen: das Setup, die Stolperfallen und die Stellen, an denen ich es schon habe schiefgehen sehen.
Anthropic hat MCP Ende 2024 vorgestellt, um ein langweiliges, aber teures Problem zu lösen: Jedes Team, das ein LLM mit internen Systemen koppeln wollte, schrieb denselben Glue-Code in leicht unterschiedlicher Form. MCP standardisiert diesen Glue. Ein Server stellt Tools bereit (Funktionen, die das Modell aufrufen kann), Resources (lesende Daten, die das Modell in seinen Kontext aufnehmen kann) und Prompts (parametrisierte Startpunkte für Aufgaben). Ein Client, üblicherweise eine KI-Chat-App, erkennt das Angebot des Servers und entscheidet, wann er es nutzt.
Bis 2026 liefern Claude Desktop, ChatGPT, Cursor, Zed und die meisten produktiven KI-IDEs MCP-Support als Standardfunktion aus. Shopware war eine der ersten großen E-Commerce-Plattformen mit einem offiziellen Server, und die Community hat mehrere spezialisierte Server für Theme-Arbeit und Plugin-Debugging ergänzt.
Ein paar Dinge, die MCP nicht ist:
In der Shopware Administration zu Einstellungen → System → Integrationen wechseln und eine neue Integration anlegen. Geben Sie ihr einen Namen, den Sie später im Audit-Log wiedererkennen, zum Beispiel mcp-claude-desktop.
Aktivieren Sie nicht den „Administrator"-Schalter auf der Integration. Weisen Sie eine dedizierte ACL-Rolle nur mit den Rechten zu, die Sie wirklich brauchen. Lesezugriff ist ein guter Startpunkt. Sie können später jederzeit mehr freigeben. Der Sinn von MCP ist, Reibung zu reduzieren, nicht Sicherheits-Schranken.
Kopieren Sie Access Key ID und Secret Access Key. Das Secret wird nur einmal angezeigt. Speichern Sie es im Passwort-Manager, nicht in der MCP-Config-Datei.
Der offizielle Server ist auf npm als @shopware-ag/admin-mcp veröffentlicht. Sie installieren ihn nicht manuell. Ihr KI-Client startet ihn über npx mit drei gesetzten Umgebungsvariablen:
SHOPWARE_API_URL=https://shop.example.com
SHOPWARE_API_CLIENT_ID=SWIAxxxxxxxxxxxx
SHOPWARE_API_CLIENT_SECRET=yyyyyyyyyyyyyyDer Server spricht MCP über stdio, ein direkter Aufruf im Terminal ist für sich allein also nicht sinnvoll. Der nächste Schritt verdrahtet ihn mit einem Client, der ihn startet und ansprechen kann.
Jeder Client hat seine eigene Config-Datei, aber die Struktur ist identisch. Für Claude Desktop auf macOS editieren Sie ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"shopware-admin-mcp": {
"command": "npx",
"args": ["-y", "@shopware-ag/admin-mcp"],
"env": {
"SHOPWARE_API_URL": "https://shop.example.com",
"SHOPWARE_API_CLIENT_ID": "${SHOPWARE_API_CLIENT_ID}",
"SHOPWARE_API_CLIENT_SECRET": "${SHOPWARE_API_CLIENT_SECRET}"
}
}
}
}
Die ${VAR}-Interpolation liest aus den OS-Umgebungsvariablen, das eigentliche Secret steht damit nie in der Config-Datei. Setzen Sie die Variablen in Ihrem Shell-Profil oder, besser, in einem Secrets-Manager, der sie an den Client-Prozess exportiert.
Den KI-Client neu starten. Im Integrations-Panel sollte eine neue Tool-Gruppe namens shopware erscheinen. Wenn nicht, schauen Sie ins Log des Clients. Falscher Pfad zu npx ist die häufigste Ursache unter Windows.
Öffnen Sie einen neuen Chat und stellen Sie eine kleine, lesende Frage:
Liste die fünf zuletzt angelegten Produkte im Shop,
mit ihrem Lagerbestand und Aktiv-Status.Der Agent fragt einmal nach Erlaubnis, ein Shopware-Tool aufzurufen, Sie bestätigen, und die Antwort kommt als Tabelle zurück, basierend auf Ihren Live-Daten. Prüfen Sie das Shopware-Integrationsprotokoll unter Einstellungen → System → Integrationen → Aktivität, um zu bestätigen, dass der Aufruf unter der von Ihnen angelegten Integration lief, nicht unter einem vergessenen Admin-Account.
Ein MCP-Server ist funktional ein langlebiger API-Client mit den Rechten dessen, der ihn ausgestellt hat. Behandeln Sie ihn so, wie Sie eine ERP-Integration behandeln würden. Die folgende Liste ist die Kurzform dessen, was ich bei jeder Installation konfiguriere.
Wenn der Agent nur Produkt- und Bestelldaten lesen soll, vergeben Sie nur diese Leserechte. Legen Sie eine separate Integration mit Schreibzugriff für die Workflows an, die ihn tatsächlich brauchen. Zwei Integrationen kosten nichts. Ein überprivilegierter Key kostet alles, sobald ein Prompt Injection das Modell überredet, eine Kategorie zu löschen.
Der offizielle Server spricht stdio, läuft also als Subprozess des KI-Clients auf Ihrer Maschine. Das ist die sicherste Variante heute. HTTP-Transport-MCP-Server gibt es, und sie haben ihren Platz, aber einen davon im öffentlichen Internet zu exponieren öffnet eine Angriffsfläche, die sich für einen Einzelnutzer-Workflow eines Merchants nicht lohnt.
Produktbeschreibungen, Kundennachrichten und CMS-Inhalte sind nutzergenerierter Content. Ein Angreifer kann Anweisungen in eine Produktbeschreibung schreiben, die ein LLM beim Lesen als Befehle interpretieren könnte. Behandeln Sie jeden Inhalt, den das Modell aus dem Shop liest, als nicht vertrauenswürdig, und vergeben Sie Schreib-Tools nicht ohne menschliche Bestätigung, wenn der Kontext nutzergenerierten Content enthalten kann.
Shopware protokolliert jeden Admin-API-Aufruf unter dem Namen der Integration. Überfliegen Sie das Log einmal pro Woche. Achten Sie auf Tool-Aufrufe, die Sie überraschen, ungewöhnliche Payload-Größen und Zugriffe außerhalb der Geschäftszeiten. Sie müssen nicht jede Zeile lesen, Sie sollen ein Gefühl dafür bekommen, wie „normal" aussieht.
Das sind die Muster, die sich nach meiner Erfahrung innerhalb eines Monats amortisieren. Sie sind absichtlich unspektakulär. Der Wert liegt nicht darin, dass die KI Magie tut, sondern darin, dass der Abstand zwischen einer Frage und einer Antwort von zwanzig Minuten auf zwanzig Sekunden schrumpft.
Der Prompt: „Zeige alle aktiven Produkte mit Bestand unter 5, gruppiert nach Hauptkategorie, mit ihrem durchschnittlichen Tagesabsatz der letzten 14 Tage."
Was sich ändert: Ein Einkaufsleiter, der vorher vierzig Minuten am Tag in drei Reports verbracht hat, braucht jetzt zwei. Die Ausgabe fließt in ein Spreadsheet, das Spreadsheet in die nächste Bestellung. Kein Code, kein Plugin, kein Consultant.
Der Prompt: „Entwirf für die 60 Produkte in der Kategorie Trail Running neue Meta-Titel und Meta-Descriptions auf Englisch und Deutsch, halte Googles Limits von 60 bzw. 160 Zeichen ein und schreibe sie zurück zu den Produkten."
Was sich ändert: Der Agent liest die bestehende Copy, generiert bessere Versionen, fragt vor jedem Batch von Schreiboperationen nach Bestätigung und aktualisiert die Produkte über die Admin-API. Eine zweitägige Texter-Aufgabe schrumpft auf eine Stunde Review.
Der Prompt: „Kundin Maria Schmidt meldet, sie habe für Bestellung 10042 bezahlt, aber nichts erhalten. Hol Bestellung, Zahlung, Versand und Kundenhistorie. Sag mir, was wahrscheinlich schiefgelaufen ist."
Was sich ändert: Das Modell verknüpft Daten aus vier Endpoints, deren Schemas sich kein Merchant merkt, baut daraus eine zusammenhängende Timeline und markiert die Anomalie (Zahlung verbucht, aber kein Versanddatensatz). Support-Mitarbeiter arbeiten Fälle schneller ab, Kunden warten weniger.
Der Prompt: „Wir launchen morgen die neue Kollektion. Lauf eine Checkliste: Jedes Produkt der Kollektion hat mindestens ein Bild, einen Preis in EUR und CHF, Bestand über null, eine Meta-Description und ist beiden Sales Channels zugeordnet."
Was sich ändert: Eine Pre-Launch-Checkliste, die früher auf einer Checkliste basierte, an die sich niemand hielt, läuft in Sekunden. Der Agent liefert eine Liste der Produkte, die irgendeinen Check nicht bestehen, und das Team behebt sie vor dem Launch statt nach der ersten Kundenbeschwerde.
Der offizielle Server deckt Produkte, Kategorien, Bestellungen, Sales Channels und Medien ab. Das reicht für die meisten Merchants. Ein eigener Server lohnt sich, wenn:
Das MCP-SDK gibt es für TypeScript, Python und Go. Ein minimaler TypeScript-Server, der ein eigenes Tool get_top_customers ergänzt, sieht so aus:
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
const server = new McpServer({ name: "shop-custom", version: "0.1.0" });
server.registerTool(
"get_top_customers",
{
title: "Top-Kunden nach Lifetime-Umsatz",
description: "Liefert die Top-N-Kunden nach Gesamt-Bestellwert in einem Zeitraum.",
inputSchema: z.object({
limit: z.number().min(1).max(100).default(10),
since: z.string().describe("ISO-8601-Datum, inklusiv"),
}),
},
async ({ limit, since }) => {
const rows = await fetchTopCustomers(limit, since); // Ihr Admin-API-Call
return { content: [{ type: "text", text: JSON.stringify(rows, null, 2) }] };
}
);
async function main() {
await server.connect(new StdioServerTransport());
}
main();
Zwei Dutzend Zeilen, und Sie haben ein Tool, das der Agent aufrufen kann. Registrieren Sie das Binary im selben mcpServers-Config und es erscheint neben dem offiziellen Server. Die meiste Arbeit steckt, wie immer, in den langweiligen Teilen: Pagination, Error-Mapping und Input-Schemas zu schreiben, die das Modell versteht, ohne erst jede falsche Kombination durchzuprobieren.
Wer Ihnen sagt, MCP plus Shopware sei 2026 gleichbedeutend mit autonomem Commerce, verkauft Ihnen etwas. Die ehrlichen Grenzen, die mir in echten Projekten begegnen:
MCP ist die langweilig-spannendste Sache, die dem E-Commerce-Tooling seit Jahren passiert ist. Es ersetzt Ihr Team nicht. Es entfernt die Naht zwischen einer Frage an Ihren Shop und einer Antwort, die wirklich in Ihrem Shop verankert ist. Installieren Sie den offiziellen Server, schneiden Sie die ACL eng zu und starten Sie mit den täglichen Fragen, die Ihr Operations-Team ohnehin stellt. Der Rest ergibt sich.
Geschrieben von Huzaifa Mustafa
Weitere Themen zur Shopware-Entwicklung:
Ich helfe Merchants, MCP zu installieren, Integrationen nach dem Least-Privilege-Prinzip zuzuschneiden und genau die Tools zu bauen, die ihr Team wirklich braucht.
Beratung anfragen