Come collegare Shoptet a Cursor via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Shoptet, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Shoptet + Cursor

E-shop Shoptet (Repubblica Ceca, Slovacchia, Ungheria), in sola lettura: ordini con cronologia e note, prodotti e varianti con prezzi e giacenze, categorie, marchi, livelli e movimenti di magazzino, clienti, fatture, fatture proforma, note di credito, metodi di pagamento e di spedizione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

SHOPTET_API_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti. Ti serve un e-shop Shoptet Premium, perché l'API privata è disponibile solo con Premium, e l'accesso alla sua amministrazione.

1. Nell'amministrazione di Shoptet apri Connections (Propojení), Private API e crea un token.
2. Dai al token l'accesso in lettura alle aree che l'AI deve vedere: ordini, prodotti, magazzino, clienti e documenti. Un'area che il token non può leggere risponde 403.
3. Incolla il token in SHOPTET_API_TOKEN: solo il token, senza spazi né virgolette.
4. Installa il connettore ed esegui shoptet_get_eshop: mostra nome, URL, valute, lingue e fuso orario del negozio, e quindi che il token funziona.

Un token, un e-shop: ogni token appartiene a un solo e-shop. Se gestisci un negozio .cz e uno .sk, installa il connettore una seconda volta con il token dell'altro negozio.

Cosa legge: le impostazioni del negozio; gli ordini con indirizzo di fatturazione e di consegna, righe, prezzi con e senza IVA, stato, indicatore di pagamento, metodo di pagamento e di spedizione, canale di vendita, note e numero di tracking; la cronologia completa di un ordine (cambi di stato, email inviate, annotazioni); i prodotti e le loro varianti con codice, EAN, prezzo, aliquota IVA, disponibilità e giacenza, anche per magazzino se lo chiedi; categorie e marchi; i livelli di magazzino con le quantità riservate dagli ordini e i movimenti di magazzino; i clienti registrati con indirizzi, partita IVA e codice aziendale e gruppo clienti; le fatture con simbolo variabile, scadenza e riepilogo IVA; le fatture proforma; le note di credito (opravné daňové doklady) con il motivo; e i metodi di pagamento e di spedizione.

Prima le impostazioni del negozio: stati degli ordini, origini degli ordini, magazzini, categorie e marchi sono diversi in ogni negozio, quindi l'AI legge prima i loro id dal tuo negozio (per esempio con shoptet_list_order_statuses o shoptet_list_stocks) e poi filtra con quelli. Un prodotto si trova dal suo codice, lo SKU che vedi in amministrazione e negli ordini, con shoptet_get_product_by_code.

Pagine, orari e prezzi: gli ordini arrivano dal più recente, al massimo 50 per pagina; i prodotti da 1 a 100 per pagina; le note di credito al massimo 20 per pagina. Ogni elenco indica quante pagine ci sono, e l'AI chiede la successiva solo quando le serve. Gli orari hanno un offset come 2026-10-20T00:00:00+0200: i negozi cechi e slovacchi usano l'ora di Europe/Prague. I prezzi arrivano con la valuta del negozio, per esempio CZK o EUR.

Sola lettura: il connettore non ha nessuno strumento che modifica qualcosa. Non può cambiare un ordine o il suo stato, un prodotto, un prezzo, le giacenze o un cliente, quindi non c'è nulla che l'AI debba farti confermare.

Limiti: Shoptet consente 3 richieste simultanee per token e rallenta i picchi con un 429. L'AI aspetta qualche secondo prima di riprovare e chiede solo quello che serve, invece di sfogliare l'intero negozio.

Errori comuni: 401 expired-token o invalid-token significa che il token è stato eliminato o è scaduto: creane uno nuovo. 403 invalid-token-no-rights indica che il token non ha accesso a quell'area: modifica i suoi permessi in Private API. 404 indica che non esiste un ordine, un prodotto o un documento con quel codice.

Il connettore non crea né modifica ordini, prodotti, prezzi, giacenze o clienti, non emette fatture o note di credito e non invia email ai tuoi clienti.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Shoptet.

Tool disponibili

Esempi di prompt

• "Quali ordini di ieri non sono ancora pagati, e qual è il totale di ciascuno in CZK?"
• "Mostrami la cronologia dell'ordine 2026000123: quando è cambiato lo stato, quali email ha ricevuto il cliente e qual è il numero di tracking?"
• "Quali prodotti stanno finendo nel magazzino principale, e quanti pezzi di ciascuno sono già riservati dagli ordini?"
• "Trova tutti gli ordini di [email protected] di quest'anno e dimmi quali sue fatture sono ancora da pagare."
• "Elenca le note di credito emesse questo mese con motivo, importo e la fattura a cui si riferiscono."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT