Guida al connettore12 minuti di lettura27 tool MCP7 lingue

Skroutz MCP con Microsoft Copilot

API di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

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

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

Skroutz

Skroutz

Skroutz Marketplace (Smart Cart) API for sellers on the Greek and Cypriot marketplace: read, accept and schedule orders, Set as Ready, tracking, invoice uploads, returns, Fulfilled by Skroutz stock, purchase orders and suppliers, bulk price and stock updates and CPS orders. API token from the merchants panel.

tool

27

Regione

INTL

Categoria

E-commerce

Autenticazione

API credentials

Env vars richieste

SKROUTZ_API_TOKEN
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

API di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

Configurazione guidata

Collega Skroutz a Microsoft Copilot in 2 minuti

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

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

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

Skroutz + Microsoft Copilot

API di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

Prerequisiti

Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nel negozio in-app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:

SKROUTZ_API_TOKEN

Passo 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti.

  1. Accedi al pannello dei commercianti di Skroutz e apri Servizi, Skroutz Marketplace (la pagina delle impostazioni di Smart Cart).
  2. Genera il token API e incollalo in SKROUTZ_API_TOKEN. Un negozio ha un token attivo: generare un nuovo token termina il precedente, quindi un token utilizzato da un'altra integrazione smette di funzionare lì.
  3. Facoltativo, per aggiornamenti di prezzo e stock in blocco: in Prodotti, Aggiornamenti Feed genera il token API Prodotti e incollalo in SKROUTZ_PRODUCTS_TOKEN.
  4. Facoltativo, per ordini CPS del tuo negozio online: in Παραγγελίες καταστήματος, Αυτόματη διαχείριση (ordini del negozio, gestione automatica) genera il token CPS e incollalo in SKROUTZ_CPS_TOKEN.

Ogni chiamata invia il token come Authorization: Bearer con il tipo di media application/vnd.skroutz+json; version=3.0. Il controllo di installazione legge l'ordine demo DEMO-OPEN, che prova il token del marketplace senza toccare dati reali.

Dove iniziare: l'API non ha una lista di ordini. Gli ordini raggiungono un negozio tramite il webhook degli ordini, il pannello dei commercianti e le email degli ordini, quindi chiedi all'utente il codice dell'ordine (come 191128-1234567) e leggilo con skroutz_get_order. I codici demo DEMO-OPEN, DEMO-ACCEPTED, DEMO-REJECTED, DEMO-INVOICE, DEMO-FBS, DEMO-STORE-PICKUP e DEMO-RETURN sono sicuri da leggere, accettare e rifiutare per testare: nulla viene memorizzato.

Ordini: un ordine aperto porta accept_options e reject_options e deve essere gestito prima di expires_at. Accettalo con skroutz_accept_order, inviando un id della posizione di ritiro e l'id di una delle finestre di ritiro di quella posizione (le finestre differiscono per posizione). Skroutz poi prenota il corriere e il PDF del voucher appare in courier_voucher. Gli ordini espressi vengono accettati automaticamente da Skroutz. skroutz_reject_order è installato disattivato: un rifiuto non può essere annullato e conta contro il negozio. Per cambiare il ritiro di un ordine accettato, leggilo con action_options 1 subito prima e usa skroutz_reschedule_order_pickup (una data da reschedule_options) o skroutz_relocate_order_pickup (un id da relocate_options); le liste si riducono nel tempo. skroutz_request_preorder_voucher crea il voucher di un preorder accettato in anticipo.

Imposta come Pronto: quando un ordine mostra set_as_ready_required vero, Skroutz Last Mile lo ritira solo dopo skroutz_set_order_ready; scaricare il voucher non lo segna più come pronto (dal 30 marzo 2026). Segnare in anticipo può spostare il ritiro a una finestra precedente. skroutz_set_order_not_ready annulla prima del ritiro. I negozi con set_as_ready_required falso non ne hanno bisogno.

Spedizione e documenti: skroutz_update_tracking_details invia il corriere e il codice di tracciamento per gli ordini Fulfilled by Merchant (FBM) solo. skroutz_upload_invoice e skroutz_upload_credit_invoice prendono un link pubblico al PDF, PNG o JPG (massimo 7 MB); il connettore lo scarica e carica il file, uno per ordine, sostituendo un caricamento precedente.

