Shopware 6 Admin API über MCP mit Meta Muse verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Shopware 6 Admin API klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Shopware 6 Admin API + Meta Muse

Shopware 6 Admin API, die Backoffice-API des Shops (nicht die Store API): jede Entität durchsuchen, Produkte, Kategorien, Erlebniswelten bis zum einzelnen Slot und Medien pflegen, Verkaufskanäle, Promotions und SEO-URLs lesen. Generisches Schreiben, Löschen und Bulk-Sync sind bei der Installation aus.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

SHOPWARE_URL, SHOPWARE_ACCESS_KEY_ID, SHOPWARE_SECRET_ACCESS_KEY

Schritt 1 — Zugangsdaten holen

Admin API, nicht die Store API: Dieser Connector nutzt die Admin API (/api) eines Shopware-6-Shops, also die API, mit der die Shopware Administration selbst den Shop verwaltet: Produkte, Kategorien, Erlebniswelten-Layouts (Shopping Experiences) und die Medienverwaltung. Er ist ein anderer Connector als Shopware 6 Store API (shopware-6), der die öffentliche Storefront mit dem Zugangsschlüssel eines Verkaufskanals liest. Installiere diesen hier, wenn die KI an den Verwaltungsdaten des Shops arbeiten soll.

Die Einrichtung dauert etwa 3 Minuten. Du brauchst Zugang zur Shopware Administration des Shops.

1. Öffne in der Shopware Administration Einstellungen > System > Integrationen (Settings > System > Integrations) und lege eine neue Integration an.
2. Gib ihr einen Namen und schalte entweder Administrator ein oder weise eine Rolle mit den Rechten zu, die die KI haben soll. Mit einer Rolle, die nur lesen darf, scheitert jedes schreibende Tool mit 403.
3. Kopiere die Access key ID (sie beginnt mit SWIA) in SHOPWARE_ACCESS_KEY_ID und den Secret access key in SHOPWARE_SECRET_ACCESS_KEY. Der Secret wird nur einmal angezeigt; ist er verloren, erzeuge in der Integration einen neuen Schlüssel.
4. Setz SHOPWARE_URL auf die Adresse des Shops ohne Pfad, z. B. https://shop.example.com. Häng weder /api noch /admin an.
5. Installiere den Connector und rufe shopware_6_admin_get_version auf: Es zeigt die Shopware-Version und bestätigt die Zugangsdaten.

AnythingMCP holt am /api/oauth/token des Shops mit dem OAuth2-Client-Credentials-Grant ein kurzlebiges Bearer-Token und erneuert es selbstständig.

Was er liest: Produkte mit Freitextsuche und Filtern (Produktnummer, aktiv, Lagerbestand, Hersteller, Kategorien, Eigenschaften, Varianten über parentId) und ein einzelnes Produkt mit seinen eigenen Feldern (Name, Nummer, Bestand, Preis, Beschreibung, SEO-Felder, Zusatzfelder); Kategorien mit Elternkategorie, Position, Typ, Layout, Aktiv- und Sichtbarkeits-Flag und Breadcrumb; Erlebniswelten-Layouts (CMS-Seiten) und ein Layout mit seinen Sektionen, Blöcken und Slots samt der Config jedes Slots; die Medienverwaltung mit URL, Dateiname, Alt-Text, Titel und Ordner; Verkaufskanäle mit ihren Domains (der Store-API-Zugangsschlüssel wird aus der Antwort entfernt); Promotions mit Codes, Gültigkeit und Einlöselimits; SEO-URLs. Jede andere Entität der Admin API, etwa Bestellungen, Kunden, Hersteller, Eigenschaftsgruppen und -ausprägungen, Regeln, Sprachen, Währungen oder Textbausteine, liest er mit shopware_6_admin_search_entities und shopware_6_admin_get_entity.

Suchkriterien: Jedes Such-Tool nimmt die Criteria von Shopware: term, ids, filter (equals, equalsAny, contains, prefix, suffix, range, not, multi), sort, associations, includes, limit, page und total_count_mode; Produkte und die generische Suche nehmen zusätzlich aggregations. Verknüpfte Felder werden über Punktpfade gefiltert, etwa categories.id oder manufacturer.name. Die KI übergibt includes, wenn sie keine vollständigen Datensätze braucht, denn ein vollständiges Produkt ist groß. IDs sind 32 Hex-Zeichen ohne Bindestriche; die KI findet sie mit den Such-Tools und rät sie nie.

