B&Q Marketplace MCP mit Gemini CLI verbinden

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

B&Q Marketplace + Gemini

Betreibe deinen Shop auf dem B&Q-Marktplatz mit einem KI-Agenten: 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.

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:

B_AND_Q_API_KEY

Schritt 1 — Zugangsdaten erhalten

Länder: das Vereinigte Königreich.

Wer kann verkaufen: 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 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. Verkäufer bei 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 im 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 dies wird dein Standardshop 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 anfangen: 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, 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 zu 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 nicht in der Datei vorhanden ist), 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 enthält einen Retry-After-Header mit den Sekunden, die gewartet werden sollen; 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 — Den Connector in Gemini 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.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal) — anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die B&Q Marketplace-Tools aufrufen.

Verfügbare Tools

Beispielaufforderungen

• "Welche B&Q-Bestellungen warten auf Annahme und wie hoch ist ihr Gesamtwert in GBP?"
• "Setze den Lagerbestand meiner Gartenschlauchrolle SKU HR-30M auf 40 bei B&Q."
• "Markiere den Vorfall in 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."

FAQ

Wo bekomme ich den B&Q-API-Schlüssel her? Im B&Q-Verkäufer-Backoffice: deinen Benutzernamen (oben rechts), Meine Benutzereinstellungen, API-Schlüssel, dann Neuen Schlüssel generieren (oder kopiere den vorhandenen Schlüssel). Das Generieren eines neuen Schlüssels macht den alten ungültig. Verkäufer bei B&Q sind bekannt dafür, die Shop-ID auch mit einem einzelnen Shop festzulegen. Bei mehr als einem Shop setze B_AND_Q_SHOP_ID auf den Shop, auf dem dieser Connector arbeiten soll.

Wer kann auf B&Q verkaufen und welche Länder deckt es ab? B&Q nimmt Bewerbungen über den Kingfisher Merchant Hub entgegen; das Unternehmen muss umsatzsteuerregistriert sein. Der Connector deckt das Vereinigte Königreich ab. B&Q gehört zu Kingfisher, weshalb die Verkäuferplattform unter einer Kingfisher-Adresse zu finden ist.

Kann es Bestellungen stornieren, Rückerstattungen vornehmen oder Angebote löschen? Kein Tool erstattet oder storniert eine Bestellung; das machst du im B&Q-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. b_and_q_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.

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden