Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Lightspeed Retail (X-Series) 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
Lightspeed Retail X-Series (ex Vend) per un negozio: punti vendita, casse e totali di cassa, ricerca vendite per data, prodotti e famiglie di prodotti, categorie, marchi, fornitori, listini e promozioni, giacenze, rettifiche, consignment e ordini d'acquisto, clienti, credito in negozio e carte regalo. Resi ed eliminazioni sono disattivati all'installazione.
Prova a chiedere
Prompt di esempio per Lightspeed Retail (X-Series)
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 → Lightspeed Retail (X-Series), inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Lightspeed Retail (X-Series) + ChatGPT
Lightspeed Retail X-Series (ex Vend) per un negozio: punti vendita, casse e totali di cassa, ricerca vendite per data, prodotti e famiglie di prodotti, categorie, marchi, fornitori, listini e promozioni, giacenze, rettifiche, consignment e ordini d'acquisto, clienti, credito in negozio e carte regalo. Resi 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:
LIGHTSPEED_DOMAIN_PREFIX, LIGHTSPEED_PERSONAL_TOKEN
Step 1 — Ottieni le credenziali
Solo X-Series: questo connettore usa la Lightspeed Retail (X-Series) API, ex Vend, versione 2026-10, di un negozio all'indirizzo https://<domain_prefix>.retail.lightspeed.app/api/2026-10. Non copre Lightspeed Retail R-Series né Lightspeed Restaurant, che hanno API diverse.
La configurazione richiede circa 2 minuti. I personal token richiedono il piano Plus o superiore e un utente admin.
- Come admin apri il back office di Retail POS, Setup, Personal tokens, e fai clic su Add personal token. Dagli un nome (e, se vuoi, una data di scadenza), generalo e copia il token.
- Incollalo in
LIGHTSPEED_PERSONAL_TOKEN. Viene inviato comeAuthorization: Bearer <token>e agisce come l'utente che l'ha creato. - Imposta
LIGHTSPEED_DOMAIN_PREFIXsulla prima parte dell'indirizzo del negozio: perhttps://mystore.retail.lightspeed.appèmystore. - Installa il connettore ed esegui
lightspeed_retail_get_retailer: mostra nome, valuta e fuso orario del negozio e conferma il token.
Impostazioni del negozio: lightspeed_retail_get_retailer, lightspeed_retail_get_current_user, punti vendita (outlet) con lightspeed_retail_list_outlets e lightspeed_retail_get_outlet, casse con lightspeed_retail_list_registers e lightspeed_retail_get_register, lightspeed_retail_get_register_payments_summary (importi attesi per metodo di pagamento e movimenti di contante del turno aperto, come per la chiusura di cassa), metodi di pagamento, tasse, utenti (personale) e turni.
Vendite: per un periodo, un punto vendita, una cassa, un cliente o un numero di scontrino l'AI usa lightspeed_retail_search con type: sales e date_from/date_to; la lista semplice ignora le date. lightspeed_retail_list_sales scorre tutte le vendite per versione (per la sincronizzazione) e lightspeed_retail_get_sale legge una vendita con righe, pagamenti, cliente, utente e cassa.
Catalogo: lightspeed_retail_list_products (o sku per un prodotto), lightspeed_retail_get_product, lightspeed_retail_get_product_family e lightspeed_retail_get_product_family_of_product. Dalla versione 2026-10 una famiglia di prodotti contiene i dati comuni (nome, marchio, categoria, tag) e ogni prodotto i dati della singola variante (codici, prezzi, fornitori). Dati di riferimento: categorie, tipi di prodotto legacy, marchi, tag, fornitori, listini (price book) e promozioni.
Giacenze: lightspeed_retail_list_inventory_levels restituisce quantità, costo medio, punto di riordino e quantità di riordino per prodotto e punto vendita, con filtri, ordinamento e to_be_procured_only per le liste di riordino; lightspeed_retail_get_product_inventory_levels mostra un prodotto in tutti i punti vendita; lightspeed_retail_list_inventory_records e lightspeed_retail_list_stock_adjustments elencano i record grezzi e le rettifiche. Ordini ai fornitori, trasferimenti tra punti vendita, resi ai fornitori e inventari sono consignment: lightspeed_retail_list_consignments, lightspeed_retail_get_consignment e lightspeed_retail_list_consignment_products (quantità ordinate e ricevute). Gli ordini d'acquisto si leggono con lightspeed_retail_list_purchase_orders e lightspeed_retail_get_purchase_order.
Clienti: l'AI trova un cliente con lightspeed_retail_search (type: customers, per email, nome, codice o telefono) e poi legge lightspeed_retail_get_customer (punti fedeltà, credito in negozio e saldo a credito, spesa dall'inizio dell'anno). Inoltre lightspeed_retail_list_customers, lightspeed_retail_list_customer_groups, lightspeed_retail_get_customer_store_credit e le carte regalo con lightspeed_retail_list_gift_cards e lightspeed_retail_get_gift_card.
Cosa scrive: lightspeed_retail_create_sale registra una vendita (state closed la chiude, parked o pending la salva per dopo); lightspeed_retail_update_sale modifica o chiude una vendita sospesa o in attesa e sostituisce l'intera vendita, quindi l'AI la legge prima. Prodotti: lightspeed_retail_create_product_family, lightspeed_retail_add_products_to_family (nuove varianti), lightspeed_retail_update_product_family per i dati comuni e lightspeed_retail_update_product per prezzi, codici, fornitori, tasse per punto vendita e impostazioni di giacenza. Inoltre lightspeed_retail_create_supplier, lightspeed_retail_create_stock_adjustments (quantity è la variazione, negativa per scaricare, con un motivo come danno, furto o merce ritrovata), lightspeed_retail_create_consignment (creato in stato OPEN; i prodotti si aggiungono in Lightspeed o in seguito), lightspeed_retail_create_customer e lightspeed_retail_update_customer (first_name e last_name sono obbligatori). Vendite e rettifiche cambiano subito giacenze e report, quindi l'AI ti mostra righe e totali e aspetta il tuo sì.
Disattivati all'installazione: lightspeed_retail_return_sale, lightspeed_retail_delete_product e lightspeed_retail_delete_customer. Non si possono annullare, quindi un admin del workspace li attiva quando servono al team.
Formati dei dati: le risposte racchiudono i record in data. Gli id sono UUID. Gli importi sono numeri decimali nella valuta del negozio. Una vendita ha totals (price senza tasse, tax, price_incl_tax); su ogni riga pricing.price è il prezzo unitario senza tasse, pricing.total il totale di riga dopo lo sconto, pricing.cost_total il costo, tax.amount e tax.total la tassa unitaria e di riga. Le aliquote sono frazioni (0.2 = 20%). Gli orari sono UTC (ISO 8601): date_from/date_to accettano UTC, time_from/time_to l'ora locale insieme a timezone. Lo state di una vendita è closed, parked, pending (a credito o con acconto) o voided.
Paginazione: la maggior parte delle liste pagina per versione: la risposta contiene version con min e max, l'AI passa max come after per la pagina successiva e si ferma quando data è vuoto. lightspeed_retail_search e lightspeed_retail_list_inventory_levels paginano con offset, le carte regalo con before.
Limiti ed errori comuni: circa 300 richieste ogni 5 minuti per cassa più 50; oltre, Lightspeed risponde 429 con Retry-After. 401 indica un token errato o scaduto o un prefisso di dominio sbagliato. 403 indica che l'utente del token non può farlo, perché i personal token agiscono come il loro utente: crea il token con un admin. 404 su ogni chiamata significa che LIGHTSPEED_DOMAIN_PREFIX è sbagliato (solo la parte prima di .retail.lightspeed.app); su un singolo record significa un id errato. 422 è un errore di validazione con il campo indicato.
Con i tool attivi all'installazione il connettore non gestisce resi e non elimina nulla. Legge ordini d'acquisto, listini, promozioni, credito in negozio e carte regalo senza modificarli; un nuovo ordine al fornitore si crea come consignment.
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 ChatGPT
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.
ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.
- Vai su chatgpt.com/plugins, clicca Add e poi Add custom MCP server.
- Inserisci un nome, ad esempio Name:
Lightspeed Retail (X-Series). - In Connection inserisci come Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDe lascia Authentication su OAuth. - Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
- Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.
Tool disponibili
| Tool | What it does |
|---|---|
lightspeed_retail_get_retailer | Get the retailer (store account): name, domain prefix, currency, time zone, tax settings and loyalty settings |
lightspeed_retail_get_current_user | Get the user the personal token belongs to: name, email, account type (admin, manager, cashier) and the outlets they can use |
lightspeed_retail_list_outlets | List the outlets (store locations) with name, address, time zone, default tax and receipt settings |
lightspeed_retail_get_outlet | Get one outlet (store location) by id with its address, time zone, default tax and settings |
lightspeed_retail_list_registers | List registers (tills) with outlet, name, open or closed state, current register opening and invoice numbering |
lightspeed_retail_get_register | Get one register (till) by id with outlet, whether it is open and the current register opening (shift) |
lightspeed_retail_get_register_payments_summary | Get the payments summary of the current opening of one register: expected amounts per payment type, cash movements and totals, as used to… |
lightspeed_retail_list_payment_types | List payment types (cash, card, gift card, store credit, on account, custom) with their id and config |
lightspeed_retail_list_taxes | List sales taxes with name, rate (a fraction, 0.2 = 20%) and components |
lightspeed_retail_get_tax | Get one sales tax by id with its name, rate as a fraction (0.2 = 20%) and tax components |
lightspeed_retail_list_users | List users (staff) with name, email, account type and outlets |
lightspeed_retail_get_user | Get one user (staff member) by id with name, display name, email, account type and outlets |
lightspeed_retail_list_shifts | List staff shifts (clock in and clock out) with user, outlet, start and end time |
lightspeed_retail_list_products | List products (each sellable item or variant) with name, SKU and codes, prices, family, supplier codes and active state |
lightspeed_retail_get_product | Get one product by id: variant name, codes, prices including and excluding tax, family, measurements, suppliers, outlet taxes and inventory |
lightspeed_retail_get_product_family | Get a product family by id: name, description, classification (STANDARD, VARIANT, COMPOSITE), brand, category, tags and all member products |
lightspeed_retail_get_product_family_of_product | Get the product family a product belongs to, with all its sibling variants or composite components |
lightspeed_retail_create_product_family | Create a product family with its products: a STANDARD product, a VARIANT family (variant attributes, one product per variant) or a COMPOSITE |
lightspeed_retail_update_product_family | Update the shared data of a product family: name, description, brand, category, tags, inventory tracking or composite components |
lightspeed_retail_add_products_to_family | Add products (new variants) to an existing product family, each with its codes, variant attribute values and prices |
lightspeed_retail_update_product | Update one product: prices, codes, supplier codes and prices, outlet taxes, inventory settings, measurements or whether it is active in… |
lightspeed_retail_delete_product | Delete one product |
lightspeed_retail_list_product_categories | List the product category tree (id, name, parent and path) |
lightspeed_retail_list_product_types | List the legacy product types with id and name |
lightspeed_retail_list_brands | List the product brands of the store with id and name, paged by version |
lightspeed_retail_list_tags | List the product tags of the store with id and name, paged by version |
lightspeed_retail_list_suppliers | List suppliers with name, description, default markup and contact details |
lightspeed_retail_get_supplier | Get one supplier by id with contact person, email, phone, addresses, description and default markup |
lightspeed_retail_create_supplier | Create a supplier with a name, description, default markup and contact details (company, person, email, phone, address) |
lightspeed_retail_list_price_books | List price books (special prices per customer group, outlet and validity dates) with their settings |
lightspeed_retail_list_promotions | List promotions (discounts, buy X get Y, promo codes) with conditions, outlets, customer groups and validity dates |
lightspeed_retail_get_promotion | Get one promotion by id with its conditions, actions, outlets, customer groups, channels and validity dates |
lightspeed_retail_list_inventory_levels | List stock levels per product and outlet with counts, average cost, reorder point and amount |
lightspeed_retail_get_product_inventory_levels | Get the stock of one product in every outlet: current count, average cost, reorder point and reorder amount |
lightspeed_retail_list_inventory_records | List raw inventory records (product, outlet, count, reorder settings) by version, for one product or the whole store |
lightspeed_retail_list_stock_adjustments | List stock adjustments (damage, theft, stock found, internal use and custom reasons) with product, outlet, quantity and reason |
lightspeed_retail_create_stock_adjustments | Adjust stock up or down with a reason (damage, expiry, theft, internal use, donation, stock found, sample). quantity is the change… |
lightspeed_retail_list_consignments | List consignments: supplier orders, outlet transfers, returns and stocktakes, with status, outlet, supplier and dates |
lightspeed_retail_get_consignment | Get one consignment by id: type, status, outlet, source outlet or supplier, reference, due and received dates and cost and count totals |
lightspeed_retail_list_consignment_products | List the products of a consignment with ordered and received counts and cost, for checking a delivery or stocktake |
lightspeed_retail_create_consignment | Create a consignment: a supplier order, an outlet transfer, a supplier return or a stocktake, in OPEN status |
lightspeed_retail_list_purchase_orders | List purchase orders to suppliers with number, supplier, outlet, status, ordered and received totals |
lightspeed_retail_get_purchase_order | Get one purchase order by id with supplier, outlet, status, dates, totals and delivery information |
lightspeed_retail_list_sales | List sales by version (oldest changes first) with line items, payments, totals, customer, user, register and status |
lightspeed_retail_get_sale | Get one sale by id: invoice number, status, date, line items with price, discount, tax and cost, payments, customer, user and register |
lightspeed_retail_search | Search sales, products or customers |
lightspeed_retail_create_sale | Record a sale: line items with product, quantity, price and tax, payments and customer. state closed completes it, parked or pending saves… |
lightspeed_retail_update_sale | Update a parked or pending sale (lines, payments, customer, note) or complete it by setting state to closed |
lightspeed_retail_return_sale | Start a return (refund) of a closed sale: Lightspeed creates a return sale linked to the original on the register |
lightspeed_retail_list_customers | List customers by version with name, code, contact details, group, loyalty balance and on-account balance |
lightspeed_retail_get_customer | Get one customer by id: name, code, email, phone, addresses, group, loyalty balance, store credit and on-account balance and year to date… |
lightspeed_retail_create_customer | Create a customer with name, contact details, address, customer group, loyalty enrolment and marketing consent |
lightspeed_retail_update_customer | Update a customer: contact details, address, group, note, loyalty or marketing consent. first_name and last_name are required by the API |
lightspeed_retail_delete_customer | Delete a customer |
lightspeed_retail_list_customer_groups | List customer groups (e.g |
lightspeed_retail_get_customer_store_credit | Get the store credit of one customer: current balance and the list of store credit transactions (issued, redeemed, reversed) |
lightspeed_retail_list_gift_cards | List gift cards with number, balance, status (ACTIVE, REDEEMED, VOIDED, EXPIRED) and expiry, newest first |
lightspeed_retail_get_gift_card | Get a gift card by its card number with balance, status, expiry and the transactions (issue, redeem, reverse) |
Esempi di prompt
- "Quanto ha venduto ieri ogni punto vendita, senza e con tasse?"
- "Quali prodotti nel punto vendita di Via Roma sono sotto il punto di riordino? Fammi una lista di riordino per fornitore."
- "Trova la cliente con email [email protected] e mostrami i suoi punti fedeltà e il credito in negozio."
- "Registra una rettifica di meno 3 per lo SKU TSHIRT-BLK-M nel punto vendita di Via Roma con motivo danno. Mostramela prima di salvare."
- "Mostrami la vendita con numero scontrino 10452 con righe, sconti e pagamenti."
FAQ
Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
- Collegare a Microsoft Copilot
Questa guida ti è stata utile?