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.
AnythingMCP è nella directory dei connettori di Claude: aggiungilo a Claude con un clic (si apre in una nuova scheda), poi accedi e scegli quali server MCP può usare Claude.
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 + Claude
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 Claude
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.
Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.
- In Claude apri Customize → Connectors.
- Clicca + e poi Add custom connector.
- Inserisci un nome, ad esempio
Loyverse, e l'URL del server MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add. - Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.
Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.
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
Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Prossimi passi
- Landing del connettore
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
- Collegare a Microsoft Copilot
Questa guida ti è stata utile?