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) + Microsoft Copilot
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 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
Lightspeed Retail (X-Series). - 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 |
|---|---|
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
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?