Guida al connettore8 minuti di lettura9 tool MCP7 lingue

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.

HCA cura del team HelpCodeAggiornato 8 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 Microsoft Copilot in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Spartoo Marketplace con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. 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.

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 + 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.

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 Microsoft Copilot

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.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

  1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
  2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
  3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
  4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
  5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Spartoo Marketplace.
  6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

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

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.

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

Questa guida ti è stata utile?

Collega Spartoo Marketplace a Microsoft Copilot in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Spartoo Marketplace con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. 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 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.

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.