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

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

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

HCАвтор: команда HelpCodeОбновлено 10 мин чтения Открытый код на 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 к Gemini за 2 минуты

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

Без банковской карты · 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 + Gemini

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

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

Смотри полные инструкции по настройке, встроенные в коннектор (видно в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:

IIKO_API_HOST, IIKO_LOYALTY_API, IIKO_API_LOGIN

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

Настройка занимает около 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 дней. Статусы: Unconfirmed, WaitCooking, ReadyForCooking, CookingStarted, CookingCompleted, Waiting, OnWay, Delivered, Closed, Cancelled. 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 (InProgress, Success, Error).

Форматы: 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 не ответил вовремя (ресторан может быть оффлайн).

Шаг 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 теперь может вызывать инструменты 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 (Общий для заказов на стол, DeliveryByCourier, DeliveryByClient для…
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Проверяет результат команды (создание или отмена доставки, изменение стоп-листа): состояние InProgress, Success или Error с…
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 и покажи баланс бонусов и последние транзакции."

Часто задаваемые вопросы

Откуда берется API логин? Администратор входит в веб-админку (iikoWeb для iiko, Syrve Web для Syrve) и открывает Интеграции, API ключи (Настройки API в старых версиях). Создай API логин для коннектора, выбери организации, к которым он может обращаться, и дату истечения не более 2 лет, и скопируй ключ. Затем выбери свой продукт для хоста API и путей лояльности: iiko использует api-ru.iiko.services, Syrve использует api-eu.syrve.live, и ключ работает только на хосте своего продукта.

Что он охватывает? Организации и группы терминалов с их онлайн-статусом, внешние меню с ценами и меню бэк-офиса, стоп-листы, заказы на доставку по дате, статусу, телефону или текстовому поиску, заказы на столы, бронирования с залами и столами, курьеры, типы заказов и платежей, скидки и причины отмены, а также лояльных клиентов с балансами кошельков и транзакциями бонусов. Он сохраняет основные данные клиентов, но никогда не пополняет, не удерживает и не списывает кошелек, не фиксирует платежи и не создает бронирования.

Какие инструменты установлены выключенными? iiko_create_delivery, iiko_cancel_delivery, iiko_add_to_stop_list и iiko_remove_from_stop_list. Созданный заказ сразу попадает на кухню, а отмену нельзя отменить, и инструментам стоп-листа нужен API логин с дополнительным правом на стоп-лист. Включай их на странице коннектора только если ИИ должен их использовать.

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

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

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

Подключи iiko к Gemini за 2 минуты

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

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

Коннекторы

Подключи 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 к Meta Muse: заказы и меню

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

Коннекторы

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

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