Kayzen MCP

Kayzen MCP — сторонний локальный сервер для двух операций чтения Kayzen Reporting API: списка отчётов и результатов выбранного отчёта. Проверенный код не создаёт и не меняет кампании, заказы, креативы или аудитории. Клиент запускает Node-процесс и общается с ним по stdio.

Статус и происхождение

Репозиторий принадлежит пользователю GitHub springwq; README и manifest называют автором FeedMob. В официальном Developer Hub Kayzen есть REST API, но нет подтверждения этого MCP-сервера. Поэтому карточка помечена как неофициальная.

На 14 августа 2026 года в репозитории восемь коммитов, один открытый issue, один открытый pull request, один star и три fork. Тегов и GitHub Releases нет. Последний коммит dee9072 сделан 17 марта 2025 года. Это означает отсутствие свежей публичной активности, но не доказывает прекращение поддержки.

Инструменты и точные схемы

list_reports не принимает параметров и вызывает GET /reports. Поэтому MCP не раскрывает фильтры advertiser_id, q, пагинацию и сортировку, которые есть в официальном endpoint.

get_report_results требует строковый report_id. Необязательные start_date и end_date передаются как строки; формат даты описан только текстом и не закреплён JSON Schema pattern. Сервер не раскрывает пагинацию, сортировку, filters, metrics и другие параметры официального endpoint. Prompt analyze_report_results требует report_id и только формирует текст для модели — сам он API не вызывает.

Transport, runtime и клиенты

В entrypoint используется только StdioServerTransport. HTTP-, SSE- и hosted endpoint отсутствуют. README документирует Claude Desktop; исходный протокол также прошёл локальный handshake с MCP SDK, но работа в Codex, VS Code и других клиентах автором не заявлена.

README пишет Node.js 16+, однако зафиксированный lockfile устанавливает @modelcontextprotocol/sdk 1.7.0 с требованием Node.js 18+. Проверка выполнена на Node.js 24.13.1 и npm 11.8.0. Для воспроизводимого запуска нужен Node.js 18 или новее.

Установка без npm Registry

Пакет @feedmob-ai/kayzen-mcp отсутствует в публичном npm Registry: запрос metadata вернул E404. Поэтому команды npm install @feedmob-ai/kayzen-mcp и npx -y @feedmob-ai/kayzen-mcp из README сейчас не являются рабочими публичными способами установки.

Проверены два варианта. Первый — локальная установка включённого в репозиторий tarball 1.0.0 по точному raw URL; в нём уже есть dist, но нет bin, поэтому клиент должен запускать dist/server.js через Node по абсолютному пути. Второй — сборка commit dee9072: npm ci --ignore-scripts, затем npx tsc. Флаг нужен в Windows, потому что обычный prepare вызывает POSIX-команду chmod и завершается ошибкой, хотя TypeScript успевает собраться.

Учётные данные и токен

Обязательны KAYZEN_USERNAME, KAYZEN_PASSWORD и KAYZEN_BASIC_AUTH. Последняя переменная содержит base64 от пары Kayzen API Key и API Secret Key. KAYZEN_BASE_URL необязательна; код по умолчанию использует https://api.kayzen.io/v1.

Сервер отправляет password grant на POST /authentication/token, хранит bearer token в памяти 25 минут и затем обновляет его. Официальная документация указывает срок токена 30 минут. Basic credential, логин, пароль и bearer token — разные секреты; их нельзя сохранять в карточке, issue или общедоступном файле конфигурации.

Проверка безопасности

При моделируемой ошибке авторизации код передал в console.error полный Axios error. В stderr действительно попали тестовые Basic credential, логин, пароль, Authorization header и request config. Это воспроизводимая утечка секретов в журнал процесса, а не предположение. До рабочего использования нужно заменить журналирование на очищенное сообщение и ограничить доступ к stderr.

npm audit зафиксированного dependency tree сообщил 11 уязвимых пакетов: одну critical, пять high, три moderate и две low. Среди прямых зависимостей отмечены устаревшие @modelcontextprotocol/sdk и Axios. Результат зависит от advisory-базы на дату проверки, но подтверждает необходимость обновить lockfile и повторить тесты перед передачей production credentials.

Переменная KAYZEN_BASE_URL позволяет перенаправить логин, пароль и Basic credential на другой адрес. Указывать её следует только для доверенного HTTPS endpoint. Для первичной проверки нужен отдельный Kayzen-доступ с минимальными правами и без ценных рабочих отчётов.

Версия и лицензия

Версии не образуют подтверждённый релиз: source package.json содержит 1.0.4, lockfile — 1.0.0, metadata сервера — 1.0.0, а включённый tarball — 1.0.0. Публичного npm-релиза, тега и GitHub Release нет. Поэтому карточка показывает обе версии и не заполняет дату релиза.

MIT заявлена в README, source manifest, lockfile и manifest tarball, но отдельного файла LICENSE с полным юридическим текстом в репозитории и tarball нет. До распространения или встраивания кода следует запросить у автора лицензионный текст.

Вывод

Сервер подходит только для осторожного локального эксперимента с двумя read-only операциями. Публичный npx-путь не работает, Windows-сборка требует обхода prepare, а подтверждённая утечка секретов в stderr и устаревшие зависимости делают использование production credentials небезопасным до исправления кода.