Руководство по коннектору8 мин чтенияMCP-инструментов: 337 языков

iiko MCP-сервер: меню, заказы и бронирования

Управление ресторанами iiko и Syrve через iikoCloud API (Syrve Cloud API): организации и группы терминалов, меню и внешние меню, стоп-листы, заказы на доставку и столы, резервирования, курьеры, типы заказов и платежей, скидки и лояльные клиенты. Вход в API из веб-офиса.

HCАвтор: команда HelpCodeОбновлено 8 мин чтения Открытый код на GitHub

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

iiko

iiko

iiko and Syrve restaurant management through the iikoCloud API (Syrve Cloud API): organizations and terminal groups, menu and external menus, stop lists, delivery and table orders, reservations, couriers, order and payment types, discounts and loyalty customers. API login from the web back office.

инструментов

33

Регион

INTL

Категория

Электронная коммерция

Аутентификация

Sign-in token

Требуемые env-vars

IIKO_API_HOSTIIKO_LOYALTY_APIIIKO_API_LOGIN
Установить в Cloud одним кликом

7 дней бесплатно · Без карты

  • 7 дней бесплатно
    Без банковской карты
  • GDPR и готовность к SOC 2
    Данные в ЕС, журналы аудита
  • Открытый код на GitHub
    Open source · AGPL-3.0
  • Работает с ChatGPT, Claude, Gemini
    Любой MCP-совместимый клиент

Кратко

Управление ресторанами 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 и запусти через этот коннектор.

iiko · live via MCP
Поделиться
Opus 4.7

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 минут.

  1. Войди в веб-офис (iikoWeb для iiko, Syrve Web / Syrve App для Syrve) как администратор и открой настройки облачного API (Интеграции, API ключи; называется Настройки API или Настройки Live API в старых версиях).
  2. Создай API логин (API ключ) для этого коннектора: дай ему имя, выбери организации, к которым он может обращаться, и дату истечения (не более 2 лет). Скопируй ключ; новый ключ состоит из 36 символов и может быть показан только один раз.
  3. Вставь его в IIKO_API_LOGIN. Выбери свой продукт дважды: хост API в IIKO_API_HOST и тот же продукт в IIKO_LOYALTY_API (iiko и Syrve по-разному называют пути лояльности).
  4. По желанию: вставь 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 и покажи баланс бонусов и последние транзакции."

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

Это руководство помогло?

Подключи iiko к Claude, ChatGPT или Copilot за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи iiko в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.

Похожие руководства

Коннекторы

Подключи iiko MCP к ChatGPT: заказы и меню

Управление ресторанами iiko и Syrve через iikoCloud API (Syrve Cloud API): организации и группы терминалов, меню и внешние меню, стоп-листы, заказы на доставку и столы, бронирования, курьеры, типы заказов и платежей, скидки и лояльные клиенты. Вход в API из веб-админки.

Коннекторы

Подключи iiko MCP к Claude: заказы и меню

Управление ресторанами iiko и Syrve через iikoCloud API (Syrve Cloud API): организации и группы терминалов, меню и внешние меню, стоп-листы, заказы на доставку и столы, бронирования, курьеры, типы заказов и платежей, скидки и лояльные клиенты. Вход в API из веб-админки.

Коннекторы

Подключи iiko MCP к Microsoft Copilot

Управление ресторанами iiko и Syrve через iikoCloud API (Syrve Cloud API): организации и группы терминалов, меню и внешние меню, стоп-листы, заказы на доставку и столы, бронирования, курьеры, типы заказов и платежей, скидки и лояльные клиенты. Вход в API из веб-админки.

Коннекторы

Подключи iiko MCP к Cursor: заказы и меню

Управление ресторанами iiko и Syrve через iikoCloud API (Syrve Cloud API): организации и группы терминалов, меню и внешние меню, стоп-листы, заказы на доставку и столы, бронирования, курьеры, типы заказов и платежей, скидки и лояльные клиенты. Вход в API из веб-админки.

Коннекторы

Подключи iiko MCP к Gemini CLI: заказы и меню

Управление ресторанами iiko и Syrve через iikoCloud API (Syrve Cloud API): организации и группы терминалов, меню и внешние меню, стоп-листы, заказы на доставку и столы, бронирования, курьеры, типы заказов и платежей, скидки и лояльные клиенты. Вход в API из веб-админки.

Коннекторы

Подключи iiko MCP к Meta Muse: заказы и меню

Управление ресторанами iiko и Syrve через iikoCloud API (Syrve Cloud API): организации и группы терминалов, меню и внешние меню, стоп-листы, заказы на доставку и столы, бронирования, курьеры, типы заказов и платежей, скидки и лояльные клиенты. Вход в API из веб-админки.