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

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 Gemini 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.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Mirakl Connect-Tools aufrufen.

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 sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden