Mirakl über MCP mit Gemini verbinden

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

Mirakl + Gemini

Führe deinen Shop auf jedem Marktplatz, der auf Mirakl läuft (Leroy Merlin, Conforama, BUT, home24, Maisons du Monde, Vente-unique, ePrice, Decathlon, Carrefour und viele mehr), mit einem KI-Agenten: Bestellungen, Annahme, Tracking und Versand, Reklamationen, Angebote mit Preisen und Bestand, Angebots- und Produktimporte, Nachrichten mit Kunden und Betreiber, Retouren, Bestelldokumente, Rechnungen und Transaktionen. Eine Installation pro Marktplatz.

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_URL, MIRAKL_API_KEY

Schritt 1 — Zugangsdaten holen

1. Melde dich im Seller-Backoffice des Marktplatzes an (dem Mirakl-Portal, das dir der Betreiber gegeben hat). Jeder Betreiber hat seine eigene Mirakl-Instanz, deshalb installierst du den Connector einmal pro Marktplatz (zum Beispiel Leroy Merlin und Conforama) und benennst jede Installation nach ihrem Marktplatz.
2. Kopiere die Adresse des Portals ohne Pfad in MIRAKL_URL (die Adressen bekannter Marktplätze stehen unten). Hänge kein /api an: Das ergänzt der Connector selbst.
3. Klicke oben rechts auf deinen Benutzernamen, öffne My user settings und den Tab API Key, erzeuge einen Schlüssel (oder kopiere den vorhandenen) und füge ihn ohne Bearer in MIRAKL_API_KEY ein. Ein neuer Schlüssel macht den alten ungültig: Jedes andere Tool, das ihn noch nutzt, funktioniert danach nicht mehr.
4. Nur wenn dein Benutzer mehrere Shops auf diesem Marktplatz verwaltet (häufig bei home24 und Vente-unique): Setze MIRAKL_SHOP_ID auf die numerische ID des gewünschten Shops. Lass das Feld leer, um deinen Standard-Shop zu nutzen.
5. Installiere den Connector und führe mirakl_get_account aus. Das zeigt den Shop, zu dem der Schlüssel gehört.

Marktplätze, die auf Mirakl laufen: Der Connector ist überall derselbe, nur Adresse und Schlüssel ändern sich.

• Leroy Merlin (ADEO): https://adeo-marketplace.mirakl.net
• Conforama: https://conforama-prod.mirakl.net
• BUT: https://but-prod.mirakl.net
• home24: https://home24.mirakl.net
• Maisons du Monde: https://maisonsdumonde-prod.mirakl.net
• Vente-unique: https://venteunique-prod.mirakl.net
• ePrice: https://marketplace.eprice.it

Andere Betreiber funktionieren genauso, auch solche mit eigener Domain: Nimm die Adresse des Seller-Backoffice, bei dem du dich anmeldest.

Bestellungen und Reklamationen: Die KI listet die Bestellungen, die auf Annahme warten, nimmt jede Position an oder lehnt sie ab, hinterlegt Versanddienstleister und Sendungsnummer und bestätigt den Versand. Sie findet auch Bestellungen mit offener Reklamation und schließt die Reklamation auf der betroffenen Position mit mirakl_resolve_incident, sobald das Problem des Kunden gelöst ist. Die Dokumente einer Bestellung (Lieferscheine, Versandetiketten, Kundenrechnungen) listet sie mit Name, Typ und Upload-Datum; die Datei selbst öffnest du im Backoffice.

Retouren: Die KI listet Retourenanfragen mit Grund, RMA, Sendungsverfolgung und zugehöriger Bestellung. Auf Marktplätzen, die Mirakl-Retouren nutzen und die Entscheidung dem Shop überlassen, kann sie eine Anfrage annehmen oder ablehnen und bestätigen, dass die Ware in deinem Lager angekommen ist. Erstattungen bleiben im Backoffice.

Erst bestätigen: Bestellannahme, Tracking, Versand, das Schließen von Reklamationen, Retourenentscheidungen, Angebotsänderungen, Nachrichten und Produktimporte wirken direkt auf dem Live-Marktplatz. Die KI zeigt dir, was sich ändert (Bestellpositionen, Sendungsnummer, alter und neuer Preis oder Bestand, Nachrichtentext), und wartet auf dein Ja. Eine abgelehnte Bestellposition ist endgültig storniert, und eine gesendete Nachricht lässt sich nicht zurückholen.

Preise und Bestand: mirakl_update_offers ersetzt das ganze Angebot, und jedes weggelassene Feld wird zurückgesetzt (eine fehlende Menge wird 0). Deshalb liest die KI das Angebot zuerst und schickt es vollständig zurück, nur mit deiner Änderung. mirakl_import_offers ist bei der Installation deaktiviert, weil sein REPLACE-Modus jedes Angebot löscht, das nicht in der Datei steht.

Was sie liest: Bestellungen mit Kunde, Adresse und Reklamationen, deine Angebote und die Angebote anderer Shops zu denselben Produkten, Nachrichten, Retouren, Bestelldokumente, die Rechnungen des Betreibers und die Transaktionszeilen (Verkäufe, Provisionen, Erstattungen, Auszahlungen), dazu die Verkaufskanäle (Länderseiten), Versanddienstleister, Versandzonen, Versandarten und Logistikklassen des Marktplatzes. Mit Enhanced Seller Invoicing zeigt die Rechnungsliste keine neuen Dokumente, dann liest die KI stattdessen die Buchhaltungsbelege (document requests) und die Transaktionen.

Limits: Mirakl begrenzt jede API einzeln, und Betreiber können die Grenzen verschärfen. Produkt- und Angebotsimporte laufen höchstens alle 15 Minuten, der Preisvergleich mit anderen Shops erlaubt etwa 5 Aufrufe pro Minute. Eine 429-Antwort sagt, wie viele Sekunden zu warten ist.

Häufige Fehler: 401: Der Schlüssel ist falsch, wurde durch einen neueren ersetzt oder gehört zu einem anderen Marktplatz. 403: Deinem Benutzer fehlt das Recht für diese Aktion. 404: Die Bestellung, das Angebot oder die Unterhaltung existiert für diesen Shop nicht, oder MIRAKL_URL ist nicht die Adresse des Seller-Backoffice. 400: ein falscher Parameter oder eine Bestellung im falschen Status.

Der Connector erstattet nichts, storniert keine Bestellungen und bewegt kein Geld, und jede Installation arbeitet mit einem Marktplatz und einem Shop.

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-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Bestellungen warten gerade auf Annahme, und bei welchen Bestellungen ist eine Reklamation offen?“
• „Vergleiche unseren Preis für EAN 3700123456789 mit den Angeboten der anderen Shops auf diesem Marktplatz.“
• „Setze den Bestand von SKU LAMP-042 auf 25, aber zeig mir vorher das aktuelle Angebot und die neuen Werte.“
• „Entwirf eine Antwort auf die Kundennachricht zu Bestellung 20481937-A und zeig sie mir, bevor du sie sendest.“
• „Welche Retourenanfragen bei Leroy Merlin warten auf unsere Entscheidung, und welchen Grund hat jeder Kunde angegeben?“
• „Der Kunde von Bestellung 20481937-A hat Ersatz bekommen. Schließ die Reklamation auf dieser Position, aber zeig mir vorher den Grundcode.“

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