kaiten-mcp (ViktorOgnev)
kaiten-mcp
MCP-сервер для Kaiten с 246 инструментами в 27 модулях: карточки, Service Desk, автоматизации, аудит и графики
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструменты покрывают изменяющие операции почти по всему API Kaiten, включая роли, группы и автоматизации
- Общий HTTP-сервер с OAuth дает доступ нескольким пользователям одного инстанса, конфигурацию нужно проверять внимательно
Установка
Ручная установка
cp .env.example .envЗаполните KAITEN_SUBDOMAIN и KAITEN_TOKEN для локального stdio, либо MCP_PUBLIC_URL и MCP_OAUTH_ISSUER_URL для общего HTTP-сервера.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер покрывает практически весь API Kaiten: 246 инструментов в 27 модулях, от карточек, комментариев и чеклистов до Service Desk (47 инструментов, самый крупный модуль), вебхуков, автоматизаций и воркфлоу, ролей и групп, аудита и аналитики, графиков. Работает по stdio для локального подключения к Claude Code или Claude Desktop, или по HTTP для удаленного развертывания в Docker с OAuth-авторизацией для нескольких пользователей одного продуктового инстанса. Адрес API собирается из поддомена компании и базового домена или задается полным URL напрямую. В комплекте пять скиллов: kaiten-audit, kaiten-deploy, kaiten-heavy-data, kaiten-metrics и managing-kaiten с подробным справочником инструментов и типовыми воркфлоу.
Для кого. Для команд на Kaiten, которым нужно самое полное покрытие API, включая Service Desk, роли и автоматизации, а не только базовые карточки.
Подходит, если
- Нужен доступ ко всей поверхности API Kaiten, включая Service Desk, роли, группы и вебхуки
- Нужен общий HTTP-сервер с OAuth на нескольких пользователей одной компании
- Нужны готовые скиллы под аудит, метрики и деплой самого сервера
Не подходит, если
- Нужен только небольшой набор инструментов для карточек: 246 инструментов может быть избыточно для контекста агента
- Не готовы разворачивать Docker и настраивать OAuth ради общего сервера
- Нужен CLI, а не MCP-протокол: у автора есть отдельный kaiten-cli
Пример запроса к агенту
Собери сводку по Service Desk обращениям за неделю и покажи график по типам заявокОграничения
Нужен Docker или Python 3.11+ и аккаунт Kaiten с API-токеном. Для production shared-сервера по HTTP нужен режим MCP_HTTP_AUTH_MODE=oauth и публичный URL, локальный shared bearer-токен помечен как legacy. Большое число инструментов (246) может занимать много контекста агента, если клиент загружает их все сразу.
Как отключить. Остановите контейнер docker compose down для HTTP-варианта, либо удалите сервер из конфигурации stdio-клиента и файл .env с токеном.
MCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
| Переменные окружения | |
|---|---|
| KAITEN_SUBDOMAIN обязательная | Поддомен компании в kaiten.ru |
| KAITEN_TOKEN обязательная, секрет | API-токен пользователя Kaiten для stdio или legacy shared HTTP |
| MCP_HTTP_AUTH_MODE | Режим авторизации HTTP-транспорта: oauth, shared или none |
| MCP_PUBLIC_URL | Публичный URL MCP-эндпоинта для production shared-сервера |
Проверка безопасности
- Инструменты покрывают изменяющие операции почти по всему API Kaiten, включая роли, группы и автоматизации
- Общий HTTP-сервер с OAuth дает доступ нескольким пользователям одного инстанса, конфигурацию нужно проверять внимательно
Коротко о README
README на русском дает таблицу всех 27 модулей с числом инструментов в каждом, объясняет два транспорта (stdio и HTTP) и подробно разбирает переменные окружения для локального и общего HTTP-развертывания, включая режимы авторизации oauth, shared и none. Отдельная папка deploy содержит Caddyfile, скрипты bootstrap и deploy, примеры .env для продакшена и туннеля ChatGPT. В skills/managing-kaiten есть отдельные файлы TOOLS_REFERENCE.md и WORKFLOWS.md.
Частые вопросы
Сколько инструментов у сервера?
246 инструментов в 27 модулях, от карточек до Service Desk, автоматизаций и графиков, по таблице из README.
Можно сделать общий сервер на несколько пользователей?
Да, HTTP-транспорт с MCP_HTTP_AUTH_MODE=oauth рассчитан на production shared-развертывание с публичным URL.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI