Collegare B&Q Marketplace MCP a Gemini CLI

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → B&Q Marketplace, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

B&Q Marketplace + Gemini

Gestisci il tuo negozio sul marketplace B&Q tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende nel Regno Unito; accedi con la chiave API del negozio dal tuo back office venditore B&Q.

Requisiti

Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:

B_AND_Q_API_KEY

Passo 1 — Ottieni le credenziali

Paesi: Regno Unito.

Chi può vendere: B&Q accetta domande tramite il Kingfisher Merchant Hub; l'azienda deve essere registrata per l'IVA. Il connettore ha bisogno di un account venditore che B&Q ha già aperto.

B&Q appartiene a Kingfisher, motivo per cui la piattaforma venditore si trova su un indirizzo Kingfisher.

La configurazione richiede circa 5 minuti.

1. Accedi al back office venditore B&Q: https://marketplace.kingfisher.com/login.
2. Nel back office apri il tuo nome utente (in alto a destra) > Le mie impostazioni utente > Chiave API e clicca su Genera una nuova chiave (o copia la chiave esistente). Incollala in B_AND_Q_API_KEY. La chiave viene inviata così com'è nell'intestazione Authorization, senza Bearer. Generare una nuova chiave invalida quella precedente, quindi qualsiasi altro strumento che la utilizza smette di funzionare.
3. I venditori su B&Q sono noti per impostare l'id del negozio, anche con un singolo negozio. Se il tuo utente ha più di un negozio, imposta B_AND_Q_SHOP_ID sull'id numerico del negozio su cui questo connettore dovrebbe funzionare (mostrato sulla dashboard del back office accanto a Identificatore o ID Negozio, e restituito come shop_id da b_and_q_get_account); per lavorare su più negozi, installa il connettore una volta per negozio. Senza di esso, viene utilizzato il tuo negozio predefinito.
4. Installa ed esegui b_and_q_get_account: restituisce il negozio a cui appartiene la chiave.

Da dove iniziare: b_and_q_get_account mostra il negozio dietro la chiave (id, nome, stato, valuta e canali). Per il lavoro quotidiano utilizza b_and_q_list_orders con order_state_codes=WAITING_ACCEPTANCE, b_and_q_list_offers per prezzi e stock e b_and_q_list_threads per messaggi che aspettano una risposta.

Prodotti e offerte concorrenti: b_and_q_get_products cerca i prodotti nel catalogo B&Q tramite EAN o un altro riferimento e restituisce il SKU del prodotto del marketplace; b_and_q_list_product_offers elenca le offerte di ogni negozio per i prodotti dati, il miglior prezzo per primo, con circa 5 chiamate al minuto.

Flusso di lavoro degli ordini: un nuovo ordine attende in WAITING_ACCEPTANCE. b_and_q_accept_order accetta (o rifiuta) ogni riga; dopo che il cliente è stato addebitato, l'ordine passa a SHIPPING. Poi b_and_q_update_tracking memorizza il corriere e il numero di tracciamento (i codici dei corrieri provengono da b_and_q_list_carriers) e b_and_q_ship_order conferma la spedizione (SHIPPED). Gli stati successivi sono TO_COLLECT, RECEIVED, CLOSED, REFUSED e CANCELED. Usa b_and_q_list_orders con order_state_codes=WAITING_ACCEPTANCE per la lista delle cose da fare quotidiane e has_incident=true per incidenti aperti; b_and_q_resolve_incident chiude un incidente su una riga d'ordine una volta risolto. I documenti allegati agli ordini (note di consegna, etichette, fatture clienti) sono elencati da b_and_q_list_order_documents.

Scritture: conferma prima. 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 e b_and_q_import_products agiscono sul marketplace live. Prima di ogni chiamata, mostra all'utente cosa cambierà (id e righe dell'ordine, numero di tracciamento, SKU dell'offerta con il vecchio e il nuovo prezzo o stock, il testo del messaggio e i destinatari) e aspetta un sì. Rifiutare una riga d'ordine la annulla definitivamente. Nessuno strumento qui rimborsa, annulla ordini o sposta denaro; fallo nel back office. b_and_q_import_offers può eliminare offerte (la modalità REPLACE elimina ogni offerta mancante dal file), quindi è installato disattivato.

