Collegare B&Q Marketplace MCP a Microsoft Copilot

💡 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di B&Q Marketplace.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

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.

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a Claude