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

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

ChatGPT fügt MCP-Server als Plugins auf seiner Seite Plugins hinzu, im Web und in den kostenpflichtigen Tarifen. Den Entwicklermodus brauchst du dafür nicht mehr. In einem Business-Workspace dürfen das nur Admins und Owner; in Enterprise und Edu kann ein Admin die Berechtigung Create plugins with MCPs vergeben.

1. Geh zu chatgpt.com/plugins, klicke auf + und dann auf Add custom MCP server.
2. Gib einen Namen ein, z. B. Name: Mirakl.
3. Trag unter Connection als Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein und lass Authentication auf OAuth.
4. Wähle I understand and want to continue und dann Create as a plugin. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an und erlaubst den Zugriff.
5. Installiere das neue Plugin unter deinen persönlichen Plugins, tippe dann in einem Chat @ und wähle es aus.

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

Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Servern? OpenAI dokumentiert eigene MCP-Server nur für kostenpflichtige Tarife; den Free-Tarif führt OpenAI nicht auf.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden