In breve
Gestisci il tuo negozio sul marketplace Super-Pharm tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Israele; accedi con la chiave API del negozio dal tuo back office venditore Super-Pharm.
Configurazione guidata
Collega Super-Pharm Marketplace a Claude in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Super-Pharm Marketplace con la configurazione guidata e aggiungi il tuo URL MCP a Claude. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
AnythingMCP è nella directory dei connettori di Claude: aggiungilo a Claude con un clic (si apre in una nuova scheda), poi accedi e scegli quali server MCP può usare Claude.
Prova a chiedere
Prompt di esempio per Super-Pharm Marketplace
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → Super-Pharm Marketplace, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Super-Pharm Marketplace + Claude
Gestisci il tuo negozio sul marketplace Super-Pharm tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Israele; accedi con la chiave API del negozio dal tuo back office venditore Super-Pharm.
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:
SUPER_PHARM_API_KEY
Passo 1 — Ottieni le credenziali
Paesi: Israele. Questo è il marketplace di shop.super-pharm.co.il in Israele; il sito polacco di Super-Pharm non accetta venditori di marketplace.
Chi può vendere: Super-Pharm approva ogni venditore prima che possa elencare; i venditori mantengono il proprio stock e consegnano direttamente ai clienti in Israele, e Super-Pharm prende una commissione su ogni vendita. Il connettore ha bisogno di un account venditore che Super-Pharm ha già aperto.
La configurazione richiede circa 5 minuti.
- Accedi al back office venditore di Super-Pharm:
https://superpharm-prod.mirakl.net/login. - 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
SUPER_PHARM_API_KEY. La chiave viene inviata così com'è nell'intestazioneAuthorization, senzaBearer. Generare una nuova chiave invalida quella vecchia, quindi qualsiasi altro strumento che la utilizza smette di funzionare. - Lascia
SUPER_PHARM_SHOP_IDvuoto. Solo se il tuo utente gestisce più negozi su Super-Pharm, impostaSUPER_PHARM_SHOP_IDsull'id numerico del negozio su cui questo connettore dovrebbe funzionare (mostrato nel dashboard del back office accanto a Identifier o Shop ID, e restituito comeshop_iddasuper_pharm_get_account). Senza di esso, viene utilizzato il tuo negozio predefinito. - Installa ed esegui
super_pharm_get_account: restituisce il negozio a cui appartiene la chiave.
Da dove iniziare: super_pharm_get_account mostra il negozio dietro la chiave (id, nome, stato, valuta e canali). Per il lavoro quotidiano utilizza super_pharm_list_orders con order_state_codes=WAITING_ACCEPTANCE, super_pharm_list_offers per prezzi e stock e super_pharm_list_threads per messaggi in attesa di risposta.
Prodotti e offerte concorrenti: super_pharm_get_products cerca i prodotti nel catalogo di Super-Pharm tramite EAN o un altro riferimento e restituisce lo SKU del prodotto del marketplace; super_pharm_list_product_offers elenca le offerte di ogni negozio per 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. super_pharm_accept_order accetta (o rifiuta) ogni riga; dopo che il cliente è stato addebitato, l'ordine passa a SHIPPING. Poi super_pharm_update_tracking memorizza il corriere e il numero di tracciamento (i codici dei corrieri provengono da super_pharm_list_carriers) e super_pharm_ship_order conferma la spedizione (SHIPPED). Gli stati successivi sono TO_COLLECT, RECEIVED, CLOSED, REFUSED e CANCELED. Usa super_pharm_list_orders con order_state_codes=WAITING_ACCEPTANCE per la lista delle cose da fare quotidiana e has_incident=true per incidenti aperti; super_pharm_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 super_pharm_list_order_documents.
Scritture: conferma prima. super_pharm_accept_order, super_pharm_update_tracking, super_pharm_ship_order, super_pharm_resolve_incident, super_pharm_accept_return, super_pharm_receive_return, super_pharm_update_offers, super_pharm_reply_thread, super_pharm_create_order_thread e super_pharm_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 nuovo prezzo o stock, testo del messaggio e 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. super_pharm_import_offers può eliminare offerte (la modalità REPLACE elimina ogni offerta mancante dal file), quindi è installato spento.
Aggiornamento delle offerte (prezzi e stock): super_pharm_update_offers (OF24) sostituisce l'intera offerta. Ogni campo che lasci fuori viene ripristinato: una quantity mancante diventa 0, uno sconto o descrizione mancante viene eliminato. Leggi sempre prima l'offerta (super_pharm_get_offer o super_pharm_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 super_pharm_get_offer_import prima di leggere di nuovo l'offerta. I codici di condizione per state_code provengono da super_pharm_list_offer_conditions, i codici di classe logistica da super_pharm_list_logistic_classes.
Importazioni di file: super_pharm_import_products (P41) e super_pharm_import_offers (OF01) prendono l'URL di un file CSV, XLSX o XML nel formato richiesto da Super-Pharm; il connettore lo scarica e lo carica su Super-Pharm. Tracciali con super_pharm_list_product_imports / super_pharm_get_product_import e super_pharm_list_offer_imports / super_pharm_get_offer_import.
Resi: super_pharm_list_returns (RT11) elenca le richieste di reso. Dove Super-Pharm lascia decidere al negozio, super_pharm_accept_return accetta o rifiuta una in WAITING_ACCEPTANCE e super_pharm_receive_return conferma che la merce è arrivata. I rimborsi rimangono nel back office.
Messaggi: super_pharm_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), super_pharm_get_thread legge una con i suoi messaggi, super_pharm_reply_thread risponde (destinatario CUSTOMER o OPERATOR, che è Super-Pharm) e super_pharm_create_order_thread apre una nuova conversazione su un ordine. I codici di motivo per gli argomenti provengono da super_pharm_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: super_pharm_list_invoices (IV01) elenca i documenti contabili che Super-Pharm emette al negozio e super_pharm_list_transactions (TL02) le righe delle transazioni (vendite, commissioni, rimborsi, pagamenti). Se Super-Pharm utilizza la Fatturazione Venditore Avanzata, IV01 non restituisce nuovi documenti; utilizza super_pharm_list_document_requests (DR11) e le transazioni poi.
Intero catalogo: per leggere ogni offerta (un controllo di stock o prezzo su tutto il catalogo, contando le offerte), avvia un'esportazione con super_pharm_export_offers, interroga super_pharm_get_offer_export_status circa una volta al minuto fino a quando non è COMPLETED, e leggi i file uno per uno con super_pharm_get_offer_export_file; include_fields mantiene solo le colonne di cui hai bisogno. Un'esportazione completa è consentita una volta al giorno; per ciò che è cambiato da allora, passa last_request_date (un'esportazione differenziale, al massimo una volta al minuto). Non sfogliare ogni offerta con super_pharm_list_offers: è pensato per poche offerte alla volta e risponde 429 quando sfogliato attraverso un grande catalogo.
Diversi negozi: ogni strumento prende un shop_id opzionale. Un utente che gestisce più negozi su questo marketplace (un'agenzia, o un negozio per paese) può lavorare su tutti con un'unica installazione: passa l'id del negozio in ogni chiamata e controlla quale negozio è con super_pharm_get_account e lo stesso shop_id. Senza shop_id, una chiamata utilizza SUPER_PHARM_SHOP_ID, o il negozio predefinito dell'utente quando questo è vuoto. Chiedi all'utente gli id dei loro negozi; il back office li mostra.
Liste di riferimento: super_pharm_list_channels (siti nazionali), super_pharm_list_carriers, super_pharm_list_shipping_zones, super_pharm_list_shipping_methods e super_pharm_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 Super-Pharm può inasprirli. L'elenco di offerte e ordini è pensato per un uso interattivo, importazioni di prodotti e offerte al massimo ogni 15 minuti, super_pharm_get_account e le liste di riferimento circa una volta al giorno. Un 429 porta un'intestazione Retry-After con i secondi da aspettare; 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 o che il marketplace non utilizza quella funzione, come i resi, 400 un parametro errato o un ordine nello stato sbagliato (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 Claude
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 mostriYOUR_SERVER_ID.
Percorso consigliato: funziona su claude.ai web senza modificare alcun file di configurazione.
- In Claude, apri Plugins (in alcuni piani ancora Customize) → Connectors.
- Clicca su + Add, poi Add custom connector.
- Inserisci un nome, ad esempio
Super-Pharm Marketplace, e l'URL del server MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca su Continue, mantieni le impostazioni rilevate e clicca di nuovo su Continue. - Scegli Sign in now, clicca su Add e accedi a AnythingMCP (OAuth) per consentire l'accesso.
Tutti gli strumenti qui sotto appariranno nella tua chat: inizia a digitare i prompt.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
super_pharm_get_account | Legge il negozio dietro la chiave API su questo marketplace (A01): id e nome del negozio, stato, canali, valuta, grado e tasso di approvazione, contatto… |
super_pharm_list_orders | Elenca gli ordini (OR11) con le loro righe, cliente, indirizzo di spedizione, prezzi, stato e incidenti. Filtra per stato (ad esempio WAITING_ACCEPTANCE per… |
super_pharm_list_offers | Elenca le offerte del negozio (OF21): SKU, prodotto, prezzo e sconto, tutti i prezzi dei canali, quantità in stock, condizione, tempo di consegna e se… |
super_pharm_get_offer | Legge un'offerta completa per il suo id offerta (OF22): ogni campo di prezzo, sconto, quantità, condizione, classe logistica, tempo di consegna e personal… |
super_pharm_list_offer_conditions | Elenca le condizioni dell'offerta (OF61) che il marketplace accetta, ad esempio nuovo o usato, con il codice da inserire in state_code quando si aggiornano le offerte |
super_pharm_list_offer_imports | Elenca le importazioni e aggiornamenti delle offerte (OF04), da file e da super_pharm_update_offers: stato (WAITING, RUNNING, COMPLETE, FAILED), righe… |
super_pharm_get_offer_import | Legge lo stato di un'importazione di offerta o aggiornamento offerta (OF02) per il suo import_id, come restituito da super_pharm_update_offers o… |
super_pharm_export_offers | Avvia 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… |
super_pharm_get_offer_export_status | Stato di un'esportazione di offerta avviata con super_pharm_export_offers (OF53): PENDING, COMPLETED o FAILED (con error.code e error.detail)… |
super_pharm_get_offer_export_file | Legge un file di un'esportazione di offerta completata (OF54): le offerte con il loro SKU, prodotto, quantità, prezzi e gli altri campi esportati, come… |
super_pharm_list_product_imports | Elenca le importazioni di prodotti (P51) con il loro stato (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), i conteggi delle trasformazioni e il… |
super_pharm_get_product_import | Legge lo stato di un'importazione di prodotto (P42) per il suo import_id: stato di importazione, motivo, conteggi di trasformazione e dettagli di integrazione… |
super_pharm_get_products | Cerca prodotti nel catalogo del marketplace tramite i loro identificatori (P31), ad esempio EAN, e ottieni lo SKU del prodotto del marketplace, titolo e categoria.… |
super_pharm_list_product_offers | Elenca le offerte di ogni negozio per prodotti dati (P11), ordinati per miglior prezzo, per confrontare il tuo prezzo con la concorrenza. Fornisci product_ids… |
super_pharm_list_threads | Elenca i thread di messaggi (M11) con clienti e Super-Pharm: argomento, ordine o offerta collegata, partecipanti, data dell'ultimo messaggio e da quando un… |
super_pharm_get_thread | Legge un thread di messaggi (M10) con tutti i suoi messaggi, mittenti, destinatari, allegati e l'ordine o l'offerta collegata |
super_pharm_list_returns | Elenca 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.… |
super_pharm_list_reasons | Elenca i codici di motivo del marketplace (RE01): incidente, cancellazione, rimborso e motivi di messaggio, con le loro etichette e se il negozio può… |
super_pharm_list_carriers | Elenca i corrieri conosciuti dal marketplace (SH21) con il loro codice, etichetta e URL di tracciamento. Usa il codice come carrier_code in… |
super_pharm_list_invoices | Elenca i documenti contabili che Super-Pharm emette al negozio (IV01): fatture e note di credito con periodo, totali con e senza tasse… |
super_pharm_list_transactions | Elenca le righe delle transazioni del negozio (TL02): importi degli ordini, spedizione, commissioni, rimborsi, crediti manuali e pagamenti, con importo, tipo… |
super_pharm_list_document_requests | Elenca le richieste di documenti contabili (DR11), utilizzate quando Super-Pharm esegue la Fatturazione Venditore Avanzata: fatture e note di credito che Super-Pharm… |
super_pharm_list_order_documents | Elenca i documenti allegati a uno o più ordini (OR72): note di consegna, etichette di spedizione, fatture clienti e altri file, con id, file… |
super_pharm_list_channels | Elenca i canali di vendita del marketplace (CH11), di solito uno per sito nazionale, con codice ed etichetta. Usa i codici come channel_codes in… |
super_pharm_list_shipping_zones | Elenca le zone di spedizione attive del marketplace (SH11) con codice ed etichetta, ad esempio Francia continentale o Corsica. Cambiano raramente: chiamalo… |
super_pharm_list_shipping_methods | Elenca i metodi di spedizione attivi del marketplace (SH12), ad esempio standard, espresso o ritiro, con codice, etichetta, se un numero di tracciamento… |
super_pharm_list_logistic_classes | Elenca 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… |
super_pharm_accept_order | Accetta o rifiuta le righe di un ordine in attesa di accettazione (OR21). Ogni riga dell'ordine deve essere elencata. Rifiutare una riga la annulla… |
super_pharm_update_tracking | Imposta il corriere e il numero di tracciamento di un ordine (OR23). Fornisci carrier_code da super_pharm_list_carriers, o carrier_name con carrier_url… |
super_pharm_ship_order | Conferma che un ordine in SPEDIZIONE è stato spedito (OR24); passa a SPEDITO e il cliente viene notificato. Imposta prima il tracciamento con… |
super_pharm_update_offers | Crea o aggiorna offerte, inclusi prezzo e stock (OF24). Sostituisce completamente ogni offerta: ogni campo lasciato fuori viene ripristinato (una mancante… |
super_pharm_reply_thread | Rispondi in un thread di messaggi (M12) al cliente o a Super-Pharm. Il messaggio viene consegnato immediatamente e non può essere ritirato: mostra all'utente… |
super_pharm_create_order_thread | Avvia un nuovo thread di messaggi su un ordine (OR43) con il cliente, Super-Pharm o entrambi. Il messaggio viene consegnato immediatamente: mostra all'utente il… |
super_pharm_resolve_incident | Segna l'incidente aperto su una riga d'ordine come risolto (OR64), una volta risolto il problema del cliente. reason_code deve essere un INCIDENT_CLOSE… |
super_pharm_accept_return | Accetta o rifiuta una richiesta di reso in WAITING_ACCEPTANCE (RT21). Solo quando Super-Pharm gestisce i resi nel back office del venditore e lascia… |
super_pharm_receive_return | Conferma che la merce di un reso accettato è arrivata al tuo magazzino (RT25). Il reso passa a RICEVUTO. Agisce sul marketplace live… |
super_pharm_import_products | Invia 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… |
super_pharm_import_offers | Importa un file di offerta (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 di Super-Pharm sono in attesa della mia accettazione, e quale valore hanno in ILS?"
- "Imposta il prezzo del mio SKU delle gocce di vitamina D SP-VITD-30 a 49.90 ILS e mantieni lo stock."
- "Quali ordini sono in SPEDIZIONE e non hanno ancora un numero di tracciamento?"
- "Mostra gli incidenti aperti sui miei ordini di Super-Pharm."
- "Mostra le transazioni del mese scorso: vendite, commissioni e pagamenti."
FAQ
Funziona sia con Claude Code che con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Dove posso ottenere la chiave API di Super-Pharm, e cosa succede se gestisco più negozi? Nel back office venditore di Super-Pharm: 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 vecchia. La chiave appartiene al tuo utente, non a un negozio: con più negozi su Super-Pharm, imposta SUPER_PHARM_SHOP_ID sul negozio che il connettore dovrebbe utilizzare per impostazione predefinita, oppure chiedi all'AI di passare shop_id in ogni chiamata e lavorare su tutti i tuoi negozi con un'unica installazione. Senza nessuna delle due, viene utilizzato il tuo negozio predefinito.
Chi può vendere su Super-Pharm, e quali paesi copre? Super-Pharm approva ogni venditore prima che possa elencare; i venditori mantengono il proprio stock e consegnano direttamente ai clienti in Israele, e Super-Pharm prende una commissione su ogni vendita. Il connettore copre Israele. Questo è il marketplace di shop.super-pharm.co.il in Israele; il sito polacco di Super-Pharm non accetta venditori di marketplace.
Può controllare il mio intero catalogo, e può annullare ordini, rimborsare o eliminare offerte? Sì al catalogo: per un controllo di stock o prezzo su ogni offerta, l'AI avvia un'esportazione con super_pharm_export_offers, aspetta fino a quando super_pharm_get_offer_export_status riporta che è completa e legge i file con super_pharm_get_offer_export_file (un'esportazione completa una volta al giorno, cambiamenti da una data una volta al minuto). Nessuno strumento rimborsa o annulla un ordine; fallo nel back office di Super-Pharm. Rifiutare una riga quando si accetta un ordine la annulla definitivamente, quindi l'AI ti mostra ogni scrittura e aspetta un sì. super_pharm_import_offers è installato spento, perché la sua modalità REPLACE elimina ogni offerta che è mancante dal file; accendilo nella pagina del connettore solo se l'AI dovrebbe usarlo.
Prossimi passi
- Pagina di atterraggio del connettore
- Collegati a ChatGPT
- Collegati a Cursor
- Collegati a Gemini
- Collegati a Meta Muse
- Collegati a Microsoft Copilot
Questa guida ti è stata utile?