iiko MCP: отчёты iikoServer и запросы к iikoTransport из Claude и Cursor

simba87/iiko-server-mcp· Проверено 12.11.2026· 3на GitHub

Подключает агента к iiko: выручка по точкам, топ блюд, чеки, OLAP-отчёты, номенклатура, техкарты и накладные с iikoServer, а также запросы к облачному iikoTransport API.

2 реализации:

Работает с iikoServer по логину и паролю: 42 инструмента, готовые сводки по выручке, блюдам и питанию персонала, OLAP и сырой запрос к любому эндпоинту.

Как подключить

Что сделать до подключения

Python 3.12: склонировать репозиторий и выполнить pip install -r requirements.txt; есть сборка Docker

Адрес iikoServer, логин и пароль пользователя iiko

IIKO_URL

Адрес вашего iikoServer, например https://my-restaurant.iiko.it:443

IIKO_LOGIN / IIKO_PASS

Логин и пароль пользователя iiko; пароль сервер хеширует SHA1 перед отправкой

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'IIKO_URL=https://<ваш ресторан>.iiko.it:443' --env 'IIKO_LOGIN=<логин>' --env 'IIKO_PASS=<пароль>' --transport stdio iiko \
  -- python3 '<путь к iiko-server-mcp>/server.py'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.iiko]
command = "python3"
args = ["<путь к iiko-server-mcp>/server.py"]

[mcp_servers.iiko.env]
IIKO_URL = "https://<ваш ресторан>.iiko.it:443"
IIKO_LOGIN = "<логин>"
IIKO_PASS = "<пароль>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "iiko": {
      "command": "python3",
      "args": ["<путь к iiko-server-mcp>/server.py"],
      "env": {
        "IIKO_URL": "https://<ваш ресторан>.iiko.it:443",
        "IIKO_LOGIN": "<логин>",
        "IIKO_PASS": "<пароль>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "iiko": {
      "type": "stdio",
      "command": "python3",
      "args": ["<путь к iiko-server-mcp>/server.py"],
      "env": {
        "IIKO_URL": "https://<ваш ресторан>.iiko.it:443",
        "IIKO_LOGIN": "<логин>",
        "IIKO_PASS": "<пароль>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "iiko": {
      "command": "python3",
      "args": ["<путь к iiko-server-mcp>/server.py"],
      "env": {
        "IIKO_URL": "https://<ваш ресторан>.iiko.it:443",
        "IIKO_LOGIN": "<логин>",
        "IIKO_PASS": "<пароль>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "iiko": {
      "command": "python3",
      "args": ["<путь к iiko-server-mcp>/server.py"],
      "env": {
        "IIKO_URL": "https://<ваш ресторан>.iiko.it:443",
        "IIKO_LOGIN": "<логин>",
        "IIKO_PASS": "<пароль>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "iiko": {
        "type": "local",
        "command": ["python3", "<путь к iiko-server-mcp>/server.py"],
        "environment": {
          "IIKO_URL": "https://<ваш ресторан>.iiko.it:443",
          "IIKO_LOGIN": "<логин>",
          "IIKO_PASS": "<пароль>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "iiko": {
      "command": "python3",
      "args": ["<путь к iiko-server-mcp>/server.py"],
      "env": {
        "IIKO_URL": "https://<ваш ресторан>.iiko.it:443",
        "IIKO_LOGIN": "<логин>",
        "IIKO_PASS": "<пароль>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "iiko": {
      "command": "python3",
      "args": ["<путь к iiko-server-mcp>/server.py"],
      "env": {
        "IIKO_URL": "https://<ваш ресторан>.iiko.it:443",
        "IIKO_LOGIN": "<логин>",
        "IIKO_PASS": "<пароль>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_venues_revenueсчитает выручку по точкам за день

compare_revenueсравнивает выручку день к дню

get_top_dishesвыводит топ блюд по выручке

get_checksпоказывает чеки с типом оплаты

get_staff_mealsсчитает питание персонала

run_olap_reportстроит OLAP-отчёт

run_olap_by_presetстроит отчёт по пресету

get_olap_columnsпоказывает поля отчёта

get_productsвыводит номенклатуру

search_productsищет товар по названию

get_assembly_chartsчитает техкарты

save_assembly_chartсоздаёт и меняет техкарту

get_incoming_invoicesчитает приходные накладные

get_waste_documentsчитает акты списания

get_employeesвыводит сотрудников

get_cash_shiftsпоказывает кассовые смены

create_encashmentпроводит внесение или изъятие

get_storesвыводит склады

raw_requestвызывает любой эндпоинт iikoServer

Показано 19 из 42.

Для ручной отладки запросов к облачному iikoTransport API (api-ru.iiko.services) с авторизацией v2: сырой ответ, статус и correlationId.

Как подключить

Что сделать до подключения

Node.js: склонировать репозиторий, выполнить npm install и npm run build

Приложение на портале разработчика iiko и API-ключ в iikoWeb

IIKO_APP_ID / IIKO_CLIENT_SECRET

Зарегистрируйте приложение на портале разработчика iiko: выдаст appId и clientSecret, секрет показывается один раз

IIKO_API_LOGIN

iikoWeb → Интеграции → API-ключи → сгенерировать apiKey

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'IIKO_API_LOGIN=<apiKey из iikoWeb>' --env 'IIKO_APP_ID=<appId>' --env 'IIKO_CLIENT_SECRET=<clientSecret>' --transport stdio iiko-mcp \
  -- node '<путь к iiko-mcp>/dist/index.js'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.iiko-mcp]
command = "node"
args = ["<путь к iiko-mcp>/dist/index.js"]

[mcp_servers.iiko-mcp.env]
IIKO_API_LOGIN = "<apiKey из iikoWeb>"
IIKO_APP_ID = "<appId>"
IIKO_CLIENT_SECRET = "<clientSecret>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "iiko-mcp": {
      "command": "node",
      "args": ["<путь к iiko-mcp>/dist/index.js"],
      "env": {
        "IIKO_API_LOGIN": "<apiKey из iikoWeb>",
        "IIKO_APP_ID": "<appId>",
        "IIKO_CLIENT_SECRET": "<clientSecret>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "iiko-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["<путь к iiko-mcp>/dist/index.js"],
      "env": {
        "IIKO_API_LOGIN": "<apiKey из iikoWeb>",
        "IIKO_APP_ID": "<appId>",
        "IIKO_CLIENT_SECRET": "<clientSecret>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "iiko-mcp": {
      "command": "node",
      "args": ["<путь к iiko-mcp>/dist/index.js"],
      "env": {
        "IIKO_API_LOGIN": "<apiKey из iikoWeb>",
        "IIKO_APP_ID": "<appId>",
        "IIKO_CLIENT_SECRET": "<clientSecret>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "iiko-mcp": {
      "command": "node",
      "args": ["<путь к iiko-mcp>/dist/index.js"],
      "env": {
        "IIKO_API_LOGIN": "<apiKey из iikoWeb>",
        "IIKO_APP_ID": "<appId>",
        "IIKO_CLIENT_SECRET": "<clientSecret>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "iiko-mcp": {
        "type": "local",
        "command": ["node", "<путь к iiko-mcp>/dist/index.js"],
        "environment": {
          "IIKO_API_LOGIN": "<apiKey из iikoWeb>",
          "IIKO_APP_ID": "<appId>",
          "IIKO_CLIENT_SECRET": "<clientSecret>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "iiko-mcp": {
      "command": "node",
      "args": ["<путь к iiko-mcp>/dist/index.js"],
      "env": {
        "IIKO_API_LOGIN": "<apiKey из iikoWeb>",
        "IIKO_APP_ID": "<appId>",
        "IIKO_CLIENT_SECRET": "<clientSecret>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "iiko-mcp": {
      "command": "node",
      "args": ["<путь к iiko-mcp>/dist/index.js"],
      "env": {
        "IIKO_API_LOGIN": "<apiKey из iikoWeb>",
        "IIKO_APP_ID": "<appId>",
        "IIKO_CLIENT_SECRET": "<clientSecret>"
      }
    }
  }
}

Инструменты сервера

iiko_requestвызывает любой эндпоинт iikoTransport

iiko_access_tokenполучает и обновляет токен

iiko_organizationsвыводит организации

iiko_nomenclatureчитает номенклатуру

iiko_stop_listsчитает стоп-листы

iiko_deliveries_by_idнаходит доставку по ID

Что попросить агента

«Какая вчера была выручка по каждой точке и как она изменилась к позавчера?»Агент вызовет get_venues_revenue и compare_revenue

«Покажи 10 самых продаваемых блюд за <период>»Агент вызовет get_top_dishes

«Собери отчёт по продажам за <месяц> в разрезе групп блюд»Агент узнает поля через get_olap_columns и построит отчёт через run_olap_report

«Что сейчас в стоп-листе в облачном iiko?»iiko-mcp получит организации через iiko_organizations и стоп-листы через iiko_stop_lists

Для каких задач

Посчитать выручку по точкам за день и сравнить с прошлым днём

Найти топ блюд по выручке за период

Выгрузить чеки с типом оплаты и маской карты

Собрать OLAP-отчёт по продажам с нужными полями и фильтрами

Проверить техкарты, накладные и списания

Посмотреть стоп-листы и номенклатуру в облачном API

Ограничения

Оба сервера ставятся только из склонированного репозитория, у каждого 1–3 звезды на GitHub

save_assembly_chart и create_encashment меняют рабочие данные ресторана: подтверждайте такие вызовы

get_cash_shifts без даты отвечает 409, get_payment_types на части версий iikoServer отвечает 404

Проверка SSL у iikoServer по умолчанию выключена: для сертификата от CA поставьте IIKO_VERIFY_SSL=true

Если не работает

get_cash_shifts отвечает 409

Инструменту нужна дата: передайте её в запросе.

get_payment_types отвечает 404

На части версий iikoServer такого эндпоинта нет.

Питание персонала считается неверно

Сервер ищет его по типу оплаты «(без оплаты)»: проверьте, что в вашем iiko тип называется так же.

Docker-контейнер сервера сразу завершается

Сервер работает по stdio: запускайте контейнер с -i и без -d.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
iikoServer MCP Server	simba87	3	локально	токен	42	17 июля 2026
iiko-mcp (iikoTransport)	steamn	1	локально	токен	6	5 августа 2026

Частые вопросы

Чем отличаются два сервера?

iikoServer MCP работает с REST API iikoServer по логину и паролю и даёт готовые отчёты: выручку, топ блюд, чеки, OLAP. iiko-mcp от steamn нужен для отладки запросов к облачному iikoTransport API: он показывает сырые ответы.

В каком формате передавать даты?

В готовых сводках iikoServer MCP (get_venues_revenue, get_checks и других) — ГГГГ-ММ-ДД, в OLAP-отчётах run_olap_report и run_olap_by_preset — ДД.ММ.ГГГГ. Без даты сводки берут день по московскому времени.

Не займёт ли сервер лицензию iiko?

При выключении iikoServer MCP отправляет logout и освобождает слот лицензии. Сессию он сам продлевает: при ответе 401 входит заново.

Почему iiko-mcp использует авторизацию v2?

Старый метод /api/1/access_token iiko отключает. Сервер берёт токен через POST /api/v2/access_token по apiKey, appId и clientSecret; JWT живёт час и хранится в памяти.

Работает ли сервер из России?

Серверы работают на вашем компьютере и ходят в ваш iikoServer или в api-ru.iiko.services по вашим учётным данным iiko.

iiko MCP: отчёты iikoServer и запросы к iikoTransport из Claude и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы