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

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

Clover + Cursor

Кассовая система Clover (Fiserv) для одного мерчанта: данные и настройки бизнеса, товары с остатками, категории, налоговые ставки, скидки и модификаторы, заказы с позициями, платежи, возвраты и способы оплаты, клиенты, сотрудники и смены. Создаёт и обновляет товары, остатки, категории, заказы и клиентов. Северная Америка, Европа, Латинская Америка или песочница.

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

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

CLOVER_API_TOKEN, CLOVER_MERCHANT_ID, CLOVER_API_URL

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

Настройка занимает около 5 минут. Нужен аккаунт мерчанта Clover (или тестовый мерчант) и администратор, который может создавать API-токены.

1. Войдите в Clover Merchant Dashboard как администратор и откройте Settings, View all settings, API tokens (в разделе Account and setup, Business operations). Создайте токен и отметьте права, нужные инструментам: Merchant read, Inventory read и write, Orders read и write, Payments read, Customers read и write, Employees read. Для тестового мерчанта сделайте то же самое в Global Developer Dashboard (Test merchants, Launch dashboard).
2. Вставьте токен в CLOVER_API_TOKEN. Он передаётся как Authorization: Bearer <token>.
3. Укажите в CLOVER_MERCHANT_ID 13-символьный id мерчанта (mId). Он виден в адресе панели .../merchants/<mId>/... и в Account and setup, Merchants.
4. Укажите в CLOVER_API_URL регион мерчанта: https://api.clover.com (Северная Америка), https://api.eu.clover.com (Европа), https://api.la.clover.com (Латинская Америка) или https://apisandbox.dev.clover.com (песочница).
5. Установите коннектор и запустите clover_get_merchant: он покажет название бизнеса и подтвердит токен.

Что он читает: мерчанта через clover_get_merchant, clover_get_merchant_address и clover_get_merchant_properties (валюта, часовой пояс, локаль, настройки чаевых и налогов), типы заказов и роли сотрудников; товары через clover_list_items и clover_get_item (цена, тип цены, SKU, код, себестоимость; через expand категории, налоговые ставки, группы модификаторов или остаток), остатки через clover_list_item_stocks и clover_get_item_stock, категории через clover_list_categories, clover_get_category и clover_list_category_items, а также налоговые ставки, готовые скидки и группы модификаторов; заказы через clover_list_orders и clover_get_order (expand lineItems и payments), их позиции и скидки на заказ; платежи через clover_list_payments, clover_get_payment, clover_list_order_payments и clover_list_employee_payments (удобно для чаевых и продаж по сотрудникам), возвраты через clover_list_refunds и clover_get_refund, способы оплаты (tenders) через clover_list_tenders и clover_get_tender; клиентов через clover_list_customers и clover_get_customer (expand emailAddresses, phoneNumbers и addresses); сотрудников через clover_list_employees и clover_get_employee, отметки прихода и ухода через clover_list_shifts и clover_list_employee_shifts.

Что он записывает: товары через clover_create_item и clover_update_item; остаток через clover_update_item_stock, который задаёт абсолютное количество, а не разницу, поэтому ИИ сначала читает текущий остаток; категории через clover_create_category и clover_update_category; клиентов через clover_create_customer и clover_update_customer. Заказ одним вызовом: clover_calculate_order считает итоги, налоги, скидки и сервисные сборы без сохранения, затем clover_create_atomic_order создаёт ту же корзину. Пошагово: clover_create_order, clover_add_line_item, clover_add_order_discount и clover_update_order. Clover обновляет запись запросом POST на её адрес. Заказы и изменения остатков сразу появляются на устройствах и в отчётах мерчанта, поэтому ИИ показывает, что изменит, и ждёт вашего «да».

Отключены при установке: clover_void_line_item, clover_delete_order и clover_delete_customer. Их нельзя отменить, поэтому администратор workspace включает их, когда они нужны команде.

Фильтры: filter принимает список условий вида поле оператор значение, например ["createdTime>=1767225600000", "createdTime<1767830400000"]; они объединяются через AND. Фильтры по времени для заказов, платежей и возвратов охватывают не более 90 дней за запрос, поэтому ИИ делит длинные периоды на окна по 90 дней. expand добавляет связанные записи в тот же вызов (через запятую).

Форматы данных: списки приходят как {elements: [...], href}. Деньги это целое число в центах валюты мерчанта (1999 = 19,99); скидки это отрицательные суммы. Количество в позициях (unitQty) умножено на 1000. Налоговые ставки умножены на 100000 (825000 = 8,25 %). Время в миллисекундах Unix epoch в UTC; ИИ переводит его в часовой пояс из clover_get_merchant_properties. Id это строки из 13 символов.

Постраничный вывод: limit (по умолчанию 100, не более 1000) и offset. Если на странице limit элементов, ИИ запрашивает снова с offset плюс limit. Вложенные списки, загруженные через expand, обрываются на 100 записях.

Лимиты и частые ошибки: 16 запросов в секунду и 5 одновременных запросов на токен; сверх этого Clover отвечает 429 с retry-after. 401 означает неверный или отозванный токен либо не тот регион в CLOVER_API_URL (токен песочницы работает только на apisandbox.dev.clover.com). 403 означает, что у токена нет права на эти данные: отредактируйте токен в Merchant Dashboard и отметьте его. 404 означает неверный id мерчанта или записи. 400 обычно означает недопустимое поле фильтра.

Коннектор не принимает оплату картой и не делает возвраты: это происходит на устройстве Clover или через Clover Ecommerce API. Налоговые ставки, скидки, группы модификаторов, сотрудников и смены он только читает и, с инструментами, включёнными при установке, ничего не удаляет.

Шаг 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 — Добавьте коннектор в Cursor

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

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Clover.

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

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

• «Какой была вчерашняя выручка и сколько чаевых, с разбивкой по способам оплаты? Считай по нашему часовому поясу.»
• «У каких товаров с учётом остатков осталось меньше 10 штук? Покажи название, SKU и количество.»
• «Измени цену товара Cappuccino на 4,20. Перед сохранением покажи старую и новую цену.»
• «Посчитай заказ из 2 пицц Маргарита и 1 лимонада с нашей скидкой для персонала, покажи итог и потом создай его.»
• «Выведи возвраты за последние 30 дней с суммой, исходным заказом и сотрудником.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

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

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