Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Loyverse 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
Il back office del punto cassa Loyverse: scontrini di vendita e di rimborso, turni e contanti, articoli con varianti, categorie, modificatori, sconti e tasse, giacenze per negozio, clienti fedeltà, dipendenti, negozi, dispositivi POS, metodi di pagamento, fornitori e webhook. Rimborsi ed eliminazioni sono disattivati all'installazione.
Prova a chiedere
Prompt di esempio per Loyverse
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 → Loyverse, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Loyverse + Microsoft Copilot
Il back office del punto cassa Loyverse: scontrini di vendita e di rimborso, turni e contanti, articoli con varianti, categorie, modificatori, sconti e tasse, giacenze per negozio, clienti fedeltà, dipendenti, negozi, dispositivi POS, metodi di pagamento, fornitori e webhook. Rimborsi ed eliminazioni sono disattivati all'installazione.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
LOYVERSE_ACCESS_TOKEN
Step 1 — Ottieni le credenziali
La configurazione richiede circa 2 minuti. Ti serve l'accesso del titolare a un account Loyverse.
- Accedi al Loyverse Back Office come titolare e apri Settings, Access tokens (
https://r.loyverse.com/dashboard/#/integrations/tokens). In alcuni piani gli access token fanno parte dell'add-on Integrations. - Fai clic su Add access token, dagli un nome e, se vuoi, una data di scadenza, e salva. Copia il token.
- Incollalo in
LOYVERSE_ACCESS_TOKEN. Viene inviato comeAuthorization: Bearer <token>e ha accesso completo all'account, quindi tienilo riservato. - Installa il connettore ed esegui
loyverse_get_merchant: mostra nome dell'attività e valuta e conferma il token.
Il connettore parla con la Loyverse API v1.0 su https://api.loyverse.com/v1.0, l'API di back office del punto cassa Loyverse.
Cosa legge: l'account con loyverse_get_merchant (valuta e numero di decimali), i negozi con loyverse_list_stores e loyverse_get_store e i dispositivi POS con loyverse_list_pos_devices. Vendite: loyverse_list_receipts per negozio e intervallo di date (created_at_min/created_at_max) o per numeri di scontrino, dal più recente, con righe, sconti, tasse, pagamenti, dipendente e cliente; loyverse_get_receipt legge uno scontrino dal suo numero. Turni e contanti: loyverse_list_shifts e loyverse_get_shift (movimenti di cassa, contante atteso ed effettivo, vendite lorde e nette, tasse, pagamenti per tipo). Metodi di pagamento con loyverse_list_payment_types e loyverse_get_payment_type. Catalogo: loyverse_list_items, loyverse_get_item, varianti con SKU, codice a barre e prezzo per negozio con loyverse_list_variants (ricerca per sku) e loyverse_get_variant, categorie, modificatori, sconti, tasse e fornitori. Giacenze: loyverse_list_inventory restituisce in_stock per variante e negozio. Clienti con loyverse_list_customers (ricerca per email) e loyverse_get_customer, con visite, spesa totale e punti fedeltà; dipendenti con loyverse_list_employees e loyverse_get_employee; webhook con loyverse_list_webhooks.
Cosa scrive: loyverse_create_receipt registra una vendita avvenuta altrove, ad esempio in un altro canale: scala la giacenza degli articoli gestiti a magazzino e conta nei report, e i suoi pagamenti devono dare il totale dello scontrino. I tool di salvataggio creano un record senza id e lo aggiornano con id: loyverse_save_item, loyverse_save_variant, loyverse_save_category, loyverse_save_discount, loyverse_save_tax e loyverse_save_customer (total_points imposta il saldo punti). Un aggiornamento sostituisce l'intero record, quindi l'AI lo legge prima e invia ogni campo da mantenere. loyverse_set_inventory accetta in stock_after la nuova quantità assoluta, non una differenza. loyverse_create_webhook iscrive un URL HTTPS a un evento (scontrini, articoli, clienti, variazioni di giacenza o turni chiusi); tipo di evento più URL devono essere unici. Prima di uno scontrino o di una modifica di giacenza l'AI ti mostra righe, importi o nuovi livelli e aspetta il tuo sì.
Disattivati all'installazione: loyverse_refund_receipt, loyverse_delete_item e loyverse_delete_customer. Non si possono annullare, quindi un admin del workspace li attiva quando servono al team.
Formati dei dati: gli id sono UUID; gli scontrini si indicano con receipt_number (ad es. 1-1001). Gli importi sono numeri decimali nella valuta dell'account (vedi loyverse_get_merchant). Gli scontrini hanno receipt_type SALE o REFUND; i rimborsi hanno importi positivi, quindi l'AI li sottrae quando somma le vendite, e cancelled_at segna gli scontrini annullati. Tutti gli orari sono UTC (ISO 8601); l'AI li converte nel fuso orario del negozio prima di raggruppare per giorno. I record eliminati nel Back Office sono nascosti, a meno che show_deleted non sia true.
Paginazione: i tool di elenco restituiscono limit record (50 di default, al massimo 250) e un cursor finché ce ne sono altri; l'AI lo ripassa come cursor finché non manca. Negozi, dispositivi POS, metodi di pagamento, sconti e tasse arrivano tutti in una volta.
Limiti ed errori comuni: 300 richieste ogni 300 secondi per account; oltre, Loyverse risponde 429 RATE_LIMITED. Gli errori arrivano come errors: [{code, details, field}]. 401 UNAUTHORIZED indica un token errato o scaduto: copialo di nuovo o creane uno nuovo. 402 PAYMENT_REQUIRED indica che l'abbonamento o l'add-on che include l'API è scaduto. 403 FORBIDDEN, 404 NOT_FOUND un id errato, 400 INVALID_VALUE o MISSING_REQUIRED_PARAMETER con il campo indicato.
Con i tool attivi all'installazione il connettore non rimborsa scontrini e non elimina nulla. Legge negozi, dispositivi POS, metodi di pagamento, dipendenti, modificatori e fornitori senza crearli né modificarli, e non rimuove webhook.
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 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 mostraYOUR_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.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - 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.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Loyverse. - 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.
Tool disponibili
| Tool | What it does |
|---|---|
loyverse_get_merchant | Get the Loyverse account (merchant) behind the token: business name, email, country and currency with its decimal places |
loyverse_list_stores | List the stores of the account with name, address, phone and description |
loyverse_get_store | Get one store by its id (UUID) with name, address, phone number and description, as shown in the Back Office |
loyverse_list_pos_devices | List the POS devices (registers) of the account, optionally for one store, with name, store id and whether the device is activated |
loyverse_list_receipts | List sales and refund receipts, newest first, with line items, discounts, taxes, payments, totals, store, employee, customer and POS device |
loyverse_get_receipt | Get one receipt by its receipt number (e.g. 1-1001) with all line items, modifiers, discounts, taxes, payments and the refund link |
loyverse_create_receipt | Record a sales receipt in Loyverse (e.g. a sale made in another channel) |
loyverse_refund_receipt | Create a refund receipt for some or all lines of a sales receipt |
loyverse_list_shifts | List closed cash register shifts with opening and closing time, cash movements, expected and actual cash, gross and net sales, taxes and… |
loyverse_get_shift | Get one shift by id with cash drawer amounts, cash movements, sales totals, taxes and payment totals per payment type |
loyverse_list_payment_types | List payment types (cash, card, check and custom ones) with their id and type |
loyverse_get_payment_type | Get one payment type by id with its name, type (CASH, NONINTEGRATEDCARD, CHECK, OTHER and so on) and stores |
loyverse_list_items | List items of the catalog with category, taxes, modifiers, options and their variants (SKU, barcode, cost, default price and price per… |
loyverse_get_item | Get one item by id with its variants, prices per store, category, tax ids, modifier ids, stock tracking and composite components |
loyverse_save_item | Create an item, or update it when id is given (Loyverse upserts with POST) |
loyverse_delete_item | Delete an item and its variants from the catalog |
loyverse_list_variants | List item variants with SKU, barcode, option values, cost, default price and per-store price and availability |
loyverse_get_variant | Get one item variant by id with SKU, barcode, option values, cost and the price and availability in each store |
loyverse_save_variant | Create a variant of an existing item, or update it when variant_id is given (upsert with POST) |
loyverse_list_categories | List item categories with name and colour |
loyverse_get_category | Get one item category by id (UUID) with its name, colour and creation and deletion times |
loyverse_save_category | Create an item category, or rename or recolour it when id is given (Loyverse upserts with POST) |
loyverse_list_modifiers | List modifiers (e.g |
loyverse_list_discounts | List discounts with type (fixed or variable, percent or amount, by points), value, stores and whether access is restricted |
loyverse_get_discount | Get one discount by id (UUID) with its type, amount or percent, stores and restricted access flag |
loyverse_save_discount | Create a discount, or update it when id is given (upsert with POST) |
loyverse_list_taxes | List taxes with rate, type (included in the price or added to it) and stores |
loyverse_get_tax | Get one tax by id (UUID) with its name, rate in percent, type (INCLUDED or ADDED) and stores |
loyverse_save_tax | Create a tax, or update it when id is given (upsert with POST) |
loyverse_list_suppliers | List suppliers with contact name, email, phone, website, address and note |
loyverse_list_inventory | List stock levels per item variant and store (in_stock) |
loyverse_set_inventory | Set the stock of item variants in stores. stock_after is the new absolute quantity, not a change: read the current level first and confirm… |
loyverse_list_customers | List loyalty customers with contact details, customer code, note, first and last visit, total visits, total spent and points balance |
loyverse_get_customer | Get one customer by id with contact details, address, customer code, visits, total spent and loyalty points |
loyverse_save_customer | Create a customer, or update one when id is given (upsert with POST). total_points sets the loyalty balance |
loyverse_delete_customer | Delete a customer with their loyalty points |
loyverse_list_employees | List employees with name, email, phone, role and the stores they work in |
loyverse_get_employee | Get one employee by id (UUID) with name, email, phone number, owner flag and the stores they work in |
loyverse_list_webhooks | List the webhooks of the account with event type, target URL and status (ENABLED or DISABLED after failed deliveries) |
loyverse_create_webhook | Subscribe an HTTPS URL to one event: receipts, items, customers or inventory changes, or closed shifts |
Esempi di prompt
- "Quali sono state ieri le vendite nette per negozio, al netto dei rimborsi?"
- "Mostrami l'ultimo turno chiuso del negozio Centro con contante atteso ed effettivo."
- "Quali varianti hanno meno di 5 pezzi in giacenza nel negozio Centro?"
- "Imposta la giacenza dello SKU LATTE-CUP-12 nel negozio Centro a 200. Mostrami prima il livello attuale."
- "Trova il cliente con email [email protected] e mostrami visite, spesa totale e punti."
FAQ
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
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?