Sprachen und Varianten: Texte sind pro Sprache übersetzt. Mit language_id (als Header sw-language-id gesendet) liefert ein Lesezugriff diese Übersetzung und ein Schreibzugriff ändert diese Übersetzung; ohne sie gilt die Systemsprache des Shops. Sprachen listet shopware_6_admin_search_entities mit der Entität language. Neue Datensätze werden zuerst in der Systemsprache angelegt. Varianten sind Produkte mit parentId und erben leere Felder vom Hauptprodukt; inheritance: true zeigt die geerbten Werte.

Was er schreibt: shopware_6_admin_update_product (Texte, SEO-Felder, Zusatzfelder, Aktiv-Flag, Bestand, Abverkauf, EAN, Preis; ein Preis ersetzt die ganze Preisliste), shopware_6_admin_add_product_property und shopware_6_admin_remove_product_property (verknüpfen oder lösen nur eine Ausprägung), shopware_6_admin_create_property_option, shopware_6_admin_create_category und shopware_6_admin_update_category (auch das Verschieben im Kategoriebaum), shopware_6_admin_create_cms_page, shopware_6_admin_update_cms_page (Sektionen, Blöcke und Slots mit ID werden aktualisiert, solche ohne ID hinzugefügt, nichts wird entfernt), shopware_6_admin_create_cms_block, shopware_6_admin_update_cms_slot (die Config ersetzt die Config des Slots für diese Sprache), shopware_6_admin_create_media gefolgt von shopware_6_admin_upload_media_from_url, shopware_6_admin_update_media und shopware_6_admin_create_media_folder. Diese Tools sind bei der Installation aktiv und ändern den Live-Shop: Kunden sehen die Änderung, sobald der Cache des Shops erneuert ist. Der Upload per URL braucht Shopwares enable_url_upload_feature (standardmäßig an) und eine öffentliche URL und ersetzt eine Datei, die der Medieneintrag schon hat.

Bei der Installation deaktiviert: shopware_6_admin_create_entity, shopware_6_admin_update_entity (jede Entität, auch Bestellungen, Kunden, Verkaufskanäle und Einstellungen), shopware_6_admin_delete_entity (endgültig, abhängige Datensätze können mitgelöscht werden) und shopware_6_admin_sync (Bulk-Upsert und -Löschen über die Sync API). Ein Workspace-Admin schaltet sie bewusst ein.

Antworten: Updates, Uploads und Löschungen antworten mit einem leeren 204, deshalb liest die KI den Datensatz zur Bestätigung erneut. Die Create-Tools liefern den neuen Datensatz mit seiner ID. Listen liefern total, data und aggregations.

Limits: Shopwares Standard-Maximum sind 500 Treffer pro Seite; die KI blättert mit page. total_count_mode 1 liefert die genaue Gesamtzahl, 2 nur, ob es eine nächste Seite gibt.

Häufige Fehler: 401 bedeutet eine falsche Access key ID oder einen falschen Secret: Kopiere beide erneut oder erzeuge in der Integration einen neuen Schlüssel. 403 heißt, die Rolle der Integration darf das nicht: Schalte Administrator ein oder erweitere die Rolle. 404 bei jedem Aufruf heißt meist, dass SHOPWARE_URL /api, /admin oder einen anderen Pfad enthält.

Mit den Tools, die bei der Installation aktiv sind, legt der Connector keine Bestellungen, Kunden oder Einstellungen an, ändert sie nicht und löscht nichts. Medien lädt er nur von einer öffentlichen URL hoch, nicht von deinem Rechner. Um die öffentliche Storefront mit dem Zugangsschlüssel eines Verkaufskanals zu lesen, nimm den Connector Shopware 6 Store API.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Muse hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.

1. Öffne in Muse Settings → Connectors und wähle Add custom connector.
2. Füge die MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein.
3. Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
4. Bitte Muse im Chat um etwas, wofür es die Shopware 6 Admin API-Tools braucht.

Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Finde alle aktiven Produkte mit weniger als 5 Stück Bestand und zeig Produktnummer, Name und Bestand.“
• „Schreib Meta-Titel und Meta-Beschreibung von Produkt SW10001 auf Deutsch und Englisch neu. Zeig mir die Texte vor dem Speichern.“
• „Zeig das Erlebniswelten-Layout unserer Sommer-Landingpage mit seinen Sektionen, Blöcken und Slots.“
• „Lade das Bild unter https://example.com/banner.jpg in den Medienordner Banner hoch und setz seinen Alt-Text.“
• „Welche Promotions sind gerade aktiv, mit ihren Codes und Gültigkeitsdaten?“

FAQ

Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.

Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Microsoft Copilot verbinden