Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Loyverse 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.
Zusammenfassung
Backoffice des Loyverse-Kassensystems: Verkaufs- und Erstattungsbelege, Schichten und Bargeld, Artikel mit Varianten, Kategorien, Modifikatoren, Rabatte und Steuern, Bestand pro Filiale, Treuekunden, Mitarbeitende, Filialen, Kassengeräte, Zahlungsarten, Lieferanten und Webhooks. Erstattungen und Löschen sind bei der Installation aus.
Frag einfach
Beispiel-Prompts für Loyverse
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 → Loyverse klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Loyverse
Backoffice des Loyverse-Kassensystems: Verkaufs- und Erstattungsbelege, Schichten und Bargeld, Artikel mit Varianten, Kategorien, Modifikatoren, Rabatte und Steuern, Bestand pro Filiale, Treuekunden, Mitarbeitende, Filialen, Kassengeräte, Zahlungsarten, Lieferanten und Webhooks. Erstattungen und Löschen sind bei der Installation aus.
Einrichtung
Die Einrichtung dauert etwa 2 Minuten. Du brauchst den Inhaber-Login eines Loyverse-Kontos.
- Melde dich als Inhaber im Loyverse Back Office an und öffne Settings, Access tokens (
https://r.loyverse.com/dashboard/#/integrations/tokens). In manchen Tarifen gehören Access Tokens zum Integrations-Add-on. - Klicke auf Add access token, gib einen Namen und wenn du willst ein Ablaufdatum ein und speichere. Kopiere das Token.
- Füge es in
LOYVERSE_ACCESS_TOKENein. Es wird alsAuthorization: Bearer <token>gesendet und hat vollen Zugriff auf das Konto, also halte es geheim. - Installiere den Connector und führe
loyverse_get_merchantaus: Es zeigt Geschäftsnamen und Währung und bestätigt das Token.
Der Connector spricht mit der Loyverse API v1.0 unter https://api.loyverse.com/v1.0, der Backoffice-API des Loyverse-Kassensystems.
Was er liest: das Konto mit loyverse_get_merchant (Währung und ihre Nachkommastellen), Filialen mit loyverse_list_stores und loyverse_get_store und Kassengeräte mit loyverse_list_pos_devices. Verkäufe: loyverse_list_receipts nach Filiale und Zeitraum (created_at_min/created_at_max) oder Belegnummern, neueste zuerst, mit Positionen, Rabatten, Steuern, Zahlungen, Mitarbeiter und Kunde; loyverse_get_receipt liest einen Beleg über seine Nummer. Schichten und Bargeld: loyverse_list_shifts und loyverse_get_shift (Bargeldbewegungen, erwarteter und tatsächlicher Kassenbestand, Brutto- und Nettoumsatz, Steuern, Zahlungen pro Art). Zahlungsarten mit loyverse_list_payment_types und loyverse_get_payment_type. Katalog: loyverse_list_items, loyverse_get_item, Varianten mit SKU, Barcode und Preis pro Filiale mit loyverse_list_variants (Suche per sku) und loyverse_get_variant, Kategorien, Modifikatoren, Rabatte, Steuern und Lieferanten. Bestand: loyverse_list_inventory liefert in_stock pro Variante und Filiale. Kunden mit loyverse_list_customers (Suche per email) und loyverse_get_customer, mit Besuchen, Gesamtumsatz und Treuepunkten; Mitarbeitende mit loyverse_list_employees und loyverse_get_employee; Webhooks mit loyverse_list_webhooks.
Was er schreibt: loyverse_create_receipt erfasst einen Verkauf, der woanders stattfand, etwa in einem anderen Kanal: Er verringert den Bestand bestandsgeführter Artikel und zählt in den Berichten, und seine Zahlungen müssen die Belegsumme ergeben. Die Save-Tools legen einen Datensatz ohne id an und aktualisieren ihn mit id: loyverse_save_item, loyverse_save_variant, loyverse_save_category, loyverse_save_discount, loyverse_save_tax und loyverse_save_customer (total_points setzt den Punktestand). Ein Update ersetzt den ganzen Datensatz, deshalb liest die KI ihn vorher und schickt jedes Feld mit, das erhalten bleiben soll. loyverse_set_inventory nimmt in stock_after die neue absolute Menge, keine Differenz. loyverse_create_webhook abonniert eine HTTPS-URL für ein Ereignis (Belege, Artikel, Kunden, Bestandsänderungen oder geschlossene Schichten); Ereignistyp plus URL müssen eindeutig sein. Vor einem Beleg oder einer Bestandsänderung zeigt dir die KI Positionen, Beträge oder neue Bestände und wartet auf dein Ja.
Bei der Installation deaktiviert: loyverse_refund_receipt, loyverse_delete_item und loyverse_delete_customer. Sie lassen sich nicht rückgängig machen, deshalb schaltet ein Workspace-Admin sie ein, wenn das Team sie braucht.
Datenformate: IDs sind UUIDs; Belege werden über receipt_number angesprochen (z. B. 1-1001). Geldbeträge sind Dezimalzahlen in der Kontowährung (siehe loyverse_get_merchant). Belege haben receipt_type SALE oder REFUND; Erstattungen tragen positive Beträge, deshalb zieht die KI sie beim Summieren der Verkäufe ab, und cancelled_at markiert stornierte Belege. Alle Zeiten sind UTC (ISO 8601); die KI rechnet sie in die Zeitzone der Filiale um, bevor sie nach Tagen gruppiert. Im Back Office gelöschte Datensätze sind ausgeblendet, außer show_deleted ist true.
Blättern: Listen-Tools liefern limit Datensätze (Standard 50, höchstens 250) und einen cursor, solange es weitere gibt; die KI gibt ihn als cursor zurück, bis er fehlt. Filialen, Kassengeräte, Zahlungsarten, Rabatte und Steuern kommen auf einmal.
Limits und häufige Fehler: 300 Anfragen pro 300 Sekunden pro Konto; darüber antwortet Loyverse mit 429 RATE_LIMITED. Fehler kommen als errors: [{code, details, field}]. 401 UNAUTHORIZED bedeutet ein falsches oder abgelaufenes Token: Kopiere es erneut oder lege ein neues an. 402 PAYMENT_REQUIRED bedeutet, dass das Abo oder das Add-on mit der API abgelaufen ist. 403 FORBIDDEN, 404 NOT_FOUND eine falsche ID, 400 INVALID_VALUE oder MISSING_REQUIRED_PARAMETER mit dem betroffenen Feld.
Mit den Tools, die bei der Installation aktiv sind, erstattet der Connector keine Belege und löscht nichts. Filialen, Kassengeräte, Zahlungsarten, Mitarbeitende, Modifikatoren und Lieferanten liest er nur, und Webhooks entfernt er nicht.
Voraussetzungen: LOYVERSE_ACCESS_TOKEN
Connector lokal 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
Öffne http://localhost:3000/connectors/store, wähle Loyverse und trage die unter Voraussetzungen aufgelisteten Variablen ein.
Verfügbare Tools
| 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 |
Beispiel-Prompts
- „Wie hoch war gestern der Nettoumsatz pro Filiale, Erstattungen abgezogen?“
- „Zeig mir die letzte geschlossene Schicht der Filiale Innenstadt mit erwartetem und tatsächlichem Kassenbestand.“
- „Welche Varianten haben in der Filiale Innenstadt weniger als 5 Stück auf Lager?“
- „Setz den Bestand von SKU LATTE-CUP-12 in der Filiale Innenstadt auf 200. Zeig mir vorher den aktuellen Stand.“
- „Finde den Kunden mit der E-Mail [email protected] und zeig seine Besuche, seinen Gesamtumsatz und seine Punkte.“
Nächste Schritte
War dieser Guide hilfreich?