MCP-сервер для Kaiten (TDD)
Kaiten MCP Server
MCP-сервер для канбана Kaiten на TypeScript: пять инструментов для карточек и учета времени, сделан по TDD с полным покрытием тестами
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Создает и меняет карточки на реальной доске
- Токен дает полный доступ уровня пользователя к вашей организации в Kaiten
Установка
Ручная установка
git clone git@github.com:Happiest-d/kaiten-mcp.git && cd kaiten-mcp && npm install && npm run buildГотового пакета нет, сервер собирается из исходников.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту доступ к задачам Kaiten через REST API. Реализовано пять инструментов: получить детали карточки с комментариями, проверить статус нескольких карточек разом, посмотреть логи учета времени с группировкой по пользователям или дням, создать карточку на доске и обновить существующую (заголовок, описание, перемещение между колонками и лейнами, назначение исполнителя, теги). Остальные 12 инструментов из плана автора, включая список карточек доски и ее структуру, пока не реализованы. Проект собран по TDD: 78 тестов на Vitest, отдельные спецификации фич в папке specs.
Для кого. Для команд на Kaiten, которым для начала достаточно читать и создавать карточки и смотреть учет времени через агента.
Подходит, если
- Нужно быстро создать или обновить карточку из чата с агентом
- Нужно посмотреть детали задачи и логи времени без захода в веб-интерфейс
- Нужен сервер с прозрачным TDD-процессом и подробной документацией разработки
Не подходит, если
- Нужен список карточек доски с фильтрами: get-board-cards пока не реализован
- Нужны удаление задач, комментарии или структура доски: этого тоже нет
Пример запроса к агенту
Создай в Kaiten задачу «Исправить баг авторизации» на доске 1660008 в колонке 5747562Ограничения
Реализовано только 5 из 17 задуманных инструментов, ключевой get-board-cards еще в разработке. Требует Node.js 20+, сборки из исходников (npm install, npm run build) и токена Kaiten API. Автор один, релизов на npm нет.
Как отключить. Удалите запись kaiten из конфигурации MCP клиента (~/.claude/mcp.json или .mcp.json проекта).
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| KAITEN_API_TOKEN обязательная, секрет | Токен из профиля Kaiten (Настройки → API-токены) |
| KAITEN_BASE_URL обязательная | Полный URL API вашего Kaiten, например https://mycompany.kaiten.ru/api/latest |
Проверка безопасности
- Создает и меняет карточки на реальной доске
- Токен дает полный доступ уровня пользователя к вашей организации в Kaiten
Коротко о README
README перечисляет пять готовых инструментов и обозначает следующие в разработке: список и структуру доски, удаление задачи, комментарии, учет времени. Описаны требования (Node.js 20+, токен Kaiten), установка через клонирование и сборку, подключение к Claude Code и Claude Desktop через mcp.json, структура проекта и цикл разработки RED-GREEN-REFACTOR со ссылками на STATUS.md и MANUAL.md.
Частые вопросы
Можно ли посмотреть все карточки доски?
Пока нет, get-board-cards в разработке и отмечен в roadmap как критичный.
Нужна ли сборка проекта?
Да, готового пакета в npm нет, сервер собирается из исходников командой npm run build.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI