Mirakl Connect über MCP mit Meta Muse 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 + Meta Muse

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 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 Mirakl Connect-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

• „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

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