Кратко
Управление ресторанами iiko и Syrve через iikoCloud API (Syrve Cloud API): организации и группы терминалов, меню и внешние меню, стоп-листы, заказы на доставку и столы, резервирования, курьеры, типы заказов и платежей, скидки и лояльные клиенты. Вход в API из веб-офиса.
Пошаговая настройка
Подключи iiko к Claude, ChatGPT или Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи iiko в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для iiko
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → iiko, вставь API логин и выбери iiko или Syrve в качестве хоста API и путей лояльности, создай ключ API MCP и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
iiko
Управление ресторанами iiko и Syrve через iikoCloud API (Syrve Cloud API): организации и группы терминалов, меню и внешние меню, стоп-листы, заказы на доставку и столы, резервирования, курьеры, типы заказов и платежей, скидки и лояльные клиенты. Вход в API из веб-офиса.
Настройка
Настройка занимает около 5 минут.
- Войди в веб-офис (iikoWeb для iiko, Syrve Web / Syrve App для Syrve) как администратор и открой настройки облачного API (Интеграции, API ключи; называется Настройки API или Настройки Live API в старых версиях).
- Создай API логин (API ключ) для этого коннектора: дай ему имя, выбери организации, к которым он может обращаться, и дату истечения (не более 2 лет). Скопируй ключ; новый ключ состоит из 36 символов и может быть показан только один раз.
- Вставь его в
IIKO_API_LOGIN. Выбери свой продукт дважды: хост API вIIKO_API_HOSTи тот же продукт вIIKO_LOYALTY_API(iiko и Syrve по-разному называют пути лояльности). - По желанию: вставь id своего основного ресторана в
IIKO_ORGANIZATION_IDпосле первого вызоваiiko_list_organizations, чтобы инструменты, которые принимают одну организацию, могли его пропустить.
Коннектор обменивает API логин на /api/1/access_token на токен доступа, который действует 1 час и обновляется самостоятельно. iiko помечает этот вызов логина как устаревший в пользу /api/v2/access_token, который также требует зарегистрированное приложение в портале разработчиков; если iiko отключит старый вызов, проверка настройки сообщит о неудачном входе.
С чего начать: iiko_list_organizations дает id организаций, которые нужны каждому другому инструменту. iiko_list_terminal_groups перечисляет POS установки организации, а iiko_check_terminal_groups_alive сообщает, находятся ли они онлайн.
Меню: iiko_list_external_menus и iiko_get_external_menu читают меню, подготовленные для каналов доставки, с ценами по организациям. iiko_get_nomenclature читает полное меню из бэк-офиса (большое; задокументировано для Syrve, больше не в справочнике iiko, поэтому предпочтительно использовать внешнее меню в iiko). iiko_get_stop_lists показывает, что отсутствует на складе по группе терминалов; iiko_add_to_stop_list и iiko_remove_from_stop_list изменяют его и установлены выключенными (им нужен API логин с дополнительным правом на стоп-лист).
Заказы на доставку: iiko_list_deliveries_by_date_and_status (ежедневный обзор), iiko_search_deliveries (текстовый поиск и фильтр проблем), iiko_list_deliveries_by_phone, iiko_get_deliveries_by_id. Эти данные гарантированы за последние 7 дней; iiko_list_delivery_history_by_phone охватывает 90 дней. Статусы: Не подтверждено, Ожидание приготовления, Готово к приготовлению, Приготовление начато, Приготовление завершено, Ожидание, В пути, Доставлено, Закрыто, Отменено. iiko_create_delivery и iiko_cancel_delivery установлены выключенными: созданный заказ попадает на кухню, а отмену нельзя отменить.
Заказы на столы и резервирования: iiko_get_table_orders_by_id и iiko_list_table_orders_by_table читают заказы на еду на месте. Для резервирования, iiko_list_reserve_terminal_groups, затем iiko_list_restaurant_sections (залы и столы), iiko_list_reserves (что забронировано с определенного времени) и iiko_get_reserves_by_id (детали). Коннектор не создает резервирования.
Словари: iiko_list_order_types, iiko_list_payment_types, iiko_list_discounts, iiko_list_cancel_causes, iiko_list_couriers. Они редко меняются: читай их один раз за разговор, а не за заказ.
Лояльность: iiko_get_customer находит гостя по телефону, электронной почте или карте и показывает балансы кошелька; iiko_list_customer_transactions перечисляет движения бонусов; iiko_list_customer_categories и iiko_list_loyalty_programs описывают программу. iiko_create_or_update_customer сохраняет основные данные гостя. Коннектор никогда не пополняет, не удерживает и не списывает кошелек и не фиксирует платежи.
Команды: создание или отмена доставки и изменение ответа стоп-листа одновременно с correlationId; POS выполняет команду позже. Читай результат с помощью iiko_get_command_status (В процессе, Успех, Ошибка).
Форматы: id — это UUID. Даты в формате yyyy-MM-dd HH:mm:ss.fff без часового пояса: время заказов и резервирований локально для терминала (см. часовой пояс в iiko_list_terminal_groups), даты отчетов по лояльности — UTC. Суммы в валюте организации. Почти каждый вызов — это POST с телом JSON, также и чтения.
Ограничения: iiko группирует методы (словарь, меню, стоп-листы, чтение заказов и другие) и ограничивает каждую группу по временным интервалам, обычно одной минуте; превышение лимита приводит к тому, что каждый вызов этой группы отвечает 429 до окончания интервала. Лимиты для методов заказов и стоп-листов увеличиваются с количеством ресторанов. Запрашивай несколько организаций в одном вызове вместо одного вызова для каждой, кэшируй словари и меню и не опрашивай отдельные заказы. Повторяющиеся идентичные или неудачные запросы в большом объеме могут привести к блокировке API логина.
Ошибки: ответ с ошибкой содержит errorDescription и часто error (код) плюс correlationId, чтобы сослаться на поддержку iiko. 401 означает, что токен или API логин были отклонены, 400 указывает на неправильное поле, 408 означает, что POS не ответил вовремя (ресторан может быть оффлайн).
Предварительные требования: IIKO_API_HOST, IIKO_LOYALTY_API, IIKO_API_LOGIN
Установи коннектор локально
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, выбери iiko и вставь переменные окружения, указанные в предварительных требованиях.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
iiko_list_organizations | Перечисляет организации (рестораны), к которым может обратиться API логин: id, имя и код, плюс страна, адрес, координаты, настройки часового пояса… |
iiko_list_terminal_groups | Перечисляет группы терминалов (установки POS, к которым отправляются заказы) одной или нескольких организаций: по организации группы с id… |
iiko_check_terminal_groups_alive | Проверяет, находятся ли группы терминалов онлайн прямо сейчас: для каждой группы терминалов isAlive true или false. Используй это перед тем, как сказать кому-то о ресторане… |
iiko_get_nomenclature | Читает полное меню (номенклатуру) одной организации, экспортированное из бэк-офиса: группы, категории продуктов, продукты (блюда… |
iiko_list_external_menus | Перечисляет внешние меню (меню, подготовленные для сайтов и приложений доставки в веб-офисе) и ценовые категории аккаунта: id… |
iiko_get_external_menu | Читает одно внешнее меню с его категориями товаров, товарами, размерами, ценами по организациям, группами модификаторов, аллергенами, питательными веществами… |
iiko_get_stop_lists | Читает стоп-листы (товары, отсутствующие на складе): по организации и группе терминалов товары с productId, sizeId, sku, остаток (оставшиеся… |
iiko_list_order_types | Перечисляет типы заказов по организации: id, имя, orderServiceType (Общий для заказов на стол, Доставка курьером, Доставка клиентом для… |
iiko_list_payment_types | Перечисляет типы платежей: id, код, имя, paymentTypeKind (Наличные, Карта, Внешний, Карта лояльности и другие), paymentProcessingType, терминал… |
iiko_list_discounts | Перечисляет скидки и надбавки, установленные в бэк-офисе по организации: id, имя, процент или фиксированная сумма, режим, минимальная сумма заказа… |
iiko_list_cancel_causes | Перечисляет причины отмены доставки: id, имя и isDeleted. Для отмены доставки нужен id. Только для чтения; кэшируй ответ |
iiko_list_deliveries_by_date_and_status | Перечисляет заказы на доставку и самовывоз по дате доставки и статусу: по организации заказы с id, posId, creationStatus и заказ… |
iiko_list_deliveries_by_phone | Находит недавние заказы на доставку по номеру телефона (гарантировано за последние 7 дней): те же детали заказа, что и… |
iiko_list_delivery_history_by_phone | Находит старые заказы на доставку по номеру телефона в истории заказов (хранятся 90 дней): те же детали заказа, сгруппированные по организации, максимум… |
iiko_search_deliveries | Ищет заказы на доставку по тексту (поиск по префиксу номера заказа, имени клиента, телефону или адресу) с фильтрами по дате, статусу, типу услуги… |
iiko_get_deliveries_by_id | Читает до 200 заказов на доставку по id: creationStatus (Успех, В процессе, Ошибка с errorInfo) и полный заказ со статусом, клиентом… |
iiko_get_table_orders_by_id | Читает заказы на стол (на месте) по id: creationStatus и заказ со столами, статусом (Новый, Счет, Закрыт, Удален), официантом, клиентом… |
iiko_list_table_orders_by_table | Перечисляет заказы на стол (на месте) для заданных столов, опционально по статусу и дате создания: те же детали, что и iiko_get_table_orders_by_id.… |
iiko_list_reserve_terminal_groups | Перечисляет группы терминалов заданных организаций, которые принимают резервирования столов и банкетов: id, имя, адрес и часовой пояс, а также… |
iiko_list_restaurant_sections | Перечисляет секции ресторана (залы) групп терминалов, которые принимают резервирования, с их столами: id секции и имя, а также для каждого стола id… |
iiko_list_reserves | Перечисляет резервирования и банкеты, забронированные в секциях ресторана с заданного времени: id, tableIds, estimatedStartTime, durationInMinutes и… |
iiko_get_reserves_by_id | Читает резервирования и банкеты по id: creationStatus, isDeleted и резерв с клиентом, телефоном, количеством гостей, столами, предполагаемым началом… |
iiko_list_couriers | Перечисляет сотрудников, которые являются курьерами доставки, по организации: id, имя, фамилия, отображаемое имя, код и isDeleted. Только для чтения |
iiko_get_customer | Находит одного клиента лояльности (гостя) по телефону, электронной почте, номеру карты, треку карты или id: id, имя, фамилия, телефон, электронная почта, день рождения, пол… |
iiko_list_customer_categories | Перечисляет категории клиентов (гостей) программы лояльности организации: id, имя, isActive и isDefaultForNewGuests. Только для чтения |
iiko_list_loyalty_programs | Перечисляет программы лояльности организации: id, имя, описание, programType, isActive, даты действия, walletId и маркетинг… |
iiko_list_customer_transactions | Перечисляет транзакции лояльности одного клиента за период (начисления и списания бонусов, пополнения кошелька, купоны): тип, имя типа, сумма… |
iiko_create_or_update_customer | Создает клиента лояльности или обновляет найденного по id, телефону или карте: имя, телефон, электронная почта, день рождения, пол, комментарий, статус согласия и… |
iiko_get_command_status | Проверяет результат команды (создание или отмена доставки, изменение стоп-листа): состояние В процессе, Успех или Ошибка с… |
iiko_create_delivery | Создает заказ на доставку или самовывоз в POS. Это команда: ответ содержит correlationId и orderInfo с creationStatus… |
iiko_cancel_delivery | Отменяет заказ на доставку с причиной отмены. Это нельзя отменить, и уже распечатанные товары списываются. Это команда: проверь… |
iiko_add_to_stop_list | Добавляет продукты в стоп-лист одной группы терминалов с оставшимся количеством (0 для распроданных). Гости больше не могут заказывать распроданные… |
iiko_remove_from_stop_list | Убирает продукты из стоп-листа одной группы терминалов, чтобы их можно было заказывать снова. Нужен API логин с дополнительным правом на изменение стоп… |
Примеры запросов
- "Какие заказы на доставку с сегодняшнего дня все еще не в пути, по ресторанам?"
- "Что сейчас в стоп-листе каждой группы терминалов?"
- "Все ли наши группы терминалов POS онлайн?"
- "Покажи резервирования на сегодня с 18:00 в основном ресторане, с залом и столом."
- "Найди гостя с телефоном 79161234567 и покажи баланс бонусов и последние транзакции."
Следующие шаги
Это руководство помогло?