Кратко
Управление ресторанами iiko и Syrve через iikoCloud API (Syrve Cloud API): организации и группы терминалов, меню и внешние меню, стоп-листы, заказы на доставку и столы, бронирования, курьеры, типы заказов и платежей, скидки и лояльные клиенты. Вход в API из веб-админки.
Пошаговая настройка
Подключи iiko к Claude за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи iiko в пошаговой настройке и добавь свой MCP URL в Claude. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
AnythingMCP есть в каталоге коннекторов Claude: добавьте его в Claude в один клик (откроется в новой вкладке), затем войдите и выберите, какие MCP-серверы может использовать Claude.
Попробуй спросить
Примеры промптов для iiko
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → iiko, вставь API логин и выбери iiko или Syrve в качестве хоста API и путей лояльности, создай ключ API MCP, и всё готово. Никакого Docker, никакого
git clone, никакого локального сервера.
iiko + Claude
Управление ресторанами iiko и Syrve через iikoCloud API (Syrve Cloud API): организации и группы терминалов, меню и внешние меню, стоп-листы, заказы на доставку и столы, бронирования, курьеры, типы заказов и платежей, скидки и лояльные клиенты. Вход в API из веб-админки.
Предварительные требования
Смотри полные инструкции по настройке, встроенные в коннектор (видно в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
IIKO_API_HOST, IIKO_LOYALTY_API, IIKO_API_LOGIN
Шаг 1 — Получи учетные данные
Настройка занимает около 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 дней. Статусы: 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 — Добавь коннектор в Claude
URL твоего сервера: в AnythingMCP открой MCP Servers → сервер, на котором находится этот коннектор, и скопируй его URL (
https://cloud.anythingmcp.com/mcp/…). Используй его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Рекомендуемый путь: работает на claude.ai web без редактирования конфигурационного файла.
- Открой в Claude Plugins (на некоторых тарифах пока Customize) → Connectors.
- Нажми + Add, затем Add custom connector.
- Введи название, например
iiko, и URL удалённого MCP-сервераhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Continue, оставь найденные настройки и снова нажми Continue. - Выбери Sign in now, нажми Add и войди в AnythingMCP (OAuth), чтобы разрешить доступ.
Все инструменты ниже появятся в твоем чате: начни вводить подсказки.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
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 и покажи баланс бонусов и последние транзакции."
Часто задаваемые вопросы
Работает ли это с Claude Code так же, как и с Claude Desktop? Да, укажи оба на https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Откуда берется 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 логин с дополнительным правом на стоп-лист. Включай их на странице коннектора только если ИИ должен их использовать.
Следующие шаги
- Страница коннектора
- Подключение к ChatGPT
- Подключение к Cursor
- Подключение к Gemini
- Подключение к Meta Muse
- Подключение к Microsoft Copilot
Это руководство помогло?