Guida al connettore6 minuti di lettura9 tool MCP7 lingue

Spartoo Marketplace MCP con Claude

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.

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

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

Spartoo Marketplace

Spartoo Marketplace

Spartoo marketplace web services for sellers: orders with customer and delivery details, accepting and shipping orders with a tracking number, returns, the status of a product on the site and stock updates per size. Partner code as a form field, XML answers read as JSON.

tool

9

Regione

INTL

Categoria

E-commerce

Autenticazione

API credentials

Env vars richieste

SPARTOO_HOSTSPARTOO_PARTNER_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

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 Claude in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Spartoo 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 Spartoo Marketplace

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

Spartoo 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 → Spartoo Marketplace, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Spartoo Marketplace + Claude

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.

  1. Accedi al back office del marketplace Spartoo e apri Documentazione, poi Webservices e qualsiasi pagina di servizio, ad esempio Esportazione ordini.
  2. La riga Webservice URL indica l'indirizzo del servizio web del tuo sito Spartoo, ad esempio https://sws.spartoo.eu o https://sws.spartoo.it. Metti la parte prima di /mp/ in SPARTOO_HOST.
  3. Nella stessa pagina la riga partner mostra il tuo codice unico quando sei connesso. Mettilo in SPARTOO_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:ss con 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_info invece 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 Claude

L'URL del tuo server: in AnythingMCP, apri Server MCP → il server su cui si trova questo connettore, e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostri YOUR_SERVER_ID.

Percorso consigliato: funziona su claude.ai web senza modificare alcun file di configurazione.

  1. In Claude, apri Plugins (in alcuni piani ancora Customize) → Connectors.
  2. Clicca su + Add, poi Add custom connector.
  3. Inserisci un nome, ad esempio Spartoo Marketplace, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca su Continue, mantieni le impostazioni rilevate e clicca di nuovo su Continue.
  4. 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

StrumentoCosa fa
spartoo_list_ordersElenca gli ordini effettuati da una data, eventualmente solo quelli in uno stato. Per ordine sotto root.orders.order: orders_id, clienti…
spartoo_get_orderLeggi 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_orderAccetta 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_orderSegna 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_orderAnnulla 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_returnsElenca i resi registrati da un momento, eventualmente solo quelli in uno stato. Per reso sotto root.returns.return: return_id…
spartoo_get_returnLeggi 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_statusControlla se uno dei tuoi prodotti è sul sito Spartoo. Restituisce sotto root.products.product il tuo riferimento, uno stato (OK sul sito…
spartoo_update_stockImposta 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

Funziona sia con Claude Code che con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

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.

Prossimi passi

Questa guida ti è stata utile?

Collega Spartoo Marketplace a Claude in 2 minuti

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

Guide correlate

Connettori

Spartoo Marketplace MCP con ChatGPT

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.

Connettori

Spartoo Marketplace MCP con Microsoft Copilot

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.

Connettori

Spartoo Marketplace MCP con Cursor

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.

Connettori

Spartoo Marketplace MCP con Gemini CLI

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.

Connettori

Spartoo Marketplace MCP con 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.

Connettori

Spartoo Marketplace MCP: ordini e scorte

Servizi web del marketplace Spartoo per i venditori: ordini con dettagli del cliente e della 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.