B&Q Marketplace MCP-Server: Bestellungen und Versand

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

B&Q Marketplace

Betreibe deinen Shop auf dem B&Q-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 im Vereinigten Königreich; melde dich mit dem Shop-API-Schlüssel aus deinem B&Q Verkäufer-Backoffice an.

Einrichtung

Länder: das Vereinigte Königreich.

Wer verkaufen kann: B&Q nimmt Bewerbungen über den Kingfisher Merchant Hub entgegen; das Unternehmen muss umsatzsteuerregistriert sein. Der Connector benötigt ein Verkäuferkonto, das B&Q bereits eröffnet hat.

B&Q gehört zu Kingfisher, weshalb die Verkäuferplattform unter einer Kingfisher-Adresse zu finden ist.

Die Einrichtung dauert etwa 5 Minuten.

1. Melde dich im B&Q Verkäufer-Backoffice an: https://marketplace.kingfisher.com/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 B_AND_Q_API_KEY ein. Der Schlüssel wird unverändert 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. Verkäufer auf B&Q sind bekannt dafür, die Shop-ID auch mit einem einzelnen Shop festzulegen. Wenn dein Benutzer mehr als einen Shop hat, setze B_AND_Q_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 b_and_q_get_account); um an mehreren Shops zu arbeiten, installiere den Connector einmal pro Shop. Ohne ihn wird dein Standard-Shop verwendet.
4. Installiere und führe b_and_q_get_account aus: es gibt den Shop zurück, zu dem der Schlüssel gehört.

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

Produkte und konkurrierende Angebote: b_and_q_get_products sucht Produkte im B&Q-Katalog nach EAN oder einer anderen Referenz und gibt die Marktplatz-Produkt-SKU zurück; b_and_q_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. b_and_q_accept_order akzeptiert (oder verweigert) jede Zeile; nachdem der Kunde belastet wurde, wechselt die Bestellung zu SHIPPING. Dann speichert b_and_q_update_tracking den Versanddienstleister und die Sendungsnummer (Versanddienstleister-Codes stammen von b_and_q_list_carriers) und b_and_q_ship_order bestätigt den Versand (SHIPPED). Spätere Status sind TO_COLLECT, RECEIVED, CLOSED, REFUSED und CANCELED. Verwende b_and_q_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; b_and_q_resolve_incident schließt einen Vorfall auf einer Bestellzeile, sobald er gelöst ist. Dokumente, die an Bestellungen angehängt sind (Lieferscheine, Etiketten, Kundenrechnungen), werden von b_and_q_list_order_documents aufgelistet.

Schreiboperationen: zuerst bestätigen. b_and_q_accept_order, b_and_q_update_tracking, b_and_q_ship_order, b_and_q_resolve_incident, b_and_q_accept_return, b_and_q_receive_return, b_and_q_update_offers, b_and_q_reply_thread, b_and_q_create_order_thread und b_and_q_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 altem und neuem 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. b_and_q_import_offers kann Angebote löschen (der REPLACE-Modus löscht jedes Angebot, das in der Datei fehlt), daher wird es standardmäßig deaktiviert installiert.

Angebote aktualisieren (Preise und Lagerbestand): b_and_q_update_offers (OF24) ersetzt das gesamte Angebot. Jedes Feld, das du weglässt, wird zurückgesetzt: eine fehlende quantity wird zu 0, ein fehlender discount oder description wird gelöscht. Lese immer zuerst das Angebot (b_and_q_get_offer oder b_and_q_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 b_and_q_get_offer_import, bevor du das Angebot erneut liest. Bedingungscodes für state_code stammen von b_and_q_list_offer_conditions, Logistik-Klassencodes von b_and_q_list_logistic_classes.

Dateiimporte: b_and_q_import_products (P41) und b_and_q_import_offers (OF01) nehmen die URL einer CSV-, XLSX- oder XML-Datei im von B&Q geforderten Dateiformat; der Connector lädt sie herunter und lädt sie zu B&Q hoch. Verfolge sie mit b_and_q_list_product_imports / b_and_q_get_product_import und b_and_q_list_offer_imports / b_and_q_get_offer_import.

Rücksendungen: b_and_q_list_returns (RT11) listet Rücksendeanfragen auf. Wo B&Q den Shop entscheiden lässt, akzeptiert b_and_q_accept_return eine in WAITING_ACCEPTANCE oder verweigert sie und b_and_q_receive_return bestätigt, dass die Waren angekommen sind. Rückerstattungen bleiben im Backoffice.

Nachrichten: b_and_q_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), b_and_q_get_thread liest einen mit seinen Nachrichten, b_and_q_reply_thread antwortet (Empfänger CUSTOMER oder OPERATOR, was B&Q ist) und b_and_q_create_order_thread eröffnet eine neue Konversation zu einer Bestellung. Grundcodes für Themen stammen von b_and_q_list_reasons; lasse sein locale leer, es sei denn, du weißt, dass der Marktplatz diese Sprache hat (eine inaktive Locale antwortet mit 400).

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

Referenzlisten: b_and_q_list_channels (Länderseiten), b_and_q_list_carriers, b_and_q_list_shipping_zones, b_and_q_list_shipping_methods und b_and_q_list_logistic_classes ändern sich selten; lese sie einmal pro Konversation.

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 B&Q 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, b_and_q_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 im falschen Status (die Nachricht nennt es, z.B. ORDER_INVALID_STATE).

Voraussetzungen: B_AND_Q_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 B&Q Marketplace und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.

Verfügbare Tools

Beispielaufforderungen

• "Welche B&Q-Bestellungen warten auf Annahme und wie hoch ist ihr Gesamtwert in GBP?"
• "Setze den Lagerbestand meiner Gartenschlauch-Wickel-SKU HR-30M auf 40 bei B&Q."
• "Markiere den Vorfall auf Zeile 2 der Bestellung 7012345-A als gelöst; der Kunde hat die fehlenden Schrauben erhalten."
• "Welche meiner B&Q-Angebote sind nicht aktiv und welchen Grund gibt B&Q an?"
• "Zeige die Rechnungen an, die B&Q mir in diesem Quartal mit ihren Provisionssummen ausgestellt hat."

Nächste Schritte

• Verbinde dich mit Claude
• Verbinde dich mit ChatGPT