Какие задачи ресторана агент берет на себя
Выбор сервера для iiko зависит от того, где стоит ваша iiko: на сервере заведения или в облаке. Одни серверы ходят в iikoServer заведения, другие работают с облаком iikoCloud, а отдельный сервер нужен разработчикам для отладки.
- Собирает выручку по заведениям, топ блюд, питание персонала и сравнение выручки по дням. Готовые сводки есть в iikoServer MCP Server, где больше 40 инструментов.
- Строит OLAP-отчеты с произвольными колонками и фильтрами или по сохраненным пресетам. Это умеют iikoServer MCP Server и iikoServer MCP на 39 инструментов.
- Читает номенклатуру, техкарты, склады, поставщиков, входящие и исходящие накладные, списания, кассовые смены и платежи, чтобы управляющий спрашивал о них обычными словами.
- Работает с меню, заказами, доставками и банкетами в облаке. iikocloud-mcp превращает 236 методов iikoCloud из 22 доменов в инструменты и запускается с нужным поднабором.
- Помогает отладить интеграцию. iiko-mcp вызывает любой метод iikoTransport и показывает статус, correlationId и сырой ответ без Postman.
Как получить ключ iikoCloud API
Документация iikoCloud API требует три значения. Компанию регистрируют на портале public-api.iikoweb.ru и создают там приложение. Портал выдает appId и одноразовый clientSecret. Сам ключ генерируют в iikoWeb, в разделе «Интеграции», пункт «API Keys».
Все три значения уходят в POST /api/v2/access_token. В ответ приходит JWT. Он живет 1 час. Refresh-токена нет, поэтому новый запрашивают до истечения старого. Старый метод /api/1/access_token документация пометила устаревшим, и iiko-mcp уже работает по схеме v2.
В iikocloud-mcp секреты передаются только через транспорт, HTTP-заголовки или переменные окружения. В аргументы инструментов они не попадают, поэтому модель их не видит. Установка из карточки выглядит так: npx skillfoxx add mcp/iikocloud-mcp.
С iikoServer схема другая. Сервер входит под логином и паролем пользователя iiko, сам считает SHA1 от пароля и при выходе освобождает лицензионное место. Заведите для агента отдельного пользователя с правами только на нужные отчеты.
Какой сервер поставить
Официального MCP от iiko в каталоге нет. VPN ни одному из серверов не нужен. В разделе есть и многотенантный сервер для Pyrus. В его монорепозитории лежит вспомогательный iiko_mcp, но основной продукт там Pyrus.
- Сети на iikoCloud подойдет iikocloud-mcp с расширенным доступом. Запись включается флагом --allow-write, и каждый вызов на запись ждет подтверждения на стороне сервера.
- Отчеты из iikoServer дают iikoServer MCP Server и сервер на 39 инструментов с широким доступом. Первый меняет техкарты и проводит инкассации, а второй вносит инкассацию инструментом create_encashment без подтверждения.
- Для отладки интеграции есть iiko-mcp с расширенным доступом.
Ограничения и безопасность
Инкассация — запись о движении наличных в рабочей системе ресторана. Агенту, который собирает отчеты для управляющего или владельца сети, хватит инструментов чтения, а инструменты на изменение данных лучше не включать вовсе.
Серверы для iikoServer по умолчанию не проверяют SSL-сертификат. Пароль лежит в переменных окружения открытым текстом. Универсальные raw_request и iiko_request вызывают любой метод API, включая запись, и разрешать их стоит только на время отладки.
У iikocloud-mcp нет своих ограничений по организациям: агент видит все, что разрешено аккаунту iikoCloud. Полный набор методов занимает около 439 КБ контекста модели, а набор только для чтения около 124 КБ. Поэтому подключайте только нужные домены.
Лицензия не указана у iikocloud-mcp и у сервера на 39 инструментов. Перед коммерческим внедрением этот вопрос придется решить с авторами.