Guida al connettore13 minuti di lettura38 tool MCP7 lingue

Collegare Superdrug a Cursor via MCP

Gestisci il tuo negozio nel marketplace Superdrug 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 Superdrug.

HCA cura del team HelpCodeAggiornato 13 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Superdrug Marketplace

Superdrug Marketplace

Run your shop on the Superdrug marketplace from an AI agent: orders, acceptance, tracking and shipping, incidents, offers with prices and stock, imports, messages, returns, invoices and transactions. The marketplace sells in the United Kingdom; sign in with the shop API key from your Superdrug seller back office.

tool

38

Regione

GB

Categoria

E-commerce

Autenticazione

API Key

Env vars richieste

SUPERDRUG_API_KEY
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

In breve

Gestisci il tuo negozio nel marketplace Superdrug 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 Superdrug.

Configurazione guidata

Collega Superdrug Marketplace a Cursor in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Superdrug Marketplace con la configurazione guidata e aggiungi il tuo URL MCP a Cursor. Senza codice e senza server da gestire.

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Prova a chiedere

Prompt di esempio per Superdrug Marketplace

Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.

Superdrug Marketplace · live via MCP
Condividi
Opus 4.7

Claude è un'AI e può sbagliare. Verifica sempre le risposte.

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

Superdrug Marketplace + Cursor

Gestisci il tuo negozio nel marketplace Superdrug 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 Superdrug.

Prerequisiti

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

SUPERDRUG_API_KEY

Passo 1 — Ottieni le credenziali

Paesi: Regno Unito.

Chi può vendere: Superdrug seleziona i suoi venditori; contattali via e-mail ([email protected]). Il connettore ha bisogno di un account venditore già aperto da Superdrug.

La configurazione richiede circa 5 minuti.

  1. Accedi al back office venditore di Superdrug: https://superdrugnl-prod.mirakl.net/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 SUPERDRUG_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. Lascia SUPERDRUG_SHOP_ID vuoto. Solo se il tuo utente gestisce più negozi su Superdrug, imposta SUPERDRUG_SHOP_ID sull'id numerico del negozio su cui questo connettore dovrebbe funzionare (mostrato nel dashboard del back office accanto a Identificatore o ID Negozio, e restituito come shop_id da superdrug_get_account). Senza di esso, viene utilizzato il tuo negozio predefinito.
  4. Installa ed esegui superdrug_get_account: restituisce il negozio a cui appartiene la chiave.

Da dove iniziare: superdrug_get_account mostra il negozio dietro la chiave (id, nome, stato, valuta e canali). Per il lavoro quotidiano usa superdrug_list_orders con order_state_codes=WAITING_ACCEPTANCE, superdrug_list_offers per prezzi e stock e superdrug_list_threads per messaggi che aspettano una risposta.

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

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

Scritture: conferma prima. superdrug_accept_order, superdrug_update_tracking, superdrug_ship_order, superdrug_resolve_incident, superdrug_accept_return, superdrug_receive_return, superdrug_update_offers, superdrug_reply_thread, superdrug_create_order_thread e superdrug_import_products agiscono sul marketplace attivo. Prima di ogni chiamata, mostra all'utente cosa cambierà (id e righe dell'ordine, numero di tracciamento, SKU dell'offerta con il vecchio e 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. superdrug_import_offers può eliminare offerte (la modalità REPLACE elimina ogni offerta mancante dal file), quindi è installato spento.

Aggiornamento delle offerte (prezzi e stock): superdrug_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 (superdrug_get_offer o superdrug_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 qualsiasi 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 superdrug_get_offer_import prima di leggere di nuovo l'offerta. I codici di condizione per state_code provengono da superdrug_list_offer_conditions, i codici di classe logistica da superdrug_list_logistic_classes.

Importazioni di file: superdrug_import_products (P41) e superdrug_import_offers (OF01) prendono l'URL di un file CSV, XLSX o XML nel formato richiesto da Superdrug; il connettore lo scarica e lo carica su Superdrug. Tracciali con superdrug_list_product_imports / superdrug_get_product_import e superdrug_list_offer_imports / superdrug_get_offer_import.

Resi: superdrug_list_returns (RT11) elenca le richieste di reso. Dove Superdrug lascia decidere al negozio, superdrug_accept_return accetta o rifiuta una in WAITING_ACCEPTANCE e superdrug_receive_return conferma che la merce è arrivata. I rimborsi rimangono nel back office.

Messaggi: superdrug_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), superdrug_get_thread legge una con i suoi messaggi, superdrug_reply_thread risponde (destinatario CUSTOMER o OPERATOR, che è Superdrug) e superdrug_create_order_thread apre una nuova conversazione su un ordine. I codici di motivo per gli argomenti provengono da superdrug_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: superdrug_list_invoices (IV01) elenca i documenti contabili che Superdrug emette al negozio e superdrug_list_transactions (TL02) le righe delle transazioni (vendite, commissioni, rimborsi, pagamenti). Se Superdrug utilizza la Fatturazione Venditore Avanzata, IV01 non restituisce nuovi documenti; usa superdrug_list_document_requests (DR11) e poi le transazioni.

Liste di riferimento: superdrug_list_channels (siti dei paesi), superdrug_list_carriers, superdrug_list_shipping_zones, superdrug_list_shipping_methods e superdrug_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 in ISO 8601, ad es. 2026-10-01T00:00:00Z; le risposte sono in UTC.

Limiti di frequenza: Ogni API ha il proprio limite e Superdrug può stringerli. L'elenco delle offerte e degli ordini è destinato a un uso interattivo, le importazioni di prodotti e offerte al massimo ogni 15 minuti, superdrug_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 es. 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 Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
  3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
  4. Inizia a chattare: l'agente ora può usare i tool di Superdrug Marketplace.

Strumenti disponibili

StrumentoCosa fa
superdrug_get_accountLeggi il negozio dietro la chiave API su questo marketplace (A01): id e nome del negozio, stato, canali, valuta, grado e tasso di approvazione, contatto…
superdrug_list_ordersElenca gli ordini (OR11) con le loro righe, cliente, indirizzo di spedizione, prezzi, stato e incidenti. Filtra per stato (ad es. WAITING_ACCEPTANCE per…
superdrug_list_offersElenca le offerte del negozio (OF21): SKU, prodotto, prezzo e sconto, tutti i prezzi dei canali, quantità in stock, condizione, tempo di consegna e se…
superdrug_get_offerLeggi un'offerta intera per il suo id offerta (OF22): ogni campo di prezzo, sconto, quantità, condizione, classe logistica, tempo di consegna e personal…
superdrug_list_offer_conditionsElenca le condizioni delle offerte (OF61) che il marketplace accetta, ad es. nuovo o usato, con il codice da inserire in state_code quando si aggiornano le offerte
superdrug_list_offer_importsElenca le importazioni e aggiornamenti delle offerte (OF04), da file e da superdrug_update_offers: stato (WAITING, RUNNING, COMPLETE, FAILED), righe…
superdrug_get_offer_importLeggi lo stato di un'importazione di offerta o aggiornamento offerta (OF02) per il suo import_id, come restituito da superdrug_update_offers o…
superdrug_export_offersAvvia un'esportazione di tutte le offerte del negozio come file (OF52), il modo per leggere l'intero catalogo (ogni SKU con prezzo e stock) invece di scorrere superdrug_list_offers pagina per pagina
superdrug_get_offer_export_statusStato di un'esportazione di offerte avviata con superdrug_export_offers (OF53): PENDING, COMPLETED o FAILED e, una volta completata, gli URL dei file
superdrug_get_offer_export_fileLeggi un file di un'esportazione di offerte completata (OF54): le offerte con SKU, prodotto, quantità, prezzi e gli altri campi esportati, in JSON o CSV
superdrug_list_product_importsElenca le importazioni di prodotti (P51) con il loro stato (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), i conteggi di trasformazione e il…
superdrug_get_product_importLeggi lo stato di un'importazione di prodotto (P42) per il suo import_id: stato di importazione, motivo, conteggi di trasformazione e i dettagli di integrazione…
superdrug_get_productsCerca prodotti nel catalogo del marketplace per i loro identificatori (P31), ad es. EAN, e ottieni il SKU del prodotto nel marketplace, titolo e categoria.…
superdrug_list_product_offersElenca le offerte di ogni negozio per i prodotti dati (P11), ordinate per miglior prezzo, per confrontare il tuo prezzo con la concorrenza. Fornisci product_ids…
superdrug_list_threadsElenca i thread di messaggi (M11) con clienti e Superdrug: argomento, ordine o offerta collegata, partecipanti, data dell'ultimo messaggio e da quando un…
superdrug_get_threadLeggi un thread di messaggi (M10) con tutti i suoi messaggi, mittenti, destinatari, allegati e l'ordine o l'offerta collegata
superdrug_list_returnsElenca le richieste di reso (RT11) con il loro stato, righe di reso, motivo, RMA, tracciamento e l'ordine collegato. Filtra per stato, ordine o data.…
superdrug_list_reasonsElenca i codici di motivo del marketplace (RE01): incidente, cancellazione, rimborso e motivi di messaggio, con le loro etichette e se il negozio può…
superdrug_list_carriersElenca i corrieri conosciuti dal marketplace (SH21) con il loro codice, etichetta e URL di tracciamento. Usa il codice come carrier_code in…
superdrug_list_invoicesElenca i documenti contabili che Superdrug emette al negozio (IV01): fatture e note di credito con periodo, totali con e senza tasse…
superdrug_list_transactionsElenca le righe delle transazioni del negozio (TL02): importi degli ordini, spedizione, commissioni, rimborsi, crediti manuali e pagamenti, con importo, tipo…
superdrug_list_document_requestsElenca le richieste di documenti contabili (DR11), utilizzate quando Superdrug esegue la Fatturazione Venditore Avanzata: fatture e note di credito che Superdrug o…
superdrug_list_order_documentsElenca i documenti allegati a uno o più ordini (OR72): bolle di consegna, etichette di spedizione, fatture clienti e altri file, con id, file…
superdrug_list_channelsElenca i canali di vendita del marketplace (CH11), di solito uno per sito paese, con codice ed etichetta. Usa i codici come channel_codes in…
superdrug_list_shipping_zonesElenca le zone di spedizione attive del marketplace (SH11) con codice ed etichetta, ad es. Francia continentale o Corsica. Cambiano raramente: chiamalo…
superdrug_list_shipping_methodsElenca i metodi di spedizione attivi del marketplace (SH12), ad es. standard, espresso o ritiro, con codice, etichetta, se un numero di tracciamento…
superdrug_list_logistic_classesElenca le classi logistiche del marketplace (SH31), le fasce di dimensione o peso che decidono i prezzi di spedizione, con codice ed etichetta. Usa il codice come…
superdrug_accept_orderAccetta o rifiuta le righe di un ordine in attesa di accettazione (OR21). Ogni riga dell'ordine deve essere elencata. Rifiutare una riga la annulla…
superdrug_update_trackingImposta il corriere e il numero di tracciamento di un ordine (OR23). Fornisci carrier_code da superdrug_list_carriers, o carrier_name con carrier_url…
superdrug_ship_orderConferma che un ordine in SPEDIZIONE è stato spedito (OR24); passa a SPEDITO e il cliente viene notificato. Imposta prima il tracciamento con…
superdrug_update_offersCrea o aggiorna offerte, inclusi prezzo e stock (OF24). Sostituisce ogni offerta completamente: ogni campo lasciato fuori viene ripristinato (una mancante…
superdrug_reply_threadRispondi in un thread di messaggi (M12) al cliente o a Superdrug. Il messaggio viene consegnato immediatamente e non può essere ritirato: mostra all'utente il…
superdrug_create_order_threadInizia un nuovo thread di messaggi su un ordine (OR43) con il cliente, Superdrug o entrambi. Il messaggio viene consegnato immediatamente: mostra all'utente il…
superdrug_resolve_incidentContrassegna l'incidente aperto su una riga d'ordine come risolto (OR64), una volta che il problema del cliente è risolto. reason_code deve essere un INCIDENT_CLOSE…
superdrug_accept_returnAccetta o rifiuta una richiesta di reso in ATTESA DI ACCETTAZIONE (RT21). Solo quando Superdrug gestisce i resi nel back office venditore e lascia…
superdrug_receive_returnConferma che la merce di un reso accettato è arrivata nel tuo magazzino (RT25). Il reso passa a RICEVUTO. Agisce sul marketplace attivo…
superdrug_import_productsInvia un file di prodotto al marketplace (P41) per creare o arricchire prodotti nel suo catalogo. file_url è l'indirizzo di un CSV, XLSX o XML…
superdrug_import_offersImporta un file di offerte (OF01) per creare, aggiornare o eliminare offerte in blocco. La modalità REPLACE elimina ogni offerta che non è nel file, e…

Esempi di prompt

  • "Quali ordini Superdrug sono in attesa della mia accettazione?"
  • "Imposta lo stock del mio siero di vitamina C SKU VC-SER-30 a 60."
  • "Quali richieste di reso sono in attesa della mia decisione?"
  • "Aggiungi il tracciamento Royal Mail AB123456789GB all'ordine 6620915-A e conferma la spedizione."
  • "Mostra le transazioni della scorsa settimana: vendite, commissioni e rimborsi."

FAQ

Dove posso ottenere la chiave API di Superdrug? Nel back office venditore di Superdrug: 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. Se il tuo utente ha più di un negozio, imposta SUPERDRUG_SHOP_ID; altrimenti viene utilizzato il tuo negozio predefinito.

Chi può vendere su Superdrug e quali paesi copre? Superdrug seleziona i suoi venditori; contattali via e-mail ([email protected]). Il connettore copre il Regno Unito.

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

Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

Questa guida ti è stata utile?

Collega Superdrug Marketplace a Cursor in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Superdrug Marketplace con la configurazione guidata e aggiungi il tuo URL MCP a Cursor. Senza codice e senza server da gestire.

Guide correlate

Connettori

Collegare Superdrug a ChatGPT via MCP

Gestisci il tuo negozio nel marketplace Superdrug 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 Superdrug.

Connettori

Collegare Superdrug a Claude via MCP

Gestisci il tuo negozio nel marketplace Superdrug 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 Superdrug.

Connettori

Collegare Superdrug a Microsoft Copilot via MCP

Gestisci il tuo negozio nel marketplace Superdrug 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 Superdrug.

Connettori

Collegare Superdrug a Gemini CLI via MCP

Gestisci il tuo negozio nel marketplace Superdrug 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 Superdrug.

Connettori

Collegare Superdrug a Meta Muse via MCP

Gestisci il tuo negozio nel marketplace Superdrug 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 Superdrug.

Connettori

Superdrug MCP: ordini, offerte e spedizioni

Gestisci il tuo negozio nel marketplace di Superdrug 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 Superdrug.