Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Mirakl Connect mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Zusammenfassung
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.
Frag einfach
Beispiel-Prompts für Mirakl Connect
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 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
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.
Einrichtung
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.
- 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.
- Trag sie in
MIRAKL_CONNECT_CLIENT_IDundMIRAKL_CONNECT_CLIENT_SECRETein. 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. - Installiere den Connector und rufe
mirakl_connect_list_ordersauf: 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.
Voraussetzungen: MIRAKL_CONNECT_CLIENT_ID, MIRAKL_CONNECT_CLIENT_SECRET
Connector lokal 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
Öffne http://localhost:3000/connectors/store, wähle Mirakl Connect und trage die unter Voraussetzungen aufgelisteten Variablen ein.
Verfügbare Tools
| Tool | What it does |
|---|---|
mirakl_connect_list_orders | List orders from every sales channel connected to Mirakl Connect, most recently updated first: Connect order id, channel order id, status… |
mirakl_connect_get_order | Get one order by its Mirakl Connect order id (the id field of mirakl_connect_list_orders, not the channel's order number): status, channel… |
mirakl_connect_list_products | List the products of your Mirakl Connect catalog, sorted by product id: id, titles, brand, category, GTINs, images, standard and discount… |
mirakl_connect_list_returns | List returns updated since a time, across channels: return id, channel return id, order id, channel (origin), status (REQUEST_INITIATED… |
mirakl_connect_list_order_documents | List the documents of orders (customer invoices, delivery slips, return labels, channel-specific documents) with order id, name, type, size… |
mirakl_connect_list_conversations | List customer conversations about orders, most recently updated first: id, linked order (entity), channel (origin), topic, participants… |
mirakl_connect_get_conversation | Read the messages of one conversation, newest first, with their author, text, attachments and dates |
mirakl_connect_get_action_status | Check the result of an asynchronous order action (shipment, cancellation, acceptance): status and any errors from the sales channel |
mirakl_connect_ship_order | Ship items of one order in one package with the same tracking: Mirakl Connect marks the lines shipped and passes carrier and tracking to… |
mirakl_connect_cancel_order_lines | Cancel all or part of order lines: Connect cancels them on the sales channel and the customer is refunded and notified there |
mirakl_connect_accept_order_lines | Accept or refuse order lines in AWAITING_ACCEPTANCE; Connect passes the decision to the sales channel |
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.“
Nächste Schritte
War dieser Guide hilfreich?