MCP-сервер для Kaiten на Python
Kaiten MCP
Однофайловый MCP-сервер на FastMCP для Kaiten: 22 инструмента для карточек, комментариев, чек-листов и учета времени
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Может безвозвратно удалить карточку
- Меняет колонки, участников и теги на реальной доске
Установка
Ручная установка
pip install -r requirements.txtИли pip install "mcp>=1.2.0" httpx без клонирования всего репозитория.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает REST API Kaiten в 22 инструмента на Python (FastMCP), работает по stdio. Есть справочники: текущий пользователь, пространства, доски, структура доски с колонками и дорожками, пользователи, типы карточек. Для карточек: поиск с фильтрами по тексту, доске, колонке, владельцу, состоянию, датам и тегам, получение, создание, обновление, перемещение, архивация и безвозвратное удаление. Отдельно инструменты для комментариев, чек-листов, участников, тегов и логов времени в минутах. Списки и поиск возвращают сокращенные сводки для экономии контекста, а лимит запросов Kaiten (50 в секунду) сервер обрабатывает автоповтором по заголовку X-RateLimit-Reset.
Для кого. Для команд на Kaiten, которым нужен полный набор операций с карточками из одного скрипта без сборки проекта.
Подходит, если
- Нужен полный цикл работы с карточкой: создать, найти, обновить, переместить, архивировать
- Нужны чек-листы, комментарии и учет времени в одном сервере
- Хочется запустить сервер одним python-файлом без сборки
Не подходит, если
- Нужен HTTP-транспорт для командного хостинга: сервер работает только по stdio
- Важен готовый пакет в PyPI: устанавливать нужно вручную через requirements.txt
Пример запроса к агенту
Найди в Kaiten карточки с тегом hotfix на доске поддержки и покажи их статусОграничения
Только stdio-транспорт, HTTP не поддерживается. Пакета в PyPI нет, зависимости ставятся вручную (mcp, httpx). Удаление карточки безвозвратное. Автор один, звезд и релизов немного.
Как отключить. Удалите сервер kaiten командой claude mcp remove kaiten или уберите его из claude_desktop_config.json.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| KAITEN_API_TOKEN обязательная, секрет | Bearer-токен, обязателен |
| KAITEN_DOMAIN | Поддомен, например mycompany для mycompany.kaiten.ru |
| KAITEN_BASE_URL | Альтернатива домену: полный URL API, например для self-hosted |
| KAITEN_API_VERSION | v1 (по умолчанию) или latest |
| KAITEN_TIMEOUT | Таймаут запроса в секундах, по умолчанию 30 |
Проверка безопасности
- Может безвозвратно удалить карточку
- Меняет колонки, участников и теги на реальной доске
Коротко о README
README перечисляет 22 инструмента по группам: справочники, карточки, комментарии, чек-листы, участники, теги, учет времени. Показаны установка через pip, запуск и проверка через MCP Inspector, подключение к Claude Code и Claude Desktop, таблица переменных окружения и типичный сценарий работы от списка пространств до перемещения карточки.
Частые вопросы
Есть ли HTTP-режим для команды?
Нет, сервер работает только через stdio, каждый пользователь запускает свой процесс.
Как задать домен, если у компании кастомный URL?
Вместо KAITEN_DOMAIN укажите переменную KAITEN_BASE_URL с полным адресом API.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI