Mirakl Connect über MCP mit Microsoft Copilot verbinden

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

Mirakl Connect + Microsoft Copilot

Mirakl Connect für Händler: Bestellungen aller verbundenen Marktplätze und Kanäle an einem Ort, Retouren, Bestelldokumente, Kundenkonversationen und der Connect-Katalog mit Preisen und Bestand. Nicht die Mirakl Seller API eines einzelnen Marktplatzes. Versand, Storno und Annahme 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:

MIRAKL_CONNECT_CLIENT_ID, MIRAKL_CONNECT_CLIENT_SECRET

Schritt 1 — Zugangsdaten holen

Nicht die Mirakl Seller API: Der separate Connector Mirakl Seller API (mirakl) spricht jeweils mit einem Marktplatz, der auf Mirakl läuft, über dessen eigene https://<marketplace>.mirakl.net/api mit einem Shop-API-Key. Mirakl Connect ist die händlerseitige Kanalplattform darüber: ein Login und eine API (https://miraklconnect.com/api) für alle Marktplätze und Vertriebskanäle, die dein Unternehmen betreibt, mit eigenen Bestell-IDs, OAuth2-Zugangsdaten und Endpunkten. Installiere diesen hier, wenn dein Unternehmen in Mirakl Connect arbeitet.

Die Einrichtung dauert etwa 5 Minuten.

1. Leg in Mirakl Connect OAuth2-API-Zugangsdaten für dein Unternehmen an, wie in Mirakls Anleitung Integrating with Connect APIs (Mirakl-Connect-Hilfe für Händler) beschrieben. Du erhältst eine Client ID und ein Client Secret; das Secret wird nur einmal angezeigt.
2. Trag sie in MIRAKL_CONNECT_CLIENT_ID und MIRAKL_CONNECT_CLIENT_SECRET ein. AnythingMCP tauscht sie beim Mirakl Authentication System (https://auth.mirakl.net/oauth/token, Client-Credentials-Grant) gegen ein Bearer-Token mit etwa einer Stunde Laufzeit und erneuert es selbst.
3. Installiere den Connector und rufe mirakl_connect_list_orders auf: Es listet deine neuesten Bestellungen und bestätigt die Zugangsdaten.

Bestell-IDs und Kanäle: Jede Bestellung hat eine Connect-Bestell-ID (id), die mirakl_connect_get_order und die schreibenden Tools erwarten, und die eigene Bestellnummer des Kanals in channel_order_id. Vertriebskanal und Store stehen in origin (channel_name, channel_store_name). Die Mirakl Connect API hat keinen Endpunkt, der deine verbundenen Kanäle auflistet; die KI liest sie aus dem origin der Bestellungen.

Was er liest: Bestellungen aller verbundenen Kanäle, zuletzt aktualisierte zuerst, mit Status, Herkunft, Bestellpositionen (Produkt, Menge, Preis, Steuern, Positionsstatus), Versand- und Rechnungsdaten und Fulfillment-Typ (FULFILLED_BY_SELLER oder FULFILLED_BY_PARTNER); ohne updated_from oder IDs liefert Mirakl die letzten 30 Tage. Den Connect-Produktkatalog mit Titeln, Marke, Kategorie, GTINs, Bildern, Standard- und Rabattpreisen, Bestandsmengen und Attributen. Retouren über alle Kanäle mit Status (REQUEST_INITIATED, REQUEST_DECLINED, OPENED, RECEIVED, CLOSED), Retourenpositionen, Methode, RMA-ID, Label-URL, Sendungsverfolgung und Ablehnungsgrund. Bestelldokumente wie Kundenrechnungen, Lieferscheine und Retourenlabels. Kundenkonversationen zu Bestellungen und die Nachrichten einer Konversation mit Autor, Text und Anhängen. Das Ergebnis einer asynchronen Bestellaktion.

Filter: Bestellungen lassen sich nach statuses, updated_from, fulfillment_type und Bestell-IDs filtern. Retouren brauchen updated_from. Dokumente brauchen Bestell-IDs oder updated_from, Konversationen updated_from oder Konversations-IDs.

Bei der Installation deaktiviert: mirakl_connect_ship_order (markiert Positionen als versendet und gibt Spediteur und Sendungsnummer an den Kanal weiter, der den Kunden meist benachrichtigt), mirakl_connect_cancel_order_lines (der Kunde wird auf dem Kanal erstattet und benachrichtigt; nicht rückgängig zu machen) und mirakl_connect_accept_order_lines (nimmt Positionen in AWAITING_ACCEPTANCE an oder lehnt sie ab; Ablehnen storniert die Position und ist nicht rückgängig zu machen). Sie wirken auf den Live-Vertriebskanal, deshalb schaltet ein Admin sie bewusst ein. Auch dann zeigt dir die KI die Bestellung, die Positionen und die Werte und wartet auf dein Ja; die Positions-IDs nimmt sie aus order_lines[].id der Bestellung. Diese Aufrufe sind asynchron: Sie liefern eine action_id, und die KI prüft das Ergebnis mit mirakl_connect_get_action_status, weil der Kanal die Aktion noch ablehnen kann.

Blättern und Limits: Jede Liste antwortet mit next_page_token, solange es weitere Einträge gibt, und die KI übergibt es als page_token. Bestellungen und Retouren kommen standardmäßig zu 10 pro Seite (bis 100), Dokumente und Konversationen zu 50 (bis 100); Produkte gehen bis 1000 pro Seite, und die KI nimmt eine kleine Seitengröße, wenn sie nicht den ganzen Katalog braucht. Mirakl bittet, die Bestell-, Retouren- und Produktlisten beim Synchronisieren höchstens einmal pro Minute abzurufen. Datumsangaben sind ISO 8601 mit Zeitzone.

Häufige Fehler: 401 bedeutet eine falsche Client ID oder ein falsches Secret oder ein abgelaufenes Token. 403 heißt, dem API-Client fehlt der Scope für diesen Aufruf, z. B. connect:order:read oder connect:shipment:create. 402 heißt, die Funktion, z. B. Konversationen, ist nicht Teil des Mirakl-Connect-Tarifs des Kontos. 404 bedeutet eine unbekannte Bestell- oder Konversations-ID. 429 heißt zu viele Aufrufe: Warte auf Retry-After.

Der Connector ändert keine Preise oder Bestände, antwortet nicht auf Konversationen, legt keine Retouren an und verbindet keine neuen Kanäle. Für einen einzelnen Mirakl-Marktplatz ohne Mirakl Connect nimm den Connector Mirakl Seller 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 Mirakl Connect-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

• „Welche Bestellungen sind seit gestern über alle unsere Kanäle eingegangen, gruppiert nach Kanal?“
• „Finde die Bestellung mit der Kanal-Bestellnummer 405-1234567-1234567 und zeig ihre Positionen und deren Status.“
• „Liste die diese Woche eröffneten Retouren mit Kanal, Grund und Sendungsverfolgung.“
• „Zeig die heute aktualisierten Kundenkonversationen und fasse zusammen, was jeder Kunde möchte.“
• „Versende Position 1 dieser Bestellung mit der DHL-Sendungsnummer 00340434161234567890. Zeig mir vorher Bestellung und Positionen.“

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