MediaMarkt MCP-Server: Bestellungen und Versand

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → MediaMarkt Marketplace, füge deine Zugangsdaten ein, mint einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein git clone, kein lokaler Server.

MediaMarkt Marketplace

Betreibe deinen Shop auf dem MediaMarkt-Marktplatz von einem KI-Agenten aus: Bestellungen, Annahme, Verfolgung und Versand, Vorfälle, Angebote mit Preisen und Lagerbestand, Importe, Nachrichten, Rücksendungen, Rechnungen und Transaktionen. Der Marktplatz verkauft in Deutschland, Österreich, Spanien, den Niederlanden, Italien, Belgien, der Schweiz, Polen und Ungarn; melde dich mit dem Shop-API-Schlüssel aus deinem MediaMarkt Verkäufer-Backoffice an.

Einrichtung

Länder: Deutschland, Österreich, Spanien, die Niederlande, Italien, Belgien, die Schweiz, Polen und Ungarn. In Italien handelt der Marktplatz als MediaWorld. Alle Länder teilen sich eine Verkäuferplattform.

Wer verkaufen kann: MediaMarkt nimmt Bewerbungen über ein Formular pro Land entgegen, gefolgt von einer Geschäftsüberprüfung (KYC). Der Connector benötigt ein Verkäuferkonto, das MediaMarkt bereits eröffnet hat.

Die Einrichtung dauert etwa 5 Minuten.

1. Melde dich im MediaMarkt Verkäufer-Backoffice an: https://mediamarktsaturn.mirakl.net/login.
2. Öffne im Backoffice deinen Benutzernamen (oben rechts) > Meine Benutzereinstellungen > API-Schlüssel und klicke auf Neuen Schlüssel generieren (oder kopiere den vorhandenen Schlüssel). Füge ihn in MEDIAMARKT_API_KEY ein. Der Schlüssel wird so wie er ist im Authorization-Header gesendet, ohne Bearer. Das Generieren eines neuen Schlüssels macht den alten ungültig, sodass jedes andere Tool, das ihn verwendet, nicht mehr funktioniert.
3. MediaMarkt eröffnet normalerweise einen Shop pro Land, sodass die meisten Verkäufer mehrere Shops unter einem Benutzer haben. Wenn dein Benutzer mehr als einen Shop hat, setze MEDIAMARKT_SHOP_ID auf die numerische ID des Shops, auf dem dieser Connector arbeiten soll (angezeigt auf dem Dashboard des Backoffice neben Identifier oder Shop ID, und zurückgegeben als shop_id von mediamarkt_get_account); um an mehreren Shops zu arbeiten, installiere den Connector einmal pro Shop. Ohne dies wird dein Standard-Shop verwendet.
4. Installiere und führe mediamarkt_get_account aus: es gibt den Shop zurück, zu dem der Schlüssel gehört.

Wo du anfangen kannst: mediamarkt_get_account zeigt den Shop hinter dem Schlüssel (ID, Name, Status, Währung und Kanäle). Für die tägliche Arbeit verwende mediamarkt_list_orders mit order_state_codes=WAITING_ACCEPTANCE, mediamarkt_list_offers für Preise und Lagerbestand und mediamarkt_list_threads für Nachrichten, die auf eine Antwort warten.

Produkte und konkurrierende Angebote: mediamarkt_get_products sucht Produkte im MediaMarkt-Katalog nach EAN oder einer anderen Referenz und gibt die Marktplatz-Produkt-SKU zurück; mediamarkt_list_product_offers listet die Angebote jedes Shops für gegebene Produkte auf, bestes Preis zuerst, bei etwa 5 Aufrufen pro Minute.

Bestellworkflow: Eine neue Bestellung wartet in WAITING_ACCEPTANCE. mediamarkt_accept_order akzeptiert (oder verweigert) jede Zeile; nachdem der Kunde belastet wurde, wechselt die Bestellung zu SHIPPING. Dann speichert mediamarkt_update_tracking den Versanddienstleister und die Sendungsnummer (Versanddienstleister-Codes stammen von mediamarkt_list_carriers) und mediamarkt_ship_order bestätigt den Versand (SHIPPED). Spätere Status sind TO_COLLECT, RECEIVED, CLOSED, REFUSED und CANCELED. Verwende mediamarkt_list_orders mit order_state_codes=WAITING_ACCEPTANCE für die tägliche To-Do-Liste und has_incident=true für offene Vorfälle; mediamarkt_resolve_incident schließt einen Vorfall zu einer Bestellzeile, sobald er gelöst ist. Dokumente, die an Bestellungen angehängt sind (Lieferscheine, Etiketten, Kundenrechnungen), werden von mediamarkt_list_order_documents aufgelistet.

Schreiboperationen: zuerst bestätigen. mediamarkt_accept_order, mediamarkt_update_tracking, mediamarkt_ship_order, mediamarkt_resolve_incident, mediamarkt_accept_return, mediamarkt_receive_return, mediamarkt_update_offers, mediamarkt_reply_thread, mediamarkt_create_order_thread und mediamarkt_import_products wirken auf dem Live-Marktplatz. Zeige dem Benutzer vor jedem Aufruf, was sich ändern wird (Bestell-ID und Zeilen, Sendungsnummer, Angebots-SKU mit dem alten und neuen Preis oder Lagerbestand, den Nachrichtentext und die Empfänger) und warte auf ein Ja. Das Ablehnen einer Bestellzeile storniert sie endgültig. Kein Tool hier erstattet, storniert Bestellungen oder bewegt Geld; das machst du im Backoffice. mediamarkt_import_offers kann Angebote löschen (der REPLACE-Modus löscht jedes Angebot, das nicht in der Datei vorhanden ist), daher wird es standardmäßig deaktiviert installiert.

