In breve
Servizi web del marketplace Spartoo per i venditori: ordini con dettagli del cliente e di consegna, accettazione e spedizione degli ordini con un numero di tracciamento, resi, stato di un prodotto sul sito e aggiornamenti di stock per taglia. Codice partner come campo del modulo, risposte XML lette come JSON.
Configurazione guidata
Collega Spartoo Marketplace a Meta Muse in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Spartoo Marketplace con la configurazione guidata e aggiungi il tuo URL MCP a Meta Muse. 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 Spartoo 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 Connettori → Spartoo Marketplace, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Spartoo Marketplace + Meta Muse
Servizi web del marketplace Spartoo per i venditori: ordini con dettagli del cliente e di consegna, accettazione e spedizione degli ordini con un numero di tracciamento, resi, stato di un prodotto sul sito e aggiornamenti di stock per taglia. Codice partner come campo del modulo, risposte XML lette come JSON.
Prerequisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nel negozio dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
SPARTOO_HOST, SPARTOO_PARTNER_KEY
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 3 minuti.
- Accedi al back office del marketplace Spartoo e apri Documentazione, poi Webservices e qualsiasi pagina di servizio, ad esempio Esportazione ordini.
- La riga Webservice URL indica l'indirizzo del servizio web del tuo sito Spartoo, ad esempio
https://sws.spartoo.euohttps://sws.spartoo.it. Metti la parte prima di/mp/inSPARTOO_HOST. - Nella stessa pagina la riga
partnermostra il tuo codice unico quando sei connesso. Mettilo inSPARTOO_PARTNER_KEY. Se la pagina non mostra alcun codice, chiedi al tuo contatto del marketplace Spartoo il codice del servizio web del tuo account.
Dove iniziare: spartoo_list_orders con una data di inizio. spartoo_get_order legge un ordine per il suo id.
Ordini: un ordine arriva in stato 11 (verificato). spartoo_accept_order lo sposta a 2 (in preparazione): dopo di che il suo nome, indirizzo e corriere non possono più cambiare. spartoo_ship_order lo sposta da 2 a 3 (spedito) con il numero di tracciamento del corriere, e Spartoo invia il link di tracciamento al cliente. spartoo_cancel_order (stato 41) è installato disattivato: il cliente viene rimborsato e non può essere annullato. Gli stati 45 (pacco perso) e 47 (pacco non consegnato) sono impostati da Spartoo.
Resi: spartoo_list_returns e spartoo_get_return. Un reso contiene un prodotto. Stati di reso: 2 in attesa di ricezione, 3 rifiutato, 4 pacco ricevuto e reso accettato, 5 pagato, 7 rimborso, 14 in attesa dell'etichetta di reso prepagata del commerciante. Questo connettore non accetta né rifiuta resi.
Prodotti e stock: spartoo_check_product_status indica se un prodotto è sul sito (OK), esaurito (OS), creato ma non ancora online (EC) o sconosciuto (KO), con il motivo. spartoo_update_stock imposta lo stock di una taglia. Entrambi usano i tuoi riferimenti: reference_partenaire è il prodotto in un colore, size_reference una taglia di esso. Stock 0 rimuove la taglia dal sito.
Note sui campi
- Gli id degli ordini e dei resi sono codici brevi come
90D813EA1A2365A8. - Il filtro della data dell'ordine è scritto
YYYY-MM-DD:hh:mm:sscon un due punti tra giorno e ora. Il filtro della data di reso è un timestamp Unix in secondi. Spartoo non documenta il fuso orario. - I prezzi sono numeri decimali nella valuta del sito dell'ordine;
products_final_priceè il prezzo unitario scontato moltiplicato per la quantità. - Un ordine per un punto di ritiro ha
relay_infoinvece dell'indirizzo di consegna. - I valori di testo arrivano come stringhe, numeri inclusi. Un ordine o prodotto in una lista arriva come un oggetto, diversi come un array.
Errori: ogni risposta porta un codice. 1 significa nessun errore. -1 e -2: il codice partner è mancante o sconosciuto. -3: data o id mancante. -4: formato data errato. -6 e -28: ordine o reso non trovato. -8: numero di tracciamento rifiutato. -9: l'ordine ha già quello stato. -19: ordine errato degli stati (2 solo da 11, 3 solo da 2). -14: prodotto non trovato. -16, -18 e -20: stock non cambiato (non possibile, già quel valore, o la taglia non è più valida). -30: ordine troppo vecchio per essere spedito, contatta Spartoo. -428: account disattivato. -429: troppe richieste in un'ora. Il connettore riporta un codice negativo come una chiamata fallita.
Non coperto: creazione e modifica di prodotti, prezzi e sconti (passano attraverso un file di catalogo XML), bolle di accompagnamento e decisioni sui resi.
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 Muse
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 mostraYOUR_SERVER_ID.
Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.
- In Muse apri Settings → Connectors e scegli Add custom connector.
- Incolla l'URL del server MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
- In una chat, chiedi a Muse qualcosa che richiede i tool di
Spartoo Marketplace.
Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
spartoo_list_orders | Elenca gli ordini effettuati da una data, eventualmente solo quelli in uno stato. Per ordine sotto root.orders.order: orders_id, clienti… |
spartoo_get_order | Leggi un ordine per il suo id: dettagli del cliente e di consegna (o il punto di ritiro in relay_info), metodo di pagamento, nome e prezzo della spedizione, ordine… |
spartoo_accept_order | Accetta un nuovo ordine: lo sposta dallo stato 11 (verificato) a 2 (in preparazione). Dopo di che il nome dell'ordine, indirizzo di consegna e corriere possono… |
spartoo_ship_order | Segna un ordine accettato come spedito con il numero di tracciamento del corriere: lo sposta dallo stato 2 a 3, e Spartoo invia il link di tracciamento al… |
spartoo_cancel_order | Annulla un ordine che non è stato spedito (stato 41). Il cliente non riceve l'ordine e viene rimborsato da Spartoo; non può essere annullato… |
spartoo_list_returns | Elenca i resi registrati da un momento, eventualmente solo quelli in uno stato. Per reso sotto root.returns.return: return_id… |
spartoo_get_return | Leggi i resi di un ordine, o un reso per il suo id: id del reso e data, id e nome dello stato, motivo, id dell'ordine e il prodotto restituito… |
spartoo_check_product_status | Controlla se uno dei tuoi prodotti è sul sito Spartoo. Restituisce sotto root.products.product il tuo riferimento, uno stato (OK sul sito… |
spartoo_update_stock | Imposta lo stock di una taglia di un prodotto, in tempo reale. Stock 0 rimuove quella taglia dal sito; un prodotto le cui taglie sono tutte 0 va offline.… |
Esempi di prompt
- "Quali ordini Spartoo sono arrivati da lunedì e devono ancora essere accettati?"
- "Accetta l'ordine 90D813EA1A2365A8 e spediscilo con il tracciamento Royal Mail AB123456789GB."
- "Quali resi sono in attesa di ricezione?"
- "Il mio prodotto REF-BOOT-221 è online, e se non lo è, perché?"
- "Imposta lo stock della taglia 38 di REF-BOOT-221 a 6."
FAQ
Da dove proviene il codice partner? Nel back office del marketplace Spartoo, Documentazione, Webservices, qualsiasi pagina di servizio: la riga partner mostra il tuo codice e la riga Webservice URL indica l'indirizzo del tuo sito. Se non viene mostrato alcun codice, chiedi al tuo contatto del marketplace Spartoo.
Cosa copre e cosa no? Ordini con dettagli del cliente e di consegna, accettazione e spedizione con un numero di tracciamento, resi, stato del prodotto e stock per taglia. Non accetta né rifiuta resi. Per cercare il catalogo Spartoo come acquirente, usa il connettore Spartoo Shop.
Quali strumenti sono installati disattivati? spartoo_cancel_order, perché una cancellazione rimborsa il cliente e non può essere annullata. Attivalo solo nella pagina del connettore se l'AI deve usarlo.
Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.
Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.
Prossimi passi
Questa guida ti è stata utile?