Aggiornamento delle offerte (prezzi e stock): b_and_q_update_offers (OF24) sostituisce l'intera offerta. Ogni campo che lasci fuori viene ripristinato: una quantity mancante diventa 0, un discount o description mancante viene eliminato. Leggi sempre prima l'offerta (b_and_q_get_offer o b_and_q_list_offers con sku) e rimandala completa con solo la modifica prevista: shop_sku, product_id e product_id_type (da product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (il suo codice), min_quantity_alert, description, discount, all_prices, available_started / available_ended (leggi come available_start_date / available_end_date) e eventuali offer_additional_fields. Lascia update_delete vuoto o update. La chiamata restituisce un import_id; la modifica viene applicata in modo asincrono, quindi controllala con b_and_q_get_offer_import prima di leggere di nuovo l'offerta. I codici di condizione per state_code provengono da b_and_q_list_offer_conditions, i codici della classe logistica da b_and_q_list_logistic_classes.

Importazioni di file: b_and_q_import_products (P41) e b_and_q_import_offers (OF01) prendono l'URL di un file CSV, XLSX o XML nel formato richiesto da B&Q; il connettore lo scarica e lo carica su B&Q. Tracciali con b_and_q_list_product_imports / b_and_q_get_product_import e b_and_q_list_offer_imports / b_and_q_get_offer_import.

Resi: b_and_q_list_returns (RT11) elenca le richieste di reso. Dove B&Q lascia decidere al negozio, b_and_q_accept_return accetta o rifiuta una in WAITING_ACCEPTANCE e b_and_q_receive_return conferma che la merce è arrivata. I rimborsi rimangono nel back office.

Messaggi: b_and_q_list_threads elenca le conversazioni (filtra con entity_type=MMP_ORDER e entity_id=<order id> per un ordine; entity_id senza entity_type viene rifiutato), b_and_q_get_thread legge una con i suoi messaggi, b_and_q_reply_thread risponde (destinatario CUSTOMER o OPERATOR, che è B&Q) e b_and_q_create_order_thread apre una nuova conversazione su un ordine. I codici di motivo per gli argomenti provengono da b_and_q_list_reasons; lascia il suo locale vuoto a meno che tu non sappia che il marketplace ha quella lingua (un locale inattivo risponde 400).

Denaro: b_and_q_list_invoices (IV01) elenca i documenti contabili che B&Q emette al negozio e b_and_q_list_transactions (TL02) le righe di transazione (vendite, commissioni, rimborsi, pagamenti). Se B&Q utilizza la Fatturazione Venditore Avanzata, IV01 non restituisce nuovi documenti; usa b_and_q_list_document_requests (DR11) e le transazioni poi.

Liste di riferimento: b_and_q_list_channels (siti dei paesi), b_and_q_list_carriers, b_and_q_list_shipping_zones, b_and_q_list_shipping_methods e b_and_q_list_logistic_classes cambiano raramente; leggili una volta per conversazione.

Paginazione: ordini, offerte, fatture e importazioni di prodotti paginano con max (al massimo 100) e offset. Thread, resi, transazioni, richieste di documenti e importazioni di offerte restituiscono un next_page_token; passalo come page_token per ottenere la pagina successiva (tutti gli altri filtri vengono quindi ignorati) fino a quando non è mancante.

Date sono ISO 8601, ad esempio 2026-10-01T00:00:00Z; le risposte sono in UTC.

Limiti di frequenza: Ogni API ha il proprio limite e B&Q può stringerli. L'elenco delle offerte e degli ordini è destinato all'uso interattivo, le importazioni di prodotti e offerte al massimo ogni 15 minuti, b_and_q_get_account e le liste di riferimento circa una volta al giorno. Un 429 porta un'intestazione Retry-After con i secondi da attendere; non riprovare in un ciclo.

Errori: 401 significa che la chiave è errata o è stata sostituita da una più recente, 403 che il tuo utente non ha il diritto per questa azione, 404 che l'ordine, l'offerta o il thread non esistono per questo negozio, 400 un parametro errato o un ordine in uno stato errato (il messaggio lo nomina, ad esempio ORDER_INVALID_STATE).

Passo 2 — Installa l'adattatore

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

Passo 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di B&Q Marketplace.

Strumenti disponibili

Esempi di prompt

• "Quali ordini B&Q sono in attesa di accettazione e qual è il loro valore totale in GBP?"
• "Imposta lo stock del mio SKU del riavvolgitore per tubo da giardino HR-30M a 40 su B&Q."
• "Segna l'incidente sulla riga 2 dell'ordine 7012345-A come risolto; il cliente ha ricevuto le viti mancanti."
• "Quali delle mie offerte B&Q non sono attive e quale motivo fornisce B&Q?"
• "Mostrami le fatture che B&Q mi ha emesso questo trimestre con i totali delle commissioni."

FAQ

Dove posso ottenere la chiave API di B&Q? Nel back office venditore B&Q: il tuo nome utente (in alto a destra), Le mie impostazioni utente, Chiave API, poi Genera una nuova chiave (o copia la chiave esistente). Generare una nuova chiave invalida quella precedente. I venditori su B&Q sono noti per impostare l'id del negozio, anche con un singolo negozio. Con più di un negozio, imposta B_AND_Q_SHOP_ID sul negozio su cui questo connettore dovrebbe funzionare.

Chi può vendere su B&Q e quali paesi copre? B&Q accetta domande tramite il Kingfisher Merchant Hub; l'azienda deve essere registrata per l'IVA. Il connettore copre il Regno Unito. B&Q appartiene a Kingfisher, motivo per cui la piattaforma venditore si trova su un indirizzo Kingfisher.

Può annullare ordini, rimborsare o eliminare offerte? Nessuno strumento rimborsa o annulla un ordine; fallo nel back office di B&Q. Rifiutare una riga durante l'accettazione di un ordine la annulla definitivamente, quindi l'AI ti mostra ogni scrittura e aspetta un sì. b_and_q_import_offers è installato disattivato, perché la sua modalità REPLACE elimina ogni offerta mancante dal file; attivalo nella pagina del connettore solo se l'AI deve usarlo.

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a Claude