Aktualisierung von Angeboten (Preise und Lagerbestand): mediamarkt_update_offers (OF24) ersetzt das gesamte Angebot. Jedes Feld, das du auslässt, wird zurückgesetzt: eine fehlende quantity wird zu 0, ein fehlender discount oder description wird gelöscht. Lese immer zuerst das Angebot (mediamarkt_get_offer oder mediamarkt_list_offers mit sku) und sende es vollständig mit nur der beabsichtigten Änderung zurück: shop_sku, product_id und product_id_type (aus product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (seinen Code), min_quantity_alert, description, discount, all_prices, available_started / available_ended (gelesen als available_start_date / available_end_date) und alle offer_additional_fields. Lass update_delete leer oder setze es auf update. Der Aufruf gibt eine import_id zurück; die Änderung wird asynchron angewendet, also überprüfe sie mit mediamarkt_get_offer_import, bevor du das Angebot erneut liest. Zustandscodes für state_code stammen von mediamarkt_list_offer_conditions, Logistik-Klassencodes von mediamarkt_list_logistic_classes.

Dateiimporte: mediamarkt_import_products (P41) und mediamarkt_import_offers (OF01) nehmen die URL einer CSV-, XLSX- oder XML-Datei im von MediaMarkt geforderten Dateiformat; der Connector lädt sie herunter und lädt sie zu MediaMarkt hoch. Verfolge sie mit mediamarkt_list_product_imports / mediamarkt_get_product_import und mediamarkt_list_offer_imports / mediamarkt_get_offer_import.

Rücksendungen: mediamarkt_list_returns (RT11) listet Rücksendeanfragen auf. Wo MediaMarkt den Shop entscheiden lässt, akzeptiert mediamarkt_accept_return eine in WAITING_ACCEPTANCE oder verweigert sie, und mediamarkt_receive_return bestätigt, dass die Waren angekommen sind. Rückerstattungen bleiben im Backoffice.

Nachrichten: mediamarkt_list_threads listet Konversationen (filtere mit entity_type=MMP_ORDER und entity_id=<order id> für eine Bestellung; entity_id ohne entity_type wird abgelehnt), mediamarkt_get_thread liest einen mit seinen Nachrichten, mediamarkt_reply_thread antwortet (Empfänger CUSTOMER oder OPERATOR, was MediaMarkt ist) und mediamarkt_create_order_thread eröffnet eine neue Konversation zu einer Bestellung. Grundcodes für Themen stammen von mediamarkt_list_reasons; lasse locale leer, es sei denn, du weißt, dass der Marktplatz diese Sprache hat (eine inaktive Locale antwortet mit 400).

Geld: mediamarkt_list_invoices (IV01) listet die Buchhaltungsdokumente auf, die MediaMarkt dem Shop ausstellt, und mediamarkt_list_transactions (TL02) die Transaktionszeilen (Verkäufe, Provisionen, Rückerstattungen, Auszahlungen). Wenn MediaMarkt Enhanced Seller Invoicing verwendet, gibt IV01 keine neuen Dokumente zurück; verwende dann mediamarkt_list_document_requests (DR11) und die Transaktionen.

Referenzlisten: mediamarkt_list_channels (Länderseiten), mediamarkt_list_carriers, mediamarkt_list_shipping_zones, mediamarkt_list_shipping_methods und mediamarkt_list_logistic_classes ändern sich selten; lese sie einmal pro Konversation.

Seitenumbruch: Bestellungen, Angebote, Rechnungen und Produktimporte seitenweise mit max (höchstens 100) und offset. Threads, Rücksendungen, Transaktionen, Dokumentanfragen und Angebotsimporte geben ein next_page_token zurück; übergebe es als page_token, um die nächste Seite zu erhalten (alle anderen Filter werden dann ignoriert), bis es fehlt.

Daten sind im ISO 8601-Format, z.B. 2026-10-01T00:00:00Z; Antworten sind in UTC.

Rate-Limits: Jede API hat ihr eigenes Limit und MediaMarkt kann diese verschärfen. Das Auflisten von Angeboten und Bestellungen ist für die interaktive Nutzung gedacht, Produkt- und Angebotsimporte höchstens alle 15 Minuten, mediamarkt_get_account und die Referenzlisten etwa einmal am Tag. Ein 429 trägt einen Retry-After-Header mit den Sekunden, die gewartet werden sollen; versuche es nicht in einer Schleife erneut.

Fehler: 401 bedeutet, dass der Schlüssel falsch ist oder durch einen neueren ersetzt wurde, 403, dass deinem Benutzer das Recht für diese Aktion fehlt, 404, dass die Bestellung, das Angebot oder der Thread für diesen Shop nicht existiert, 400 ein falscher Parameter oder eine Bestellung in einem falschen Status (die Nachricht nennt es, z.B. ORDER_INVALID_STATE).

Voraussetzungen: MEDIAMARKT_API_KEY

Installiere den Connector lokal

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 MediaMarkt Marketplace und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.

Verfügbare Tools

Beispielaufforderungen

• "Liste meine MediaMarkt-Bestellungen auf, die sich im STATUS VERSAND befinden und noch keine Sendungsnummer haben."
• "Wer hat den besten Preis für die Kopfhörer mit EAN 4548736132610 auf MediaMarkt, und wo steht meiner?"
• "Welche meiner MediaMarkt-Angebote haben weniger als 3 Einheiten auf Lager?"
• "Zeige die offenen Vorfälle zu meinen MediaMarkt-Bestellungen und was die Kunden geschrieben haben."
• "Antworte dem Kunden im Thread zur Bestellung 4501234-A, dass der Ersatz morgen versendet wird."

Nächste Schritte

• Verbinde dich mit Claude
• Verbinde dich mit ChatGPT