Zusammenfassung
Betreibe deinen Shop auf dem Tesco Marketplace über einen KI-Agenten: Bestellungen, Annahme, Verfolgung und Versand, Vorfälle, Angebote mit Preisen und Lagerbestand, Importe, Nachrichten, Rücksendungen, Rechnungen und Transaktionen. Der Marketplace verkauft im Vereinigten Königreich; melde dich mit dem Shop-API-Schlüssel aus deinem Tesco-Verkäufer-Backoffice an.
Geführte Einrichtung
Tesco Marketplace in 2 Minuten mit Cursor verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Tesco Marketplace in der geführten Einrichtung und trag deine MCP-URL in Cursor ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für Tesco Marketplace
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → Tesco Marketplace, füge deine Zugangsdaten ein, generiere einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
Tesco Marketplace + Cursor
Betreibe deinen Shop auf dem Tesco Marketplace über einen KI-Agenten: Bestellungen, Annahme, Verfolgung und Versand, Vorfälle, Angebote mit Preisen und Lagerbestand, Importe, Nachrichten, Rücksendungen, Rechnungen und Transaktionen. Der Marketplace verkauft im Vereinigten Königreich; melde dich mit dem Shop-API-Schlüssel aus deinem Tesco-Verkäufer-Backoffice an.
Voraussetzungen
Siehe die vollständigen Einrichtungsanweisungen, die im Connector eingebaut sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:
TESCO_API_KEY
Schritt 1 — Zugangsdaten erhalten
Länder: das Vereinigte Königreich.
Wer kann verkaufen: Tesco nimmt Bewerbungen über sein Verkäufer-Bewerbungsformular entgegen und prüft jeden Verkäufer; das Unternehmen muss im Vereinigten Königreich registriert und umsatzsteuerregistriert sein. Der Connector benötigt ein Verkäuferkonto, das Tesco bereits eröffnet hat.
Der API-Schlüssel gehört dem Benutzer, der ihn erstellt hat: Er funktioniert nicht mehr, wenn dieser Benutzer deaktiviert wird oder die Rolle des Eigentümers oder Managers verliert.
Die Einrichtung dauert etwa 5 Minuten.
- Melde dich im Tesco Verkäufer-Backoffice an:
https://tescouk-prod.mirakl.net/login. - Öffne im Backoffice deine Initialen (oben rechts) > Persönliche Einstellungen > API-Schlüssel und klicke auf Neuen Schlüssel generieren (oder kopiere den vorhandenen Schlüssel). Füge ihn in
TESCO_API_KEYein. Der Schlüssel wird unverändert imAuthorization-Header gesendet, ohneBearer. Das Generieren eines neuen Schlüssels macht den alten ungültig, sodass jedes andere Tool, das ihn verwendet, nicht mehr funktioniert. - Lass
TESCO_SHOP_IDleer. Nur wenn dein Benutzer mehrere Shops bei Tesco verwaltet, setzeTESCO_SHOP_IDauf 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 alsshop_idvontesco_get_account). Ohne diese wird dein Standardshop verwendet. - Installiere und führe
tesco_get_accountaus: es gibt den Shop zurück, zu dem der Schlüssel gehört.
Wo anfangen: tesco_get_account zeigt den Shop hinter dem Schlüssel (ID, Name, Status, Währung und Kanäle). Für die tägliche Arbeit verwende tesco_list_orders mit order_state_codes=WAITING_ACCEPTANCE, tesco_list_offers für Preise und Lagerbestand und tesco_list_threads für Nachrichten, die auf eine Antwort warten.
Produkte und konkurrierende Angebote: tesco_get_products sucht Produkte im Tesco-Katalog nach EAN oder einer anderen Referenz und gibt die SKU des Marketplace-Produkts zurück; tesco_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. tesco_accept_order akzeptiert (oder lehnt) jede Zeile ab; nachdem der Kunde belastet wurde, wechselt die Bestellung zu SHIPPING. Dann speichert tesco_update_tracking den Versanddienstleister und die Sendungsnummer (Versanddienstleister-Codes stammen von tesco_list_carriers) und tesco_ship_order bestätigt den Versand (SHIPPED). Spätere Status sind TO_COLLECT, RECEIVED, CLOSED, REFUSED und CANCELED. Verwende tesco_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; tesco_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 tesco_list_order_documents aufgelistet.
Schreibvorgänge: zuerst bestätigen. tesco_accept_order, tesco_update_tracking, tesco_ship_order, tesco_resolve_incident, tesco_accept_return, tesco_receive_return, tesco_update_offers, tesco_reply_thread, tesco_create_order_thread und tesco_import_products wirken auf dem Live-Marketplace. 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. tesco_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): tesco_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 (tesco_get_offer oder tesco_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 setze es auf update. Der Aufruf gibt eine import_id zurück; die Änderung wird asynchron angewendet, also überprüfe sie mit tesco_get_offer_import, bevor du das Angebot erneut liest. Bedingungscodes für state_code stammen von tesco_list_offer_conditions, logistische Klassencodes von tesco_list_logistic_classes.
Dateiimporte: tesco_import_products (P41) und tesco_import_offers (OF01) benötigen die URL einer CSV-, XLSX- oder XML-Datei im von Tesco geforderten Dateiformat; der Connector lädt sie herunter und lädt sie zu Tesco hoch. Verfolge sie mit tesco_list_product_imports / tesco_get_product_import und tesco_list_offer_imports / tesco_get_offer_import.
Rücksendungen: tesco_list_returns (RT11) listet Rücksendeanfragen auf. Wo Tesco den Shop entscheiden lässt, akzeptiert tesco_accept_return eine in WAITING_ACCEPTANCE oder lehnt sie ab, und tesco_receive_return bestätigt, dass die Waren angekommen sind. Rückerstattungen bleiben im Backoffice.
Nachrichten: tesco_list_threads listet Gespräche (filtere mit entity_type=MMP_ORDER und entity_id=<order id> für eine Bestellung; entity_id ohne entity_type wird abgelehnt), tesco_get_thread liest einen mit seinen Nachrichten, tesco_reply_thread antwortet (Empfänger CUSTOMER oder OPERATOR, was Tesco ist) und tesco_create_order_thread eröffnet ein neues Gespräch zu einer Bestellung. Grundcodes für Themen stammen von tesco_list_reasons; lasse locale leer, es sei denn, du weißt, dass der Marketplace diese Sprache hat (eine inaktive Locale antwortet mit 400).
Geld: tesco_list_invoices (IV01) listet die Buchhaltungsdokumente auf, die Tesco dem Shop ausstellt, und tesco_list_transactions (TL02) die Transaktionszeilen (Verkäufe, Provisionen, Rückerstattungen, Auszahlungen). Wenn Tesco Enhanced Seller Invoicing verwendet, gibt IV01 keine neuen Dokumente zurück; verwende dann tesco_list_document_requests (DR11) und die Transaktionen.
Referenzlisten: tesco_list_channels (Länderseiten), tesco_list_carriers, tesco_list_shipping_zones, tesco_list_shipping_methods und tesco_list_logistic_classes ändern sich selten; lese sie einmal pro Gespräch.
Seitenumbruch: Bestellungen, Angebote, Rechnungen und Produktimporte paginieren 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 Tesco 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, tesco_get_account und die Referenzlisten etwa einmal am Tag. Ein 429 enthält 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 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 in einem falschen Zustand (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 AnleitungYOUR_SERVER_IDzeigt.
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" }
}
}
}
- Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von
YOUR_MCP_API_KEYein. - Speichere die Datei und starte Cursor neu.
- Öffne Cursor → Settings → MCP und prüfe, ob
anythingmcpaufgeführt und verbunden ist. - Leg los: Der Agent kann jetzt die
Tesco Marketplace-Tools aufrufen.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
tesco_get_account | Lies den Shop hinter dem API-Schlüssel auf diesem Marketplace (A01): Shop-ID und Name, Status, Kanäle, Währung, Bewertung und Genehmigungsrate, Kontakt… |
tesco_list_orders | Listet Bestellungen (OR11) mit ihren Zeilen, Kunden, Versandadresse, Preisen, Status und Vorfällen auf. Filtere nach Status (z.B. WAITING_ACCEPTANCE für… |
tesco_list_offers | Listet die Angebote des Shops (OF21): SKU, Produkt, Preis und Rabatt, alle Kanalpreise, Lagerbestand, Zustand, Vorlaufzeit und ob… |
tesco_get_offer | Lies ein Angebot vollständig nach seiner Angebots-ID (OF22): jedes Preisfeld, Rabatt, Menge, Zustand, logistische Klasse, Vorlaufzeit und benutzerdefinierte… |
tesco_list_offer_conditions | Listet die Angebotsbedingungen (OF61) auf, die der Marketplace akzeptiert, z.B. neu oder gebraucht, mit dem Code, den du in state_code beim Aktualisieren von Angeboten einfügen musst |
tesco_list_offer_imports | Listet Angebotsimporte und -aktualisierungen (OF04) auf, aus Dateien und von tesco_update_offers: Status (WAITING, RUNNING, COMPLETE, FAILED), gelesene Zeilen, in… |
tesco_get_offer_import | Lies den Status eines Angebotsimports oder einer Angebotsaktualisierung (OF02) nach seiner import_id, wie von tesco_update_offers oder tesco_import_offers zurückgegeben… |
tesco_export_offers | Startet einen Export aller Angebote des Shops als Dateien (OF52), um den ganzen Katalog (jede SKU mit Preis und Bestand) zu lesen, statt tesco_list_offers seitenweise abzurufen |
tesco_get_offer_export_status | Status eines mit tesco_export_offers gestarteten Angebotsexports (OF53): PENDING, COMPLETED oder FAILED, nach Abschluss mit den URLs der Dateien |
tesco_get_offer_export_file | Liest eine Datei eines abgeschlossenen Angebotsexports (OF54): die Angebote mit SKU, Produkt, Bestand, Preisen und den übrigen exportierten Feldern, als JSON oder CSV |
tesco_list_product_imports | Listet Produktimporte (P51) mit ihrem Status (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), den Transformationszahlen und den… |
tesco_get_product_import | Lies den Status eines Produktimports (P42) nach seiner import_id: Importstatus, Grund, Transformationszahlen und die Integrationsdetails… |
tesco_get_products | Suche Produkte im Marketplace-Katalog nach ihren Identifikatoren (P31), z.B. EAN, und erhalte die SKU des Marketplace-Produkts, Titel und Kategorie.… |
tesco_list_product_offers | Listet die Angebote jedes Shops für bestimmte Produkte (P11) auf, sortiert nach dem besten Preis, um deinen Preis mit der Konkurrenz zu vergleichen. Gib product_ids… |
tesco_list_threads | Listet Nachrichten-Threads (M11) mit Kunden und Tesco auf: Thema, verknüpfte Bestellung oder Angebot, Teilnehmer, Datum der letzten Nachricht und seit wann ein Shop… |
tesco_get_thread | Lies einen Nachrichten-Thread (M10) mit all seinen Nachrichten, Absendern, Empfängern, Anhängen und der verknüpften Bestellung oder dem Angebot |
tesco_list_returns | Listet Rücksendeanfragen (RT11) mit ihrem Status, Rücksendezeilen, Grund, RMA, Verfolgung und der verknüpften Bestellung. Filtere nach Status, Bestellung oder Datum.… |
tesco_list_reasons | Listet die Grundcodes des Marktplatzes (RE01): Vorfall, Stornierung, Rückerstattung und Nachrichtenursachen, mit ihren Bezeichnungen und ob der Shop… |
tesco_list_carriers | Listet die Versanddienstleister, die der Marketplace kennt (SH21) mit ihrem Code, ihrer Bezeichnung und der Verfolgungs-URL. Verwende den Code als carrier_code in… |
tesco_list_invoices | Listet die Buchhaltungsdokumente auf, die Tesco dem Shop ausstellt (IV01): Rechnungen und Gutschriften mit Zeitraum, Gesamtsummen mit und ohne Steuer… |
tesco_list_transactions | Listet die Transaktionszeilen des Shops (TL02): Bestellbeträge, Versand, Provisionen, Rückerstattungen, manuelle Gutschriften und Auszahlungen, mit Betrag, Typ… |
tesco_list_document_requests | Listet Anfragen für Buchhaltungsdokumente (DR11) auf, die verwendet werden, wenn Tesco Enhanced Seller Invoicing durchführt: Rechnungen und Gutschriften, die Tesco oder der Shop… |
tesco_list_order_documents | Listet die Dokumente auf, die an einer oder mehreren Bestellungen angehängt sind (OR72): Lieferscheine, Versandetiketten, Kundenrechnungen und andere Dateien, mit ID, Datei… |
tesco_list_channels | Listet die Vertriebskanäle des Marktplatzes auf (CH11), normalerweise einer pro Länderseite, mit Code und Bezeichnung. Verwende die Codes als channel_codes in… |
tesco_list_shipping_zones | Listet die aktiven Versandzonen des Marktplatzes (SH11) mit Code und Bezeichnung, z.B. Festland Frankreich oder Korsika. Ändert sich selten: rufe es… |
tesco_list_shipping_methods | Listet die aktiven Versandmethoden des Marktplatzes (SH12) auf, z.B. Standard, Express oder Abholung, mit Code, Bezeichnung, ob eine Sendungsnummer… |
tesco_list_logistic_classes | Listet die logistischen Klassen des Marktplatzes auf (SH31), die Größen- oder Gewichtsklassen, die die Versandpreise bestimmen, mit Code und Bezeichnung. Verwende den Code als… |
tesco_accept_order | Akzeptiere oder lehne die Zeilen einer Bestellung ab, die auf die Annahme wartet (OR21). Jede Zeile der Bestellung muss aufgelistet werden. Das Ablehnen einer Zeile storniert sie… |
tesco_update_tracking | Setze den Versanddienstleister und die Sendungsnummer einer Bestellung (OR23). Gib carrier_code von tesco_list_carriers an oder carrier_name mit carrier_url für einen… |
tesco_ship_order | Bestätige, dass eine Bestellung im STATUS SHIPPING versendet wurde (OR24); sie wechselt zu SHIPPED und der Kunde wird benachrichtigt. Setze zuerst die Verfolgung mit… |
tesco_update_offers | Erstelle oder aktualisiere Angebote, einschließlich Preis und Lagerbestand (OF24). Ersetzt jedes Angebot vollständig: jedes Feld, das ausgelassen wird, wird zurückgesetzt (eine fehlende… |
tesco_reply_thread | Antworte in einem Nachrichten-Thread (M12) an den Kunden oder Tesco. Die Nachricht wird sofort zugestellt und kann nicht zurückgenommen werden: zeige dem Benutzer den Text… |
tesco_create_order_thread | Starte einen neuen Nachrichten-Thread zu einer Bestellung (OR43) mit dem Kunden, Tesco oder beiden. Die Nachricht wird sofort zugestellt: zeige dem Benutzer den Text… |
tesco_resolve_incident | Markiere den offenen Vorfall zu einer Bestellzeile als gelöst (OR64), sobald das Problem des Kunden gelöst ist. reason_code muss ein INCIDENT_CLOSE… |
tesco_accept_return | Akzeptiere oder lehne eine Rücksendung in WAITING_ACCEPTANCE ab (RT21). Nur wenn Tesco Rücksendungen im Verkäufer-Backoffice bearbeitet und die… |
tesco_receive_return | Bestätige, dass die Waren einer akzeptierten Rücksendung in deinem Lager angekommen sind (RT25). Die Rücksendung wechselt zu RECEIVED. Wirkt auf dem Live-Marketplace… |
tesco_import_products | Sende eine Produktdatei an den Marketplace (P41), um Produkte in seinem Katalog zu erstellen oder zu bereichern. file_url ist die Adresse einer CSV-, XLSX- oder XML… |
tesco_import_offers | Importiere eine Angebotsdatei (OF01), um Angebote in großen Mengen zu erstellen, zu aktualisieren oder zu löschen. Der REPLACE-Modus löscht jedes Angebot, das nicht in der Datei vorhanden ist, und… |
Beispielaufforderungen
- "Welche Tesco-Bestellungen warten auf meine Annahme und wie hoch ist ihr Wert in GBP?"
- "Setze den Preis meiner Gartenbank SKU GB-TEAK-150 auf 179 GBP."
- "Zeige die offenen Vorfälle zu meinen Tesco-Bestellungen an."
- "Füge DPD-Verfolgung 15501234567890 zu Bestellung 8812345-A hinzu und bestätige den Versand."
- "Zeige die Rechnungen an, die Tesco mir in diesem Quartal ausgestellt hat."
FAQ
Wo bekomme ich den Tesco API-Schlüssel her? Im Tesco Verkäufer-Backoffice: deine Initialen (oben rechts), Persönliche Einstellungen, 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. Wenn dein Benutzer mehr als einen Shop hat, setze TESCO_SHOP_ID; andernfalls wird dein Standardshop verwendet.
Wer kann auf Tesco verkaufen und welche Länder sind abgedeckt? Tesco nimmt Bewerbungen über sein Verkäufer-Bewerbungsformular entgegen und prüft jeden Verkäufer; das Unternehmen muss im Vereinigten Königreich registriert und umsatzsteuerregistriert sein. Der Connector deckt das Vereinigte Königreich ab. Der API-Schlüssel gehört dem Benutzer, der ihn erstellt hat: Er funktioniert nicht mehr, wenn dieser Benutzer deaktiviert wird oder die Rolle des Eigentümers oder Managers verliert.
Kann es Bestellungen stornieren, Rückerstattungen vornehmen oder Angebote löschen? Kein Tool erstattet oder storniert eine Bestellung; das machst du im Tesco-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. tesco_import_offers wird standardmäßig deaktiviert installiert, da sein REPLACE-Modus jedes Angebot löscht, das nicht in der Datei vorhanden ist; 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
War dieser Guide hilfreich?