Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте Loyverse одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
Бэк-офис кассовой системы Loyverse: чеки продаж и возвратов, смены и наличные, товары с вариантами, категории, модификаторы, скидки и налоги, остатки по магазинам, клиенты программы лояльности, сотрудники, магазины, POS-устройства, способы оплаты, поставщики и вебхуки. Возвраты и удаление при установке отключены.
Попробуй спросить
Примеры промптов для Loyverse
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Loyverse, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Loyverse
Бэк-офис кассовой системы Loyverse: чеки продаж и возвратов, смены и наличные, товары с вариантами, категории, модификаторы, скидки и налоги, остатки по магазинам, клиенты программы лояльности, сотрудники, магазины, POS-устройства, способы оплаты, поставщики и вебхуки. Возвраты и удаление при установке отключены.
Настройка
Настройка занимает около 2 минут. Нужен вход владельца аккаунта Loyverse.
- Войдите в Loyverse Back Office как владелец и откройте Settings, Access tokens (
https://r.loyverse.com/dashboard/#/integrations/tokens). На некоторых тарифах access tokens входят в дополнение Integrations. - Нажмите Add access token, укажите имя и при желании срок действия и сохраните. Скопируйте токен.
- Вставьте его в
LOYVERSE_ACCESS_TOKEN. Он передаётся какAuthorization: Bearer <token>и даёт полный доступ к аккаунту, поэтому держите его в тайне. - Установите коннектор и запустите
loyverse_get_merchant: он покажет название бизнеса и валюту и подтвердит токен.
Коннектор работает с Loyverse API v1.0 по адресу https://api.loyverse.com/v1.0, API бэк-офиса кассовой системы Loyverse.
Что он читает: аккаунт через loyverse_get_merchant (валюта и число знаков после запятой), магазины через loyverse_list_stores и loyverse_get_store, POS-устройства через loyverse_list_pos_devices. Продажи: loyverse_list_receipts по магазину и диапазону дат (created_at_min/created_at_max) или номерам чеков, сначала новые, с позициями, скидками, налогами, платежами, сотрудником и клиентом; loyverse_get_receipt читает один чек по номеру. Смены и наличные: loyverse_list_shifts и loyverse_get_shift (движение наличных, ожидаемая и фактическая сумма в кассе, валовые и чистые продажи, налоги, платежи по типам). Способы оплаты через loyverse_list_payment_types и loyverse_get_payment_type. Каталог: loyverse_list_items, loyverse_get_item, варианты с SKU, штрихкодом и ценой по магазинам через loyverse_list_variants (поиск по sku) и loyverse_get_variant, категории, модификаторы, скидки, налоги и поставщики. Остатки: loyverse_list_inventory даёт in_stock по варианту и магазину. Клиенты через loyverse_list_customers (поиск по email) и loyverse_get_customer, с визитами, суммой покупок и баллами лояльности; сотрудники через loyverse_list_employees и loyverse_get_employee; вебхуки через loyverse_list_webhooks.
Что он записывает: loyverse_create_receipt записывает продажу, сделанную в другом месте, например в другом канале: она уменьшает остаток товаров с учётом остатков и попадает в отчёты, а сумма её платежей должна совпадать с итогом чека. Инструменты сохранения создают запись без id и обновляют её с id: loyverse_save_item, loyverse_save_variant, loyverse_save_category, loyverse_save_discount, loyverse_save_tax и loyverse_save_customer (total_points задаёт баланс баллов). Обновление заменяет запись целиком, поэтому ИИ сначала её читает и передаёт все поля, которые нужно сохранить. loyverse_set_inventory принимает в stock_after новое абсолютное количество, а не разницу. loyverse_create_webhook подписывает HTTPS-адрес на одно событие (чеки, товары, клиенты, изменения остатков или закрытые смены); сочетание типа события и адреса должно быть уникальным. Перед созданием чека или изменением остатков ИИ показывает позиции, суммы или новые значения и ждёт вашего «да».
Отключены при установке: loyverse_refund_receipt, loyverse_delete_item и loyverse_delete_customer. Их нельзя отменить, поэтому администратор workspace включает их, когда они нужны команде.
Форматы данных: id это UUID; чеки указываются через receipt_number (например, 1-1001). Деньги это десятичное число в валюте аккаунта (см. loyverse_get_merchant). У чеков receipt_type SALE или REFUND; возвраты идут с положительными суммами, поэтому ИИ вычитает их при подсчёте продаж, а cancelled_at отмечает отменённые чеки. Всё время в UTC (ISO 8601); перед группировкой по дням ИИ переводит его в часовой пояс магазина. Записи, удалённые в Back Office, скрыты, если show_deleted не true.
Постраничный вывод: инструменты списков возвращают limit записей (по умолчанию 50, не более 250) и cursor, пока есть ещё; ИИ передаёт его обратно как cursor, пока он не исчезнет. Магазины, POS-устройства, способы оплаты, скидки и налоги приходят сразу целиком.
Лимиты и частые ошибки: 300 запросов за 300 секунд на аккаунт; сверх этого Loyverse отвечает 429 RATE_LIMITED. Ошибки приходят как errors: [{code, details, field}]. 401 UNAUTHORIZED означает неверный или просроченный токен: скопируйте его заново или создайте новый. 402 PAYMENT_REQUIRED означает, что истекла подписка или дополнение, в которое входит API. 403 FORBIDDEN, 404 NOT_FOUND неверный id, 400 INVALID_VALUE или MISSING_REQUIRED_PARAMETER с указанием поля.
С инструментами, включёнными при установке, коннектор не делает возвраты по чекам и ничего не удаляет. Магазины, POS-устройства, способы оплаты, сотрудников, модификаторы и поставщиков он только читает, не создавая и не меняя их, и не удаляет вебхуки.
Предварительные требования: LOYVERSE_ACCESS_TOKEN
Локальная установка коннектора
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
Откройте http://localhost:3000/connectors/store, выберите Loyverse и введите переменные, перечисленные в Предварительных требованиях.
Доступные инструменты
| 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 |
Примеры запросов
- «Какими были вчера чистые продажи по каждому магазину за вычетом возвратов?»
- «Покажи последнюю закрытую смену в магазине Центр с ожидаемой и фактической суммой наличных.»
- «У каких вариантов в магазине Центр осталось меньше 5 штук?»
- «Установи остаток SKU LATTE-CUP-12 в магазине Центр на 200. Сначала покажи текущее значение.»
- «Найди клиента с email [email protected] и покажи его визиты, сумму покупок и баллы.»
Следующие шаги
Это руководство помогло?