Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Shoptet con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
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.
Prova a chiedere
Prompt di esempio per Shoptet
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.
💡 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 + Meta Muse
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.
- Nell'amministrazione di Shoptet apri Connections (Propojení), Private API e crea un token.
- 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.
- Incolla il token in
SHOPTET_API_TOKEN: solo il token, senza spazi né virgolette. - 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 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
Shoptet.
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.
Tool disponibili
| Tool | What it does |
|---|---|
shoptet_get_eshop | Get the e-shop's own settings: name, URL, contact and billing details, VAT payer, time zone, default price list, currencies and languages.… |
shoptet_list_orders | List orders, newest first, at most 50 per page: code, creation and change time, customer name, e-mail and phone, status, paid flag, total… |
shoptet_get_order | Get one order by its code (order number): billing and delivery address, items with code, name, amount, unit price and VAT, prices, status… |
shoptet_get_order_history | Get the history of an order: every status change, e-mail sent, remark and system event with time, text and the user who did it |
shoptet_list_order_statuses | List the order statuses of the shop (they differ from shop to shop): id, name, whether it is a system status, whether it marks the order… |
shoptet_list_order_sources | List the order sources of the shop (e-shop, cash desk, marketplaces, imports) with id and name |
shoptet_list_products | List products, 1 to 100 per page: guid, name, type, visibility, default category, brand, supplier, URL and rating |
shoptet_get_product | Get one product by guid with its variants: code, EAN, price, VAT rate, stock amount, availability, weight and parameters per variant… |
shoptet_get_product_by_code | Get a product by the code of the product or of one of its variants (the SKU shown in the admin and on orders), with the same details and… |
shoptet_list_categories | List the product categories: guid, name, parent guid, visibility and URL |
shoptet_list_brands | List the brands (manufacturers) of the shop: guid, code, name, web and whether they show in the brand list |
shoptet_list_stocks | List the stocks (warehouses) of the shop with id, title and whether they are a pickup point, plus the default stock id |
shoptet_list_stock_supplies | List the stock levels in one stock: product guid, code, amount in stock, claimed amount (reserved by orders) and storage location |
shoptet_list_stock_movements | List stock movements in one stock, oldest first: product code, amount after the change, the change, time and who or what changed it (an… |
shoptet_list_customers | List registered customers: guid, billing name and company, creation and change time and admin link |
shoptet_get_customer | Get one registered customer: billing and delivery addresses, company id and VAT id, customer group, price ratio, remark and account e-mails |
shoptet_list_customer_groups | List the customer groups (e.g. retail, wholesale, VIP) with id, name, default price list and maximum discount |
shoptet_list_invoices | List invoices: code, order code, issue, due and tax dates, billing name and company, variable symbol, paid flag and price |
shoptet_get_invoice | Get one invoice by its code: items, prices and VAT breakdown, billing and delivery address, payment method, due date, paid flag and symbols |
shoptet_list_credit_notes | List credit notes (opravné daňové doklady): code, invoice and order code, date, billing name, reason and price |
shoptet_list_proforma_invoices | List proforma invoices (advance invoices): code, order code, date, billing name, paid flag and price |
shoptet_list_payment_methods | List the payment methods of the shop with guid, name, type, visibility and whether they are for wholesale or in-person payment |
shoptet_list_shipping_methods | List the shipping methods of the shop with guid, name, carrier, tracking URL and visibility |
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
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?
