kaiten-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kaiten-mcp покажи пространства"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
kaiten-mcp
Русский | English
MCP-сервер для Kaiten — интеграция канбан-досок и задач Kaiten с AI-ассистентами (Cursor, Claude Code и любым MCP-клиентом).
Управляйте карточками прямо из чата: создавайте задачи, перемещайте по колонкам, обновляйте описания, оставляйте комментарии и теги — без ручного копирования из веб-интерфейса и без огромных JSON-ответов API в контексте модели.
Зачем это нужно
Подключить Kaiten к Cursor / Claude Code через Model Context Protocol
Работать с пространствами, досками, колонками и карточками голосом агента
Экономить токены: ответы компактные по умолчанию (описания — только по запросу)
Развернуть локально (stdio) или для команды (Streamable HTTP / Docker / Kubernetes)
Related MCP server: panel-todo-mcp
Возможности
Локальный транспорт stdio для Cursor и Claude Code
Удалённый Streamable HTTP (
POST /mcp) для командного хостингаТокен Kaiten на каждый запрос (credentials не сохраняются на диске)
Компактные списки: страница по умолчанию 20 (макс. 100), без вложений и «шумных» вложенных полей
Бенчмарки размера payload (
kaiten-mcp-benchmark), чтобы ответы не раздувались со временемСтруктурированные логи в stderr (безопасно для stdio MCP)
Быстрый старт
Требования
Python 3.12+
API-токен Kaiten (Профиль → API-ключ в вашем инстансе, например
https://<компания>.kaiten.ru/profile/api-key)
1. Установка и запуск
export KAITEN_API_TOKEN='ваш-токен'
export KAITEN_WORKSPACE_SLUG='ваша-компания' # → https://ваша-компания.kaiten.ru/api/v1
uvx kaiten-mcp --transport stdiouvx скачивает пакет из PyPI, создаёт изолированное окружение и запускает сервер.
Клонировать репозиторий не требуется.
Для on-prem / кастомного домена вместо slug задайте полный корень API:
export KAITEN_BASE_URL='https://kaiten.example.com/api/v1'Остальные переменные — в .env.example.
2. Cursor
Для разработки в этом репозитории конфиг уже есть: .cursor/mcp.json.
Для использования в другом проекте добавьте сервер в его .cursor/mcp.json, сохранив существующие записи:
{
"mcpServers": {
"kaiten": {
"command": "uvx",
"args": ["kaiten-mcp", "--transport", "stdio"],
"env": {
"KAITEN_API_TOKEN": "${env:KAITEN_API_TOKEN}",
"KAITEN_WORKSPACE_SLUG": "${env:KAITEN_WORKSPACE_SLUG}"
}
}
}
}Этот вариант устанавливает пакет из PyPI и не требует клонирования репозитория.
uvx должен быть доступен в PATH процесса Cursor.
Для on-prem замените запись workspace slug на "KAITEN_BASE_URL": "${env:KAITEN_BASE_URL}"
и экспортируйте полный корень API.
Экспортируйте токен и workspace в окружение, которое наследует Cursor:
export KAITEN_API_TOKEN='ваш-токен'
export KAITEN_WORKSPACE_SLUG='ваша-компания'Перезапустите Cursor после смены переменных окружения.
Откройте Output → MCP Logs и убедитесь, что сервер
kaitenподключился.Попросите агента: «покажи пространства» или «найди задачи на доске …».
${env:KAITEN_API_TOKEN} и ${env:KAITEN_WORKSPACE_SLUG} подставляет Cursor. Не коммитьте реальные токены.
3. Claude Code
Конфиг проекта: .mcp.json.
export KAITEN_API_TOKEN='ваш-токен'
export KAITEN_WORKSPACE_SLUG='ваша-компания'
claude mcp listИли вручную:
claude mcp add --transport stdio kaiten -- uvx kaiten-mcp --transport stdioSkill для работы с Kaiten
MCP-сервер предоставляет инструменты и доступ к Kaiten. Бесплатный skill подсказывает агенту, как находить и изменять карточки, готовить задачи, делать обзор доски и предлагать улучшения очереди. Установка skill не подключает сервер: сначала настройте MCP.
Сохраните файл skill в .cursor/skills/kaiten/SKILL.md своего проекта.
Или скопируйте его из локального клона этого репозитория:
mkdir -p /path/to/your-project/.cursor/skills/kaiten
cp skills/kaiten/SKILL.md /path/to/your-project/.cursor/skills/kaiten/SKILL.mdЗамените /path/to/your-project на путь своего проекта; перед заменой существующего skill
проверьте его содержимое. Начните новый Agent-чат и убедитесь, что skill доступен.
Cursor может выбирать его для запросов о Kaiten; подробности — в
документации Cursor.
Для другого клиента с поддержкой skills используйте его каталог установки.
Инструкции написаны на английском, но агент отвечает на языке пользователя.
Примеры менеджерских запросов:
«Сделай обзор доски Product по колонкам и дай ссылки на задачи, требующие внимания».
«Посмотри очередь Product и предложи, какие описания стоит уточнить. Карточки пока не меняй».
«Подготовь задачу с критериями готовности на основе этих требований: …».
Обзор отражает доступное текущее состояние доски. Инструменты не предоставляют полной истории для расчёта throughput за неделю или cycle time.
Демонстрация
Сценарий записи в Cursor: создать карточку → переместить → получить обзор демонстрационных задач. Тестовый стенд подготовлен; реальная запись в Cursor ещё не выполнена. Подготовка стенда и проверки.
Примеры запросов к агенту
«Покажи все пространства в Kaiten»
«Найди доски в пространстве X и создай карточку „Исправить баг логина“»
«Перенеси задачу #1234 в колонку In Progress»
«Добавь комментарий к карточке #1234: готово к ревью»
«Повесь тег „hotfix“ на задачу #1234»
Типовой порядок инструментов:
list_spaces→list_boards→list_columns/list_lanescreate_task/list_tasks/get_task/update_task/move_taskadd_comment/add_tag_to_taskпри необходимости
Инструменты MCP
Инструмент | Назначение |
| Список пространств (id, title) |
| Доски пространства |
| Колонки доски |
| Дорожки доски |
| Создать карточку ( |
| Детали задачи ( |
| Фильтрованный компактный список (query, board, column, tag, …) |
| Обновление полей (title, description, owner, condition, …) |
| Перемещение (board / column / lane / sort) |
| Комментарии |
| Теги |
| Добавить тег по имени |
| Снять тег по id |
Удалённый сервер / Docker / Kubernetes
Streamable HTTP:
uv run kaiten-mcp --transport streamable-http --host 0.0.0.0 --port 8000Health:
GET /healthzMCP:
POST /mcp
Docker:
docker pull ghcr.io/evvfebruary/kaiten-mcp:latest
docker run --rm -p 8000:8000 \
-e KAITEN_WORKSPACE_SLUG=ваша-компания \
ghcr.io/evvfebruary/kaiten-mcp:latestДля локальной разработки образ можно собрать командой docker build -t kaiten-mcp ..
Каждый клиент передаёт свой токен:
Authorization: Bearer <kaiten-api-token>Примеры конфигов:
Заметки для Kubernetes:
Stateless-реплики допустимы (SDK v2,
stateless_http=True)TLS — на Ingress
Увеличьте proxy/read timeouts для streaming
Не логируйте заголовок
AuthorizationУ Kaiten лимит порядка ~50 req/s — делите бюджет между репликами
HTTP всегда требует Bearer-токен вызывающего; общий KAITEN_API_TOKEN используется только в stdio.
Полноценная MCP OAuth-авторизация пока не реализована.
Переменные окружения
Переменная | Обязательна | Описание |
| Да (stdio) | API-токен; для HTTP — также в |
| Да* | Slug: |
| Да* | Полный корень API (on-prem); имеет приоритет над slug |
| Нет | Bind для HTTP (по умолчанию |
| Нет |
|
| Нет |
|
| Нет | Компактные redacted-превью в логах |
| Нет | Метрики размера payload без секретов |
* Нужен либо KAITEN_WORKSPACE_SLUG, либо KAITEN_BASE_URL.
Экономия токенов
Размер страницы списка по умолчанию: 20 (макс. 100)
В списках нет описаний, вложений и глубоких дублей
Мутации возвращают id/url и изменённые поля
Обрезка явная:
truncated,next_offset,has_moreКоротко описанные схемы инструментов
Проверка бюджетов размера ответа:
uv run kaiten-mcp-benchmark
uv run kaiten-mcp-benchmark --checkЛогирование
Логи всегда идут в stderr (совместимо со stdio MCP).
export KAITEN_LOG_LEVEL=INFO
export KAITEN_LOG_FORMAT=json
uv run kaiten-mcp --transport stdio --log-format jsonПолезные события: server_starting, tool_start / tool_success / tool_error, kaiten_request, kaiten_rate_limited.
Секреты редактируются; токены видны только как fingerprint вида token_fp=len=40:…ab12.
Разработка
uv sync --all-groups
uv run ruff format .
uv run ruff check .
uv run ty check
uv run pytest
uv run kaiten-mcp-benchmark --checkПроверки совместимости (все 15 инструментов, оба транспорта, документация API):
uv run kaiten-mcp-check offline
uv run kaiten-mcp-check docs
# После настройки выделенной тестовой доски:
uv run kaiten-mcp-check liveНастройка стенда, ежедневного CI и обновление эталонов — CHECKING.md. Live-проверки требуют полного набора настроек и изменяют только свои тестовые карточки.
Публикация релизов (PyPI, GHCR, Official MCP Registry) описана в RELEASING.md.
Структура
src/kaiten_mcp/
api/ # HTTP-клиент и адаптеры эндпоинтов
tools/ # MCP-инструменты
auth.py # Токен на запрос
config.py # Настройки
presentation.py
metrics.py
server.py
__main__.py
tests/
benchmarks/
examples/remote-mcp/
server.json # Official MCP Registry metadata
RELEASING.mdБезопасность
Для HTTP токен берётся из Bearer-заголовка; для stdio — из
KAITEN_API_TOKENСервер не пишет токены на диск
Предпочитайте переменные окружения, а не хардкод в MCP JSON
Права на стороне Kaiten определяются токеном вызывающего
FAQ
Как подключить Kaiten к Cursor?
Установите зависимости через uv, задайте KAITEN_API_TOKEN и KAITEN_WORKSPACE_SLUG, перезапустите Cursor — конфиг уже в .cursor/mcp.json.
Где взять API-токен Kaiten?
В вашем инстансе: Профиль → API-ключ (https://<компания>.kaiten.ru/profile/api-key). OAuth у публичного API Kaiten для этого сценария не используется.
Чем этот сервер отличается от других kaiten-mcp?
Фокус на компактных ответах и экономии контекста модели, плюс готовый remote Streamable HTTP для команды без хранения токенов на сервере.
Можно ли развернуть для всей команды?
Да: Docker / Kubernetes с streamable-http; каждый сотрудник передаёт свой Bearer-токен в заголовке.
Работает ли с on-prem Kaiten?
Да — задайте KAITEN_BASE_URL на ваш /api/v1.
Лицензия
Available Tools
15 toolsadd_commentC
Add a comment to a task. Max useful body is truncated for context.
Inputs: text (required), card_id (required). Returns: id, text, card_id, created, +4 more
add_tag_to_taskB
Attach a tag by name (Kaiten API uses name, not tag_id, for attach).
Inputs: name (required), card_id (required). Returns: tag, card_id, _metrics
create_taskC
Create a Kaiten task/card. Requires title and board_id.
Inputs: title (required), board_id (required), lane_id, type_id, +7 more. Returns: id, url, title, changed, +2 more
get_taskARead-onlyIdempotent
Get one task. Set include_description=true for body text.
Inputs: card_id (required), include_description. Returns: id, url, lane, tags, +22 more
get_task_tagsCRead-onlyIdempotent
List tags attached to a task.
Inputs: card_id (required). Returns: count, items, card_id, _metrics
list_boardsCRead-onlyIdempotent
List boards in a space (id, title, space_id).
Inputs: space_id (required). Returns: count, items, card_id, _metrics, +2 more
list_columnsCRead-onlyIdempotent
List columns on a board (id, title, type, order).
Inputs: board_id (required). Returns: count, items, card_id, _metrics, +2 more
list_commentsBRead-onlyIdempotent
List comments for a task with compact truncated bodies.
Inputs: card_id (required). Returns: count, items, card_id, _metrics
list_lanesBRead-onlyIdempotent
List lanes on a board (id, title, order).
Inputs: board_id (required). Returns: count, items, card_id, _metrics, +2 more
list_spacesARead-onlyIdempotent
List spaces (id, title) for discovering board targets.
Inputs: no named parameters. Returns: count, items, card_id, _metrics, +2 more
list_tagsCRead-onlyIdempotent
List company/space tags (paginated, compact).
Inputs: limit, query, offset, space_id. Returns: count, items, limit, offset, +4 more
list_tasksCRead-onlyIdempotent
List tasks with filters. Default page 20 (max 100). Compact summaries only.
Inputs: tag, limit, query, offset, +8 more. Returns: count, items, limit, offset, +4 more
move_taskCDestructive
Move a task via Kaiten card PATCH (board/column/lane/sort/prev_card_id).
Inputs: card_id (required), lane_id, board_id, column_id, +2 more. Returns: id, url, title, changed, +2 more
remove_tag_from_taskBDestructiveIdempotent
Remove a tag from a task by tag_id (Kaiten delete uses tag_id).
Inputs: tag_id (required), card_id (required). Returns: card_id, _metrics, removed_tag_id
update_taskADestructive
Update card fields via PATCH. condition: 1=live, 2=archived, 3=deleted. Workflow status (queued/in-progress/done) comes from the column — use move_task. Responsible is set only on create_task.
Inputs: card_id (required), title, type_id, due_date, +5 more. Returns: id, url, title, changed, +2 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Most tools target a clearly distinct resource+action (spaces, boards, columns, lanes, tasks, comments, tags), and descriptions explicitly resolve the riskiest boundary: update_task vs move_task for workflow status. The remaining overlap is minor — list_tags (workspace catalog) vs get_task_tags (per-task attachments) vs add/remove_tag_from_task are distinguishable but require reading descriptions rather than names.
All 15 tools use snake_case verb_noun form with a small, predictable verb set (list_/get_/create_/update_/move_/add_/remove_). The one wrinkle is get_task_tags using 'get' for what is a list operation, but it still fits the verb_noun pattern.
15 tools is well-scoped for a Kaiten project-management surface: four read-only hierarchy navigators, task CRUD plus move, and tag/comment operations. Each tool corresponds to a distinct API endpoint with no filler.
Core lifecycle is covered (create/get/list/update tasks, move between columns/lanes, comments, tags, board structure), and deletion is reachable via update_task condition=3. However, there is no way to list users/members, and the description states responsible is only settable on create_task — so reassigning a task is impossible, a real dead end for a task tracker.
Maintenance
Related MCP Connectors
Remote MCP for Kanban AI boards—manage projects, tasks, and comments from AI tools.
AI-native Kanban board — connect Claude to claim, work and move your tasks over MCP.
Task & board management for AI agents + humans. Kanban, comments, digests via MCP.
Kanban board for teams and coding agents: manage tasks, subtasks, sprints and wiki pages via MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for integrating Kaiten API with Claude Desktop, enabling management of cards, comments, spaces, and boards with advanced features like verbosity control, response format selection, and auto-truncation.33MIT
- AlicenseBqualityFmaintenanceMCP server for Panel Todo — lets AI assistants manage your tasks, issues, and sprints directly in VS Code.388 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server for managing Kaiten tasks through AI agents like Claude, enabling task retrieval, creation, updating, and time logging.24 npm2MIT
- AlicenseNot gradedqualityDmaintenanceMCP server and CLI tool for interacting with Kaiten project management API, optimized for token efficiency. Enables AI assistants to search, create, update, and manage tasks with minimal token usage.MIT