Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте Clover одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
Кассовая система Clover (Fiserv) для одного мерчанта: данные и настройки бизнеса, товары с остатками, категории, налоговые ставки, скидки и модификаторы, заказы с позициями, платежи, возвраты и способы оплаты, клиенты, сотрудники и смены. Создаёт и обновляет товары, остатки, категории, заказы и клиентов. Северная Америка, Европа, Латинская Америка или песочница.
Попробуй спросить
Примеры промптов для Clover
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Clover, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Clover
Кассовая система Clover (Fiserv) для одного мерчанта: данные и настройки бизнеса, товары с остатками, категории, налоговые ставки, скидки и модификаторы, заказы с позициями, платежи, возвраты и способы оплаты, клиенты, сотрудники и смены. Создаёт и обновляет товары, остатки, категории, заказы и клиентов. Северная Америка, Европа, Латинская Америка или песочница.
Настройка
Настройка занимает около 5 минут. Нужен аккаунт мерчанта Clover (или тестовый мерчант) и администратор, который может создавать API-токены.
- Войдите в 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).
- Вставьте токен в
CLOVER_API_TOKEN. Он передаётся какAuthorization: Bearer <token>. - Укажите в
CLOVER_MERCHANT_ID13-символьный id мерчанта (mId). Он виден в адресе панели.../merchants/<mId>/...и в Account and setup, Merchants. - Укажите в
CLOVER_API_URLрегион мерчанта:https://api.clover.com(Северная Америка),https://api.eu.clover.com(Европа),https://api.la.clover.com(Латинская Америка) илиhttps://apisandbox.dev.clover.com(песочница). - Установите коннектор и запустите
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. Налоговые ставки, скидки, группы модификаторов, сотрудников и смены он только читает и, с инструментами, включёнными при установке, ничего не удаляет.
Предварительные требования: CLOVER_API_TOKEN, CLOVER_MERCHANT_ID, CLOVER_API_URL
Локальная установка коннектора
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, выберите Clover и введите переменные, перечисленные в Предварительных требованиях.
Доступные инструменты
| Tool | What it does |
|---|---|
clover_get_merchant | Get the merchant behind the token: business name, address, phone, website, owner and default currency |
clover_get_merchant_address | Get the business address of the merchant: street lines, city, state, zip and country, as stored in Clover |
clover_get_merchant_properties | Get merchant settings: default currency, time zone, locale, tips and tax settings, receipt and order options |
clover_list_order_types | List order types of the merchant (dine in, take out, delivery and custom ones) with label, taxable flag, fee and hours |
clover_list_roles | List the employee roles of the merchant (admin, manager, employee and custom roles) with their system role and employees |
clover_list_items | List inventory items with name, price, price type, SKU, code, cost, stock tracking and visibility |
clover_get_item | Get one inventory item by id with price, price type, SKU, code, cost and, when expanded, categories, tax rates, modifier groups and stock |
clover_create_item | Create an inventory item. price is in cents (1999 = 19.99) and required; priceType FIXED, VARIABLE (entered at sale) or PER_UNIT |
clover_update_item | Update an inventory item (Clover updates with POST): name, price in cents, SKU, code, cost, visibility or categories |
clover_list_item_stocks | List the stock of all inventory items: item id, quantity on hand (decimal) and the low-stock alert threshold |
clover_get_item_stock | Get the stock of one inventory item: quantity on hand, stock alert threshold and when it last changed |
clover_update_item_stock | Set the stock of an inventory item to a new absolute quantity (not a change) |
clover_list_categories | List item categories with name, sort order and colour; expand items to get the items in each category |
clover_get_category | Get one item category by id with name, sort order and colour; expand items to list its items |
clover_list_category_items | List the items in one category with price, SKU and, when expanded, stock, tax rates and modifier groups |
clover_create_category | Create an item category shown on the register, with a name, sort order and colour |
clover_update_category | Rename a category or change its sort order or colour (Clover updates with POST). name is required by the API |
clover_list_tax_rates | List tax rates with name, rate (in units of 1/100000, so 825000 = 8.25%), flat amount, type and whether it is the default |
clover_list_discounts | List the predefined discounts of the merchant: name, amount in cents (negative) or percentage |
clover_list_modifier_groups | List modifier groups (e.g |
clover_list_orders | List orders with state, total in cents, payment state, employee, order type and times |
clover_get_order | Get one order by id with total, state, payment state and, when expanded, line items, discounts, payments, refunds and customers |
clover_create_atomic_order | Create a complete order in one call from an order cart: line items (inventory items or ad hoc), modifiers, discounts and service charge… |
clover_calculate_order | Calculate an order cart without saving it: totals, taxes, discounts and service charges for the same cart as clover_create_atomic_order |
clover_create_order | Create an empty custom order (title, note, state, order type), then add lines with clover_add_line_item |
clover_update_order | Update an order (Clover updates with POST): title, note, state, order type or tax removal |
clover_list_order_line_items | List the line items of an order with name, price in cents, quantity, discounts, modifications and refund state |
clover_get_order_line_item | Get one line item of an order with name, price in cents, unit quantity, note, discounts and modifications |
clover_add_line_item | Add a line item to an order: an inventory item by id, or an ad hoc line with name and price in cents. unitQty is quantity x 1000 for… |
clover_void_line_item | Remove (void) a line item from an order |
clover_list_order_discounts | List the order-level discounts applied to an order with name, amount in cents or percentage and approver |
clover_add_order_discount | Apply a discount to a whole order: a name plus an amount in cents (negative, e.g. -500) or a percentage, or a predefined discount by id |
clover_delete_order | Delete an order |
clover_list_payments | List payments with amount, tip and tax in cents, result (SUCCESS, FAIL and so on), tender, card type, order and employee |
clover_get_payment | Get one payment by id with amount, tip, tax, cash back in cents, result, tender, card transaction details and refunds |
clover_list_order_payments | List the payments made on one order with amount, tip and tax in cents, result, tender and card details |
clover_list_employee_payments | List the payments taken by one employee, with amount, tip and tax in cents, result and tender |
clover_list_refunds | List refunds with amount and tax in cents, the payment and order they belong to, employee and time |
clover_get_refund | Get one refund by id with amount, tax and tip in cents, the refunded payment, line items and employee |
clover_list_tenders | List tenders (payment methods such as cash, credit card, debit card, check, gift card, external) with label, label key and whether enabled |
clover_get_tender | Get one tender (payment method) by id with label, label key, instructions and whether it opens the cash drawer |
clover_list_customers | List customers with name, customer since and marketing consent; expand emailAddresses, phoneNumbers and addresses for contact data |
clover_get_customer | Get one customer by id with name, customer since, marketing consent and, when expanded, emails, phone numbers, addresses and notes |
clover_create_customer | Create a customer with name, email addresses, phone numbers, addresses and marketing consent |
clover_update_customer | Update a customer (Clover updates with POST): name, marketing consent or metadata such as business name and note |
clover_delete_customer | Delete a customer with their contact data |
clover_list_employees | List employees with name, nickname, email, role, PIN-protected flags and custom id; expand roles or shifts |
clover_get_employee | Get one employee by id with name, nickname, email, role and, when expanded, roles and shifts |
clover_list_shifts | List clock-in and clock-out shifts of all employees with in time, out time and overrides |
clover_list_employee_shifts | List the clock-in and clock-out shifts of one employee with in time, out time and overrides, newest first |
Примеры запросов
- «Какой была вчерашняя выручка и сколько чаевых, с разбивкой по способам оплаты? Считай по нашему часовому поясу.»
- «У каких товаров с учётом остатков осталось меньше 10 штук? Покажи название, SKU и количество.»
- «Измени цену товара Cappuccino на 4,20. Перед сохранением покажи старую и новую цену.»
- «Посчитай заказ из 2 пицц Маргарита и 1 лимонада с нашей скидкой для персонала, покажи итог и потом создай его.»
- «Выведи возвраты за последние 30 дней с суммой, исходным заказом и сотрудником.»
Следующие шаги
Это руководство помогло?