Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Lightspeed Retail (X-Series) mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
AnythingMCP ist im Connector-Verzeichnis von Claude gelistet: Füg es mit einem Klick zu Claude hinzu (öffnet in neuem Tab), melde dich an und wähle, welche MCP-Server Claude nutzen darf.
Zusammenfassung
Lightspeed Retail X-Series (früher Vend) für einen Store: Filialen, Kassen und Kassenstände, Verkaufssuche nach Datum, Produkte und Produktfamilien, Kategorien, Marken, Lieferanten, Preisbücher und Aktionen, Lagerbestände, Bestandskorrekturen, Consignments und Bestellungen, Kunden, Guthaben und Geschenkkarten. Retouren und Löschen sind bei der Installation aus.
Frag einfach
Beispiel-Prompts für Lightspeed Retail (X-Series)
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Lightspeed Retail (X-Series) klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Lightspeed Retail (X-Series) + Claude
Lightspeed Retail X-Series (früher Vend) für einen Store: Filialen, Kassen und Kassenstände, Verkaufssuche nach Datum, Produkte und Produktfamilien, Kategorien, Marken, Lieferanten, Preisbücher und Aktionen, Lagerbestände, Bestandskorrekturen, Consignments und Bestellungen, Kunden, Guthaben und Geschenkkarten. Retouren und Löschen sind bei der Installation aus.
Voraussetzungen
Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:
LIGHTSPEED_DOMAIN_PREFIX, LIGHTSPEED_PERSONAL_TOKEN
Schritt 1 — Zugangsdaten holen
Nur X-Series: Dieser Connector nutzt die Lightspeed Retail (X-Series) API, früher Vend, Datumsversion 2026-10, eines Stores unter https://<domain_prefix>.retail.lightspeed.app/api/2026-10. Lightspeed Retail R-Series und Lightspeed Restaurant deckt er nicht ab, sie haben andere APIs.
Die Einrichtung dauert etwa 2 Minuten. Personal Tokens brauchen den Plus-Tarif oder höher und einen Admin.
- Öffne als Admin das Retail-POS-Backoffice, Setup, Personal tokens, und klicke auf Add personal token. Gib einen Namen (und wenn du willst ein Ablaufdatum) ein, erzeuge das Token und kopiere es.
- Füge es in
LIGHTSPEED_PERSONAL_TOKENein. Es wird alsAuthorization: Bearer <token>gesendet und handelt als der Benutzer, der es erstellt hat. - Setze
LIGHTSPEED_DOMAIN_PREFIXauf den ersten Teil deiner Store-Adresse: Beihttps://mystore.retail.lightspeed.appist esmystore. - Installiere den Connector und führe
lightspeed_retail_get_retaileraus: Es zeigt Name, Währung und Zeitzone des Stores und bestätigt das Token.
Store-Einrichtung: lightspeed_retail_get_retailer, lightspeed_retail_get_current_user, Filialen (Outlets) mit lightspeed_retail_list_outlets und lightspeed_retail_get_outlet, Kassen mit lightspeed_retail_list_registers und lightspeed_retail_get_register, lightspeed_retail_get_register_payments_summary (erwartete Beträge pro Zahlungsart und Bargeldbewegungen der offenen Schicht, wie beim Kassenabschluss), Zahlungsarten, Steuern, Benutzer (Personal) und Schichten.
Verkäufe: Für einen Zeitraum, eine Filiale, eine Kasse, einen Kunden oder eine Rechnungsnummer nutzt die KI lightspeed_retail_search mit type: sales und date_from/date_to; die einfache Liste ignoriert Datumsangaben. lightspeed_retail_list_sales geht alle Verkäufe nach Version durch (zum Synchronisieren), lightspeed_retail_get_sale liest einen Verkauf mit Positionen, Zahlungen, Kunde, Benutzer und Kasse.
Katalog: lightspeed_retail_list_products (oder sku für ein Produkt), lightspeed_retail_get_product, lightspeed_retail_get_product_family und lightspeed_retail_get_product_family_of_product. Seit Version 2026-10 hält eine Produktfamilie die gemeinsamen Daten (Name, Marke, Kategorie, Tags) und jedes Produkt die Daten pro Variante (Codes, Preise, Lieferanten). Stammdaten: Kategorien, alte Produkttypen, Marken, Tags, Lieferanten, Preisbücher und Aktionen.
Bestand: lightspeed_retail_list_inventory_levels liefert Bestand, Durchschnittskosten, Meldebestand und Nachbestellmenge pro Produkt und Filiale, mit Filtern, Sortierung und to_be_procured_only für Nachbestelllisten; lightspeed_retail_get_product_inventory_levels zeigt ein Produkt in allen Filialen; lightspeed_retail_list_inventory_records und lightspeed_retail_list_stock_adjustments listen die Rohdaten und Bestandskorrekturen. Lieferantenbestellungen, Umlagerungen zwischen Filialen, Rücksendungen an Lieferanten und Inventuren sind Consignments: lightspeed_retail_list_consignments, lightspeed_retail_get_consignment und lightspeed_retail_list_consignment_products (bestellte und erhaltene Mengen). Bestellungen (Purchase Orders) liest die KI mit lightspeed_retail_list_purchase_orders und lightspeed_retail_get_purchase_order.
Kunden: Die KI findet einen Kunden mit lightspeed_retail_search (type: customers, nach E-Mail, Name, Code oder Telefon) und liest dann lightspeed_retail_get_customer (Treuepunkte, Guthaben und offener Kontosaldo, Umsatz im laufenden Jahr). Dazu lightspeed_retail_list_customers, lightspeed_retail_list_customer_groups, lightspeed_retail_get_customer_store_credit und Geschenkkarten mit lightspeed_retail_list_gift_cards und lightspeed_retail_get_gift_card.
Was er schreibt: lightspeed_retail_create_sale erfasst einen Verkauf (state closed schließt ihn ab, parked oder pending speichert ihn für später); lightspeed_retail_update_sale ändert oder schließt einen geparkten oder offenen Verkauf ab und ersetzt dabei den ganzen Verkauf, deshalb liest die KI ihn vorher. Produkte: lightspeed_retail_create_product_family, lightspeed_retail_add_products_to_family (neue Varianten), lightspeed_retail_update_product_family für gemeinsame Daten und lightspeed_retail_update_product für Preise, Codes, Lieferanten, Filialsteuern und Bestandseinstellungen. Außerdem lightspeed_retail_create_supplier, lightspeed_retail_create_stock_adjustments (quantity ist die Änderung, negativ zum Ausbuchen, mit einem Grund wie Beschädigung, Diebstahl oder gefundener Ware), lightspeed_retail_create_consignment (wird im Status OPEN angelegt; Produkte kommen in Lightspeed oder später dazu), lightspeed_retail_create_customer und lightspeed_retail_update_customer (first_name und last_name sind Pflicht). Verkäufe und Bestandskorrekturen ändern Bestand und Berichte sofort, deshalb zeigt dir die KI Positionen und Summen und wartet auf dein Ja.
Bei der Installation deaktiviert: lightspeed_retail_return_sale, lightspeed_retail_delete_product und lightspeed_retail_delete_customer. Sie lassen sich nicht rückgängig machen, deshalb schaltet ein Workspace-Admin sie ein, wenn das Team sie braucht.
Datenformate: Antworten packen die Datensätze in data. IDs sind UUIDs. Geldbeträge sind Dezimalzahlen in der Store-Währung. Ein Verkauf hat totals (price ohne Steuer, tax, price_incl_tax); auf jeder Position ist pricing.price der Stückpreis ohne Steuer, pricing.total die Positionssumme nach Rabatt, pricing.cost_total die Kosten, tax.amount und tax.total die Steuer pro Stück und pro Position. Steuersätze sind Brüche (0.2 = 20 %). Zeiten sind UTC (ISO 8601): date_from/date_to nehmen UTC, time_from/time_to Ortszeit zusammen mit timezone. Der state eines Verkaufs ist closed, parked, pending (auf Rechnung oder Anzahlung) oder voided.
Blättern: Die meisten Listen blättern nach Version: Die Antwort enthält version mit min und max, die KI gibt max als after für die nächste Seite mit und hört auf, wenn data leer ist. lightspeed_retail_search und lightspeed_retail_list_inventory_levels blättern mit offset, Geschenkkarten mit before.
Limits und häufige Fehler: etwa 300 Anfragen pro 5 Minuten pro Kasse plus 50; darüber antwortet Lightspeed mit 429 und Retry-After. 401 bedeutet ein falsches oder abgelaufenes Token oder einen falschen Domain-Präfix. 403 bedeutet, dass der Benutzer des Tokens das nicht darf, denn Personal Tokens handeln als ihr Benutzer: Lege das Token mit einem Admin an. 404 bei jedem Aufruf heißt, dass LIGHTSPEED_DOMAIN_PREFIX falsch ist (nur der Teil vor .retail.lightspeed.app); bei einem einzelnen Datensatz ist die ID falsch. 422 ist ein Validierungsfehler mit dem betroffenen Feld.
Mit den Tools, die bei der Installation aktiv sind, wickelt der Connector keine Retouren ab und löscht nichts. Bestellungen, Preisbücher, Aktionen, Guthaben und Geschenkkarten liest er nur; eine neue Lieferantenbestellung legt er als Consignment an.
Schritt 2 — Adapter installieren
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
Schritt 3 — Connector in Claude hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
Empfohlener Weg: funktioniert auf claude.ai web ohne Anfassen einer Konfigurationsdatei.
- Öffne in Claude Customize → Connectors.
- Klicke auf + und dann auf Add custom connector.
- Gib einen Namen ein, z. B.
Lightspeed Retail (X-Series), und die Remote-MCP-Server-URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, dann klicke auf Add. - Klicke auf Connect und melde dich bei AnythingMCP an (OAuth), um den Zugriff zu erlauben.
Alle unten gelisteten Tools erscheinen in deinem Chat: Leg los mit Prompts.
Verfügbare Tools
| 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) |
Beispiel-Prompts
- „Wie viel hat jede Filiale gestern verkauft, ohne und mit Steuer?“
- „Welche Produkte in der Filiale Hauptstraße liegen unter dem Meldebestand? Mach mir eine Nachbestellliste nach Lieferant.“
- „Finde die Kundin mit der E-Mail [email protected] und zeig mir ihre Treuepunkte und ihr Guthaben.“
- „Buch für SKU TSHIRT-BLK-M in der Filiale Hauptstraße 3 Stück mit dem Grund Beschädigung aus. Zeig mir die Korrektur vor dem Speichern.“
- „Zeig mir den Verkauf mit der Rechnungsnummer 10452 mit Positionen, Rabatten und Zahlungen.“
FAQ
Funktioniert es mit Claude Code genauso wie mit Claude Desktop? Ja, beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID zeigen lassen.
Nächste Schritte
- Connector-Startseite
- Mit ChatGPT verbinden
- Mit Cursor verbinden
- Mit Gemini verbinden
- Mit Meta Muse verbinden
- Mit Microsoft Copilot verbinden
War dieser Guide hilfreich?