Kaiten MCP Tools: чтение карточек и вложений, 37 инструментов
kaiten-mcp-tools
Npm-пакет только для чтения: 37 инструментов по карточкам, доскам, документам и учету времени, оригиналы вложений скачиваются для разбора агентом
- 1 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Только чтение, но скачанные вложения остаются на диске после выхода
- Токен открывает агенту карточки, документы и файлы компании
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/kaiten-mcp-toolsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Только чтение, но скачанные вложения остаются на диске после выхода
- Токен открывает агенту карточки, документы и файлы компании
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на TypeScript читает Kaiten через `GET` и не создает, не меняет и не удаляет данные. В нем 37 отдельных инструментов: карточки по `card_id` или ссылке любого вида, пространства и доски, обсуждения, документы, справочники, спринты и учет времени. Отличие от соседей в работе с файлами: оригиналы вложений скачиваются в каталог `KAITEN_DOWNLOAD_DIR` под безопасными именами без повторов, и агент разбирает их сам, будь то скриншот, таблица или PDF. Токен берется из `KAITEN_API_TOKEN` или из файла `KAITEN_API_TOKEN_FILE`, так секрет не попадает в конфиг клиента. Справочники кешируются на минуту, карточки читаются свежими. Транспорт `stdio`, пакет публикуется в npm с `npm-shrinkwrap.json`.
Для кого. Аналитикам и техлидам, которым нужно, чтобы агент разбирал задачи вместе со скриншотами и файлами из вложений, не получая права на правки.
Подходит, если
- Баг описан скриншотом в карточке, и агент должен увидеть сам файл, а не только название
- Ссылка на карточку из чата превращается в запрос: сервер принимает адреса `/id`, `/c/id` и адреса досок
- Секрет токена нельзя класть в конфиг клиента, его хранят в отдельном файле
- Kaiten стоит за корпоративным центром сертификации, и проверку TLS отключать нельзя
Не подходит, если
- Агент должен создавать и двигать карточки: сервер этого не умеет
- Файлы вложений нельзя сохранять на диск рабочей машины: оригиналы остаются в каталоге после выхода
- Нужен транспорт HTTP: доступен только `stdio`
Пример запроса к агенту
Открой карточку по ссылке, скачай скриншот из вложений и скажи, какую ошибку на нем видноMCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
KAITEN_BASE_URLобязательная- Полный адрес экземпляра Kaiten
KAITEN_API_TOKENсекрет- Токен API, либо вместо него файл токена
KAITEN_API_TOKEN_FILE- Путь к файлу с токеном
KAITEN_DOWNLOAD_DIR- Каталог скачанных оригиналов вложений
Ограничения
Сервер работает только на чтение, правки в Kaiten невозможны. Нужен Node.js 22.15 или новее. Скачанные вложения остаются в каталоге `KAITEN_DOWNLOAD_DIR` и после выхода сервера: очищает их пользователь или система. Один процесс обслуживает один экземпляр Kaiten и один источник токена. Приватные файловые хосты нужно разрешать явно через `KAITEN_ATTACHMENT_ALLOWED_HOSTS`, токен туда не передается. Размер оригинала ограничен 20 МиБ по умолчанию. Звезд нет, версия 0.2.0.
Как отключить. Удалите сервер из конфигурации клиента и отзовите токен в профиле Kaiten, затем очистите `KAITEN_DOWNLOAD_DIR`.
Частые вопросы
Как подключить сервер?
Добавьте в конфигурацию клиента команду `npx -y kaiten-mcp-tools@0.2.0` и переменные `KAITEN_BASE_URL` и `KAITEN_API_TOKEN` или `KAITEN_API_TOKEN_FILE`. Пример для Claude Desktop, Cursor и Codex есть в README.
Как проверить, что соединение работает?
Попросите агента вызвать `get_current_user`, затем `get_card` по ссылке. Команды `--help` и `--version` работают и без токена.
Что с корпоративным сертификатом?
Задайте `NODE_EXTRA_CA_CERTS` с путем к PEM-файлу до запуска Node.js. Проверка TLS при этом остается включенной.
Кеширует ли сервер данные?
Справочники и структурные метаданные кешируются на 60 секунд, `KAITEN_CACHE_TTL_MS=0` отключает кеш. Карточки, комментарии, спринты, время и файлы читаются свежими.
Что происходит при 429 и сетевых сбоях?
Временные сетевые ошибки, ответ 429 и отдельные 5xx повторяются автоматически, остальные ошибки возвращаются агенту для решения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Kaiten — все инструментыЛокальный stdio-сервер на Node.js 24: поиск и правка карточек Kaiten, чек-листы, комментарии и пользовательские поля из Codex и Claude Code
Go-бинарник без записи: 23 инструмента чтения для Kaiten, все запросы идут методом GET, подключение в Codex, Claude Code и Claude Desktop
MCP-сервер для Kaiten с 36 инструментами: карты, чек-листы, тайм-трекинг и планирование дня, локально или удаленно с OAuth
Kaiten MCP
kaiten-mcp
MCP-сервер для Kaiten на Swift: пространства, доски, колонки, дорожки, карточки, комментарии и пользовательские поля
MCP-сервер для Kaiten: карточки, комментарии, пространства и доски с управлением детализацией ответов
MCP-сервер Kaiten с полным набором инструментов для карточек, тайм-логов, досок, комментариев и чек-листов, ставится одной командой npx
Коротко о README
Документ ведет по первому запуску: Node.js, токен в профиле, готовые конфигурации для Claude Desktop, Cursor и Codex, проверка вызовами `get_current_user` и `get_card`. Дальше список настроек окружения с лимитами и перечень 37 инструментов с правилом передавать ровно один из параметров `url` или `card_id`. Есть версия на английском, README.en.md.