MediaMarkt MCP mit Cursor verbinden

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

MediaMarkt Marketplace + Cursor

Betreibe deinen Shop auf dem MediaMarkt-Marktplatz über einen KI-Agenten: 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.

Voraussetzungen

Siehe die vollständigen Einrichtungsanweisungen, die im Connector enthalten sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

MEDIAMARKT_API_KEY

Schritt 1 — Zugangsdaten erhalten

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 kann verkaufen: MediaMarkt nimmt Anträge ü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 im 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 Standardshop verwendet.
4. Installiere und führe mediamarkt_get_account aus: es gibt den Shop zurück, zu dem der Schlüssel gehört.

Wo anfangen: 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 anhand der EAN oder einer anderen Referenz und gibt die Marktplatz-Produkt-SKU zurück; mediamarkt_list_product_offers listet die Angebote jedes Shops für bestimmte 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.

Schreibvorgänge: 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 im Datei fehlt), daher wird es standardmäßig deaktiviert installiert.

Angebote aktualisieren (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 (von 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 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, Logistikklassencodes von mediamarkt_list_logistic_classes.

Dateiimporte: mediamarkt_import_products (P41) und mediamarkt_import_offers (OF01) benötigen 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 das 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 (maximal 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 enthält einen Retry-After-Header mit den Sekunden, die zu warten sind; versuche nicht, in einer Schleife erneut zu versuchen.

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

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

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die MediaMarkt Marketplace-Tools aufrufen.

Verfügbare Tools

Beispielaufforderungen

• "Liste meine MediaMarkt-Bestellungen auf, die sich im 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."

FAQ

Wo bekomme ich den MediaMarkt-API-Schlüssel her? Im MediaMarkt-Verkäufer-Backoffice: deinen Benutzernamen (oben rechts), Meine Benutzereinstellungen, API-Schlüssel, dann Neuen Schlüssel generieren (oder den vorhandenen Schlüssel kopieren). Das Generieren eines neuen Schlüssels macht den alten ungültig. MediaMarkt eröffnet normalerweise einen Shop pro Land, sodass die meisten Verkäufer mehrere Shops unter einem Benutzer haben. Bei mehr als einem Shop setze MEDIAMARKT_SHOP_ID auf den Shop, auf dem dieser Connector arbeiten soll.

Wer kann auf MediaMarkt verkaufen und welche Länder sind abgedeckt? MediaMarkt nimmt Anträge über ein Formular pro Land entgegen, gefolgt von einer Geschäftsüberprüfung (KYC). Der Connector deckt Deutschland, Österreich, Spanien, die Niederlande, Italien, Belgien, die Schweiz, Polen und Ungarn ab. In Italien handelt der Marktplatz als MediaWorld. Alle Länder teilen sich eine Verkäuferplattform.

Kann es Bestellungen stornieren, Rückerstattungen vornehmen oder Angebote löschen? Kein Tool erstattet oder storniert eine Bestellung; das machst du im MediaMarkt-Backoffice. Das Ablehnen einer Zeile beim Akzeptieren einer Bestellung storniert sie endgültig, sodass die KI dir jede Schreiboperation zeigt und auf ein Ja wartet. mediamarkt_import_offers wird standardmäßig deaktiviert installiert, da der REPLACE-Modus jedes Angebot löscht, das in der Datei fehlt; schalte es auf der Connector-Seite nur ein, wenn die KI es verwenden soll.

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja — MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden