SkillFoxx
Telegram

iiko-mcp: отладка запросов к iikoTransport API

iiko-mcp

Легкий MCP-сервер для ручной отладки iikoTransport API (api-ru.iiko.services) с авторизацией v2 и универсальным инструментом произвольного запроса

  • 1 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • iiko_request может вызвать любой метод API, включая потенциально изменяющие данные, без встроенного подтверждения
  • Креды iiko (apiKey, appId, clientSecret) хранятся в конфиге клиента или .env и должны оставаться секретом
Все причины и проверки
Российский стек

steamn/iiko-mcpАвтор:steamn

Установка

Сервисы

Ручная установка

git clone https://github.com/steamn/iiko-mcp.git && cd iiko-mcp && npm install && npm run build

Установка и сборка из README.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • iiko_request может вызвать любой метод API, включая потенциально изменяющие данные, без встроенного подтверждения
  • Креды iiko (apiKey, appId, clientSecret) хранятся в конфиге клиента или .env и должны оставаться секретом

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер авторизуется в iikoTransport по новой схеме v2 (POST /api/v2/access_token с apiKey, appId и clientSecret), получает JWT на час и кэширует его в памяти, потому что старая схема /api/1/access_token отключается на стороне iiko. Шесть инструментов: iiko_request, универсальный вызов любого метода, пути и тела с автоматической авторизацией, возвращает статус, correlationId и тело ответа; iiko_access_token получает или обновляет токен для отладки самой авторизации; iiko_organizations, iiko_nomenclature, iiko_stop_lists и iiko_deliveries_by_id, готовые шорткаты для соответствующих эндпоинтов /api/1. Инструмент iiko_request позволяет вызвать любой метод из документации iiko, даже если для него еще нет отдельного инструмента.

Для кого. Для разработчиков, интегрирующих iikoTransport API, которым нужен быстрый способ вручную подергать эндпоинт и посмотреть сырой ответ из агента, без Postman.

Подходит, если

  • Нужно вручную отладить конкретный запрос к iikoTransport API и посмотреть сырой ответ с correlationId
  • Нужен готовый шорткат для организаций, номенклатуры, стоп-листов или доставок по ID
  • Нужен доступ к эндпоинту, для которого еще нет отдельного инструмента, через iiko_request

Не подходит, если

  • Нужен готовый набор инструментов на десятки операций, а не отладочный минимум из шести
  • Не хотите, чтобы агент мог вызвать произвольный write-метод через iiko_request без встроенного подтверждения
  • Нужна классическая авторизация iikoServer по логину и паролю: здесь именно iikoTransport с ключом, app id и client secret

Пример запроса к агенту

Вызови POST /api/1/nomenclature для организации X и покажи сырой ответ

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

IIKO_API_LOGIN обязательная, секрет
API-ключ (apiKey) из iikoWeb, раздел Интеграции → API-ключи.
IIKO_APP_ID обязательная, секрет
appId, выдается на портале разработчика iiko.
IIKO_CLIENT_SECRET обязательная, секрет
clientSecret с портала разработчика, показывается один раз при создании приложения.

Ограничения

Проект прямо позиционирует себя как инструмент для ручной отладки, а не production-интеграции. iiko_request не ограничивает вызываемые методы: через него можно дойти и до write-эндпоинтов без отдельного подтверждения на уровне сервера. Автор явно предупреждает не коммитить реальные apiKey и clientSecret и держать их только в .env или конфиге клиента вне репозитория.

Как отключить. Удалите блок iiko из конфигурации MCP клиента (.cursor/mcp.json или claude_desktop_config.json).

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

Чем отличается авторизация v2 от старой?

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

Можно ли вызвать эндпоинт без готового шортката?

Да, iiko_request принимает любой метод, путь и тело и сам проставляет авторизацию.

Обсуждение

Вопросов и отзывов пока нет.

iiko — все инструменты
Российский стек

MCP-сервер для iikoServer REST API: товары, сотрудники, накладные, кассовые смены, инкассация и OLAP-отчеты, включая сырые запросы к любому эндпоинту

MCP-серверШирокий доступ1
Российский стек

MCP-сервер для iikoCloud API с выбором нужного поднабора из 236 методов по домену, read-only по умолчанию и обязательным подтверждением перед любой записью

MCP-серверРасширенный доступ1
Российский стек

MCP-сервер для REST API iikoServer: номенклатура, сотрудники, накладные, кассовые смены, OLAP-отчеты и выручка по заведениям

MCP-серверШирокий доступ3

Многотенантный MCP-сервер для Pyrus

Pyrus AI Ecosystem — MCP Infrastructure

Российский стек

Enterprise MCP-сервер для Pyrus v4 API с многотенантностью, SQLite-хранением и метриками, внутри большого монорепозитория

MCP-серверШирокий доступ
Российский стек

Вспомогательный MCP-сервер, который берет готовый отчет по задачам Яндекс Трекера и отправляет его в Telegram через существующий бот-сервис

MCP-серверШирокий доступ1
Российский стек

MCP для ВКонтакте на собственном сервере: каталог методов VK API, чтение стен и сообществ, сравнение сообществ и запись только после подтверждения человека

MCP-серверШирокий доступ

Коротко о README

Двуязычное README описывает MCP-сервер для ручной отладки iikoTransport API с авторизацией v2, шагами получения apiKey и appId/clientSecret, таблицей переменных окружения и двумя способами передачи кредов: через блок env клиента или файл .env. Перечислены шесть инструментов с акцентом на универсальный iiko_request, даны конфигурации для Cursor и Claude Desktop и раздел безопасности про хранение секретов вне репозитория. Лицензия MIT.

Бейдж для README

Сообщить о проблеме