Resi: skroutz_get_return legge un reso tramite il suo codice (come R-111111-1111111, dal webhook dei resi o dal pannello dei commercianti; i returns di un ordine forniscono solo un uuid e id di tracciamento). skroutz_handle_return (decidi un reso in attesa di revisione prima di review.expires_at, inclusa l'invio di una parte mancante a spese del negozio) e skroutz_submit_service_inspection (rapporto tecnico su un articolo difettoso, come link a un file) sono installati disattivati, perché portano a rimborsi, sostituzioni o spedizioni a pagamento. skroutz_file_compensation_request è disattivato anch'esso: richiede denaro a Skroutz per articoli restituiti, e tramite questo connettore solo per motivi che non necessitano foto.

Fulfilled by Skroutz: skroutz_list_fbs_products (stock nei magazzini Skroutz), skroutz_list_fbs_purchase_orders, skroutz_list_fbs_purchase_order_items, skroutz_list_fbs_suppliers, skroutz_create_fbs_supplier e skroutz_update_fbs_supplier. skroutz_create_fbs_purchase_order è disattivato, perché le spese di magazzino derivano da esso. Le liste sono paginate con page e vengono con meta.pagination (100 righe a pagina). Un negozio senza FBS riceve 401 qui.

API Prodotti (richiede SKROUTZ_PRODUCTS_TOKEN): skroutz_validate_product_updates controlla un lotto senza cambiare nulla; skroutz_update_products (disattivato) aggiorna disponibilità, prezzo e quantità di fino a 500 prodotti esistenti e variazioni, in modo asincrono; skroutz_get_product_update_status riporta successo, no_change o fallimento per prodotto. I prezzi qui sono centesimi di euro interi (1050 è 10,50 EUR), mentre gli importi degli ordini sono in euro decimali. Non crea prodotti: quelli provengono dal feed XML. Un 422 che dice che l'XML è in fase di scansione significa riprovare più tardi.

Ordini CPS (richiede SKROUTZ_CPS_TOKEN): skroutz_get_cps_order legge una vendita del tuo negozio online tramite il tuo numero d'ordine, con ricavi e commissioni; skroutz_reject_cps_order (disattivato) lo rifiuta in modo che non venga addebitata alcuna commissione.

Note di campo: i tempi sono ISO 8601 con il fuso orario di Atene (+02:00 in inverno, +03:00 in estate). Etichette come finestre di ritiro, motivi di rifiuto e stati CPS sono in greco. Gli id degli articoli sono stringhe brevi (l39vKqxqwe); shop_uid è il tuo id prodotto. Gli errori portano un array errors con un code e messages: 422 order_status significa che l'ordine non è in uno stato per quell'azione. Un token marketplace errato o sostituito risponde 403. Il connettore non gestisce mai denaro: rifiuti, decisioni sui resi, richieste di risarcimento, ordini di acquisto e aggiornamenti di prodotto in blocco sono installati disattivati affinché un admin possa attivarli deliberatamente.

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 Skroutz.
  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
skroutz_get_orderLeggi un ordine di Skroutz Marketplace (Smart Cart) tramite il suo codice: stato (aperto, accettato, rifiutato, annullato, scaduto, spedito, consegnato…
skroutz_accept_orderAccetta un ordine aperto: Skroutz poi prenota il corriere e emette il voucher (arriva sull'ordine come courier_voucher). Invia un…
skroutz_reject_orderRifiuta un ordine aperto, sia per articolo con un id di motivo da reject_options (con available_quantity quando il motivo ha…
skroutz_reschedule_order_pickupSposta il ritiro del corriere di un ordine accettato a un'altra data. Leggi l'ordine con action_options 1 subito prima e invia uno dei suoi…
skroutz_relocate_order_pickupSposta il ritiro del corriere di un ordine accettato a un'altra delle posizioni di ritiro del negozio, mantenendo la data e la fascia oraria di ritiro. Il corriere è…
skroutz_set_order_readySegna un ordine accettato come imballato e pronto per la spedizione (Imposta come Pronto). Richiesto per i negozi i cui ordini mostrano set_as_ready_required vero…
skroutz_set_order_not_readyAnnulla Imposta come Pronto su un ordine accettato che il corriere non ha ancora ritirato. Skroutz cerca di spostare il ritiro alla data originale.…
skroutz_update_tracking_detailsInvia il corriere e il codice di tracciamento di ciascuna spedizione di un ordine Fulfilled by Merchant (FBM), in modo che il cliente possa seguirlo. Solo per FBM…
skroutz_request_preorder_voucherRichiedi ora il voucher del corriere di un preorder accettato, quando il prodotto è arrivato prima della data di spedizione pianificata (il pannello Crea…
skroutz_upload_invoiceCarica la ricevuta o la fattura di un ordine da un link al file (PDF, PNG o JPG, massimo 7 MB). Un file per ordine: un nuovo caricamento…
skroutz_upload_credit_invoiceCarica la fattura di credito di un ordine che è stato annullato, restituito, parzialmente restituito o restituito al mittente dopo la sua ricevuta o fattura…
skroutz_file_compensation_requestChiedi a Skroutz di risarcire il negozio per articoli restituiti, inviati come JSON senza foto, quindi solo per motivi che non necessitano…
skroutz_get_returnLeggi un reso tramite il suo codice: stato (in attesa di revisione del commerciante, in restituzione, in attesa di revisione fisica, in attesa di ispezione del servizio, restituito…
skroutz_handle_returnDecidi un reso in stato di attesa di revisione del commerciante con una delle sue handle_options: approva, un rifiuto come non difettoso (con commento quando…
skroutz_submit_service_inspectionInvia il risultato dell'ispezione tecnica di un articolo restituito difettoso (reso in stato di attesa di ispezione del servizio): l'id dell'articolo, uno dei suoi…
skroutz_list_fbs_productsElenca i prodotti Fulfilled by Skroutz (FBS) del negozio memorizzati nei magazzini Skroutz: id, shop_uid (il tuo id prodotto), attivo (acquistabile dal…
skroutz_list_fbs_purchase_ordersElenca gli ordini di acquisto Fulfilled by Skroutz del negozio (stock inviato ai magazzini Skroutz): codice, created_at, expected_date e received_at.…
skroutz_list_fbs_purchase_order_itemsElenca gli articoli di un ordine di acquisto Fulfilled by Skroutz: product_id, shop_uid, attivo, expected_quantity e actual_quantity…
skroutz_create_fbs_purchase_orderAnnuncia un nuovo ordine di acquisto Fulfilled by Skroutz: lo stock che consegnerai a un magazzino Skroutz, con la data prevista, il fornitore…
skroutz_list_fbs_suppliersElenca i fornitori Fulfilled by Skroutz del negozio: id (usalo per ordini di acquisto), codice, nome, indirizzo, città, area, codice_postale, telefono…
skroutz_create_fbs_supplierAggiungi un fornitore Fulfilled by Skroutz (che spedisce stock al magazzino Skroutz per te) con un codice unico, nome, indirizzo, città, area, codice…
skroutz_update_fbs_supplierCambia i campi di un fornitore Fulfilled by Skroutz; solo i campi che invii cambiano. Risponde success: true
skroutz_validate_product_updatesControlla un lotto di aggiornamenti di prodotto (disponibilità, prezzo in centesimi, quantità, variazioni) senza cambiare nulla: Skroutz esegue ogni controllo…
skroutz_update_productsAggiorna disponibilità, prezzo (centesimi di euro) e quantità di fino a 500 prodotti esistenti e le loro variazioni in un lotto; non crea…
skroutz_get_product_update_statusLeggi l'esito di un aggiornamento di lotto di prodotto: stato (in_progress mentre qualsiasi prodotto è in attesa, poi completato), created_at, e per prodotto…
skroutz_get_cps_orderLeggi un ordine CPS (una vendita nel tuo negozio online proveniente da Skroutz, pagata tramite commissione) tramite il codice d'ordine che il tuo negozio gli ha dato: data…
skroutz_reject_cps_orderRifiuta un ordine CPS in modo che Skroutz non addebiti commissioni su di esso, con una delle sue reject_options (user_cancel, user_return, non consegnato…

Esempi di prompt

  • "Mostra l'ordine 251114-3920517 con i suoi articoli, le sue opzioni di ritiro e quando scade."
  • "Accetta l'ordine 251114-3920517 per la prima finestra di ritiro del mio magazzino di Atene."
  • "L'ordine 251112-1187340 ha bisogno di Imposta come Pronto: è pronto per essere segnato, e quando è il ritiro?"
  • "Cosa dice il reso R-251110-2045318, e entro quando devo rivederlo?"
  • "Quante unità di ciascun prodotto ho nei magazzini Skroutz?"

FAQ

Da dove provengono i token? Dal pannello dei commercianti di Skroutz, e sono tre token separati: il token API del marketplace sotto Servizi, Skroutz Marketplace (ordini, resi, Fulfilled by Skroutz), il token API Prodotti facoltativo sotto Prodotti, Aggiornamenti Feed per aggiornamenti di prezzo e stock in blocco, e il token CPS facoltativo per ordini del tuo negozio online. Generare un nuovo token marketplace termina il vecchio.

Può elencare i miei ordini? No. L'API di Skroutz non ha una lista di ordini: gli ordini raggiungono un negozio tramite il webhook, il pannello dei commercianti e le email degli ordini. Dai all'AI il codice dell'ordine (come 251114-3920517) e legge l'ordine. I codici demo come DEMO-OPEN sono sicuri per i test.

Quali strumenti sono installati disattivati? skroutz_reject_order e skroutz_reject_cps_order, perché un rifiuto non può essere annullato, gli strumenti per i resi skroutz_handle_return, skroutz_submit_service_inspection e skroutz_file_compensation_request, skroutz_create_fbs_purchase_order, che porta a spese di magazzino, e skroutz_update_products.

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 Skroutz a Microsoft Copilot in 2 minuti

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

Guide correlate

Connettori

Skroutz MCP con ChatGPT: ordini e scorte

API di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

Connettori

Skroutz MCP con Claude: ordini e scorte

API di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

Connettori

Skroutz MCP con Cursor: ordini e scorte

API di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

Connettori

Skroutz MCP con Gemini CLI: ordini e scorte

API di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

Connettori

Skroutz MCP con Meta Muse: ordini e scorte

API di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

Connettori

Skroutz MCP server: ordini, scorte e resi

API di Skroutz Marketplace (Smart Cart) per venditori nel marketplace greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Gestito da Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.