Как подключить Loyverse к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Loyverse, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Loyverse + Gemini

Бэк-офис кассовой системы Loyverse: чеки продаж и возвратов, смены и наличные, товары с вариантами, категории, модификаторы, скидки и налоги, остатки по магазинам, клиенты программы лояльности, сотрудники, магазины, POS-устройства, способы оплаты, поставщики и вебхуки. Возвраты и удаление при установке отключены.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

LOYVERSE_ACCESS_TOKEN

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужен вход владельца аккаунта Loyverse.

1. Войдите в Loyverse Back Office как владелец и откройте Settings, Access tokens (https://r.loyverse.com/dashboard/#/integrations/tokens). На некоторых тарифах access tokens входят в дополнение Integrations.
2. Нажмите Add access token, укажите имя и при желании срок действия и сохраните. Скопируйте токен.
3. Вставьте его в LOYVERSE_ACCESS_TOKEN. Он передаётся как Authorization: Bearer <token> и даёт полный доступ к аккаунту, поэтому держите его в тайне.
4. Установите коннектор и запустите 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-устройства, способы оплаты, сотрудников, модификаторы и поставщиков он только читает, не создавая и не меняя их, и не удаляет вебхуки.

Шаг 2 — Установите адаптер

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

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Loyverse.

Доступные инструменты

Примеры запросов

• «Какими были вчера чистые продажи по каждому магазину за вычетом возвратов?»
• «Покажи последнюю закрытую смену в магазине Центр с ожидаемой и фактической суммой наличных.»
• «У каких вариантов в магазине Центр осталось меньше 5 штук?»
• «Установи остаток SKU LATTE-CUP-12 в магазине Центр на 200. Сначала покажи текущее значение.»
• «Найди клиента с email [email protected] и покажи его визиты, сумму покупок и баллы.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot