In breve
Gestisci il tuo negozio sul marketplace Roman 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 Roman.
Configurazione guidata
Collega Roman Marketplace a Claude in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Roman 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 Roman 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 → Roman Marketplace, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Roman Marketplace + Claude
Gestisci il tuo negozio sul marketplace Roman 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 Roman.
Prerequisiti
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:
ROMAN_ORIGINALS_API_KEY
Passo 1 — Ottieni le credenziali
Paesi: Regno Unito. I prodotti dei venditori del marketplace vengono consegnati solo agli indirizzi nel Regno Unito, comprese Irlanda del Nord, Isole del Canale e Isola di Man.
Chi può vendere: Roman seleziona i suoi venditori tramite un modulo di richiesta sulla sua pagina venditore, che chiede, tra le altre cose, se l'azienda spedisce i propri ordini dal Regno Unito. Il connettore ha bisogno di un account venditore che Roman ha già aperto.
La configurazione richiede circa 5 minuti.
- Accedi al back office venditore Roman:
https://romanoriginalsuk-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
ROMAN_ORIGINALS_API_KEY. La chiave viene inviata così com'è nell'intestazioneAuthorization, senzaBearer. Generare una nuova chiave invalida quella precedente, quindi qualsiasi altro strumento che la utilizza smette di funzionare. - Lascia
ROMAN_ORIGINALS_SHOP_IDvuoto. Solo se il tuo utente gestisce più negozi su Roman, impostaROMAN_ORIGINALS_SHOP_IDsull'id numerico del negozio su cui questo connettore dovrebbe funzionare (mostrato sulla dashboard del back office accanto a Identifier o Shop ID, e restituito comeshop_iddaroman_originals_get_account). Senza di esso, viene utilizzato il tuo negozio predefinito. - Installa ed esegui
roman_originals_get_account: restituisce il negozio a cui appartiene la chiave.
Da dove iniziare: roman_originals_get_account mostra il negozio dietro la chiave (id, nome, stato, valuta e canali). Per il lavoro quotidiano usa roman_originals_list_orders con order_state_codes=WAITING_ACCEPTANCE, roman_originals_list_offers per prezzi e stock e roman_originals_list_threads per messaggi in attesa di risposta.
Prodotti e offerte concorrenti: roman_originals_get_products cerca i prodotti nel catalogo Roman per EAN o un altro riferimento e restituisce lo SKU del prodotto del marketplace; roman_originals_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. roman_originals_accept_order accetta (o rifiuta) ogni riga; dopo che il cliente è stato addebitato, l'ordine passa a SHIPPING. Poi roman_originals_update_tracking memorizza il corriere e il numero di tracciamento (i codici dei corrieri provengono da roman_originals_list_carriers) e roman_originals_ship_order conferma la spedizione (SHIPPED). Gli stati successivi sono TO_COLLECT, RECEIVED, CLOSED, REFUSED e CANCELED. Usa roman_originals_list_orders con order_state_codes=WAITING_ACCEPTANCE per la lista delle cose da fare quotidiana e has_incident=true per incidenti aperti; roman_originals_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 roman_originals_list_order_documents.
Scritture: conferma prima. roman_originals_accept_order, roman_originals_update_tracking, roman_originals_ship_order, roman_originals_resolve_incident, roman_originals_accept_return, roman_originals_receive_return, roman_originals_update_offers, roman_originals_reply_thread, roman_originals_create_order_thread e roman_originals_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 il nuovo prezzo o stock, il testo del messaggio e i destinatari) e attendi un sì. Rifiutare una riga d'ordine la annulla definitivamente. Nessuno strumento qui rimborsa, annulla ordini o sposta denaro; fallo nel back office. roman_originals_import_offers può eliminare offerte (la modalità REPLACE elimina ogni offerta mancante dal file), quindi è installato disattivato.
Aggiornamento delle offerte (prezzi e stock): roman_originals_update_offers (OF24) sostituisce l'intera offerta. Ogni campo che lasci fuori viene ripristinato: una quantity mancante diventa 0, uno sconto o una descrizione mancanti vengono eliminati. Leggi sempre prima l'offerta (roman_originals_get_offer o roman_originals_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 roman_originals_get_offer_import prima di leggere di nuovo l'offerta. I codici di condizione per state_code provengono da roman_originals_list_offer_conditions, i codici di classe logistica da roman_originals_list_logistic_classes.
Importazioni di file: roman_originals_import_products (P41) e roman_originals_import_offers (OF01) prendono l'URL di un file CSV, XLSX o XML nel formato richiesto da Roman; il connettore lo scarica e lo carica su Roman. Tracciali con roman_originals_list_product_imports / roman_originals_get_product_import e roman_originals_list_offer_imports / roman_originals_get_offer_import.
Resi: roman_originals_list_returns (RT11) elenca le richieste di reso. Dove Roman lascia decidere al negozio, roman_originals_accept_return accetta o rifiuta una in WAITING_ACCEPTANCE e roman_originals_receive_return conferma che la merce è arrivata. I rimborsi rimangono nel back office.
Messaggi: roman_originals_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), roman_originals_get_thread legge una con i suoi messaggi, roman_originals_reply_thread risponde (destinatario CUSTOMER o OPERATOR, che è Roman) e roman_originals_create_order_thread apre una nuova conversazione su un ordine. I codici di ragione per gli argomenti provengono da roman_originals_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: roman_originals_list_invoices (IV01) elenca i documenti contabili che Roman emette al negozio e roman_originals_list_transactions (TL02) le righe di transazione (vendite, commissioni, rimborsi, pagamenti). Se Roman utilizza la Fatturazione Venditore Avanzata, IV01 non restituisce nuovi documenti; usa roman_originals_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 roman_originals_export_offers, controlla roman_originals_get_offer_export_status circa una volta al minuto fino a quando non è COMPLETED, e leggi i file uno per uno con roman_originals_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 roman_originals_list_offers: è pensato per poche offerte alla volta e risponde 429 quando sfogliato attraverso un grande catalogo.
Più 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 roman_originals_get_account e lo stesso shop_id. Senza shop_id, una chiamata utilizza ROMAN_ORIGINALS_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: roman_originals_list_channels (siti nazionali), roman_originals_list_carriers, roman_originals_list_shipping_zones, roman_originals_list_shipping_methods e roman_originals_list_logistic_classes cambiano raramente; leggili una volta per conversazione.
Paginazione: ordini, offerte, fatture e importazioni di prodotti si 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 es. 2026-10-01T00:00:00Z; le risposte sono in UTC.
Limiti di frequenza: Ogni API ha il proprio limite e Roman può inasprirli. L'elenco delle offerte e degli ordini è destinato a un uso interattivo, le importazioni di prodotti e offerte al massimo ogni 15 minuti, roman_originals_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 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 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 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 su Add custom connector.
- Inserisci un nome, ad es.
Roman 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 |
|---|---|
roman_originals_get_account | Leggi il negozio dietro la chiave API su questo marketplace (A01): id e nome del negozio, stato, canali, valuta, grado e tasso di approvazione, contatto… |
roman_originals_list_orders | Elenca gli ordini (OR11) con le loro righe, cliente, indirizzo di spedizione, prezzi, stato e incidenti. Filtra per stato (ad es. WAITING_ACCEPTANCE per… |
roman_originals_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… |
roman_originals_get_offer | Leggi un'offerta completa per il suo id offerta (OF22): ogni campo di prezzo, sconto, quantità, condizione, classe logistica, tempo di consegna e personal… |
roman_originals_list_offer_conditions | Elenca 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 |
roman_originals_list_offer_imports | Elenca le importazioni e aggiornamenti delle offerte (OF04), da file e da roman_originals_update_offers: stato (WAITING, RUNNING, COMPLETE, FAILED)… |
roman_originals_get_offer_import | Leggi lo stato di un'importazione di offerta o aggiornamento offerta (OF02) per il suo import_id, come restituito da roman_originals_update_offers o… |
roman_originals_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… |
roman_originals_get_offer_export_status | Stato di un'esportazione di offerta avviata con roman_originals_export_offers (OF53): PENDING, COMPLETED o FAILED (con error.code e… |
roman_originals_get_offer_export_file | Leggi un file di un'esportazione di offerta completata (OF54): le offerte con il loro SKU, prodotto, quantità, prezzi e gli altri campi esportati, come… |
roman_originals_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… |
roman_originals_get_product_import | Leggi lo stato di un'importazione di prodotto (P42) per il suo import_id: stato di importazione, motivo, conteggi delle trasformazioni e i dettagli di integrazione… |
roman_originals_get_products | Cerca prodotti nel catalogo del marketplace per i loro identificatori (P31), ad es. EAN, e ottieni lo SKU del prodotto del marketplace, titolo e categoria.… |
roman_originals_list_product_offers | Elenca le offerte di ogni negozio per i prodotti dati (P11), ordinati per miglior prezzo, per confrontare il tuo prezzo con la concorrenza. Fornisci product_ids… |
roman_originals_list_threads | Elenca i thread di messaggi (M11) con clienti e Roman: argomento, ordine o offerta collegata, partecipanti, data dell'ultimo messaggio e da quando un negozio… |
roman_originals_get_thread | Leggi un thread di messaggi (M10) con tutti i suoi messaggi, mittenti, destinatari, allegati e l'ordine o l'offerta collegata |
roman_originals_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.… |
roman_originals_list_reasons | Elenca i codici di ragione del marketplace (RE01): incidente, cancellazione, rimborso e motivi di messaggio, con le loro etichette e se il negozio può… |
roman_originals_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… |
roman_originals_list_invoices | Elenca i documenti contabili che Roman emette al negozio (IV01): fatture e note di credito con periodo, totali con e senza tasse… |
roman_originals_list_transactions | Elenca le righe di transazione del negozio (TL02): importi degli ordini, spedizione, commissioni, rimborsi, crediti manuali e pagamenti, con importo, tipo… |
roman_originals_list_document_requests | Elenca le richieste di documenti contabili (DR11), utilizzate quando Roman esegue la Fatturazione Venditore Avanzata: fatture e note di credito che Roman o il negozio… |
roman_originals_list_order_documents | Elenca i documenti allegati a uno o più ordini (OR72): bolle di consegna, etichette di spedizione, fatture clienti e altri file, con id, file… |
roman_originals_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… |
roman_originals_list_shipping_zones | Elenca le zone di spedizione attive del marketplace (SH11) con codice ed etichetta, ad es. Francia continentale o Corsica. Cambiano raramente: chiamalo… |
roman_originals_list_shipping_methods | Elenca i metodi di spedizione attivi del marketplace (SH12), ad es. standard, espresso o ritiro, con codice, etichetta, se un numero di tracciamento… |
roman_originals_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… |
roman_originals_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… |
roman_originals_update_tracking | Imposta il corriere e il numero di tracciamento di un ordine (OR23). Fornisci carrier_code da roman_originals_list_carriers, o carrier_name con… |
roman_originals_ship_order | Conferma che un ordine in SPEDIZIONE è stato spedito (OR24); passa a SPEDITO e il cliente viene notificato. Imposta prima il tracciamento con… |
roman_originals_update_offers | Crea o aggiorna offerte, inclusi prezzo e stock (OF24). Sostituisce completamente ogni offerta: ogni campo lasciato fuori viene ripristinato (una mancante… |
roman_originals_reply_thread | Rispondi in un thread di messaggi (M12) al cliente o a Roman. Il messaggio viene consegnato immediatamente e non può essere ritirato: mostra all'utente il testo… |
roman_originals_create_order_thread | Avvia un nuovo thread di messaggi su un ordine (OR43) con il cliente, Roman o entrambi. Il messaggio viene consegnato immediatamente: mostra all'utente il testo… |
roman_originals_resolve_incident | Segna 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… |
roman_originals_accept_return | Accetta o rifiuta una richiesta di reso in WAITING_ACCEPTANCE (RT21). Solo quando Roman gestisce i resi nel back office venditore e lascia il… |
roman_originals_receive_return | Conferma che la merce di un reso accettato è arrivata al tuo magazzino (RT25). Il reso passa a RICEVUTO. Agisce sul marketplace attivo… |
roman_originals_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… |
roman_originals_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 Roman sono in attesa della mia accettazione?"
- "Imposta lo stock del mio vestito midi in lino SKU LMD-NAVY-12 a 25 e mantieni il prezzo."
- "Esporta le mie offerte su Roman e mostra ogni SKU che è esaurito."
- "Aggiungi il tracciamento Royal Mail AB123456789GB all'ordine 5531207-A e conferma la spedizione."
- "Quali richieste di reso sono in attesa della mia decisione e quali messaggi dei clienti necessitano ancora di una risposta?"
FAQ
Funziona con Claude Code così come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Dove posso ottenere la chiave API Roman e cosa succede se gestisco più negozi? Nel back office venditore Roman: 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. La chiave appartiene al tuo utente, non a un negozio: con più negozi su Roman, imposta ROMAN_ORIGINALS_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 Roman e quali paesi copre? Roman è il rivenditore di moda del Regno Unito precedentemente chiamato Roman Originals; il suo marketplace aggiunge prodotti da altri venditori a roman.co.uk. Roman seleziona i suoi venditori tramite un modulo di richiesta sulla sua pagina venditore, che chiede, tra le altre cose, se l'azienda spedisce i propri ordini dal Regno Unito. Il connettore copre il Regno Unito. I prodotti dei venditori del marketplace vengono consegnati solo agli indirizzi nel Regno Unito, comprese Irlanda del Nord, Isole del Canale e Isola di Man.
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 roman_originals_export_offers, attende fino a quando roman_originals_get_offer_export_status riporta che è completata e legge i file con roman_originals_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 Roman. Rifiutare una riga quando si accetta un ordine la annulla definitivamente, quindi l'AI ti mostra ogni scrittura e attende un sì. roman_originals_import_offers è installato disattivato, perché la sua modalità REPLACE elimina ogni offerta mancante dal file; attivalo 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?