Shopware 6 Admin API über MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Shopware 6 Admin API-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, 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

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden