Kaiten Mcp

io.github.theYahia由 GitHub 账号 theYahia 发布v1.0.0更新于 Oct 24, 2026

MCP server for Kaiten API — cards, boards. 3 tools.

已验证STDIO仅桌面效率与工作流开发者工具

概览

AI 生成的概览

面向 Kaiten 看板平台的本地 MCP 服务器,让助手浏览空间、看板和卡片,并创建、移动、评论和整理卡片。

可以做什么
  • 列出、创建、更新和删除空间、看板、列与泳道
  • 按多种条件筛选卡片,读取单张卡片,创建、更新、移动或删除卡片,并查看其位置历史
  • 添加、列出、更新和删除卡片评论
  • 管理卡片成员、标签、检查清单及清单项
  • 管理子卡片、外部链接和阻塞关系
  • 查询标签、用户、卡片类型、冲刺、冲刺摘要和自定义字段
适用场景
当团队用 Kaiten 跟踪工作时适用:让助手读取看板、回答卡片相关问题,或用一句提示完成移动、指派、设置截止日期和添加检查清单,而不必手动拖拽卡片。
运行要求
通过 npx 以 stdio 本地运行,需要 Node.js。需要 KAITEN_TOKEN 中的 Kaiten API 令牌,以及 KAITEN_DOMAIN(子域名或完整主机名)或自建实例的 KAITEN_BASE_URL。令牌对读取类工具需查看权限,对创建、修改、删除类工具需编辑权限。需要能访问 Kaiten API 的网络。
安装前请注意
API 令牌是具备编辑权限的凭据,持有者可修改或删除卡片、看板和评论。许多工具会写入、移动或删除数据,执行前应确认。可选的 HTTP 模式会暴露以你的令牌身份操作的端点,因此默认关闭 CORS。卡片和看板数据会发送到 Kaiten API。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Kaiten Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

MCP-сервер для Kaiten — канбан-доски, карточки и спринты через ИИ

📦 Часть WWmcp — Emerging Markets MCP — 46 MCP-серверов к незападным API (Бразилия / MENA / Залив / Юго-Восточная Азия / Африка / СНГ).

Если вы искали, как подключить Kaiten к нейросети, разобрать доску и двигать карточки не перетаскивая их мышкой — это оно. 63 инструмента: пространства, доски, колонки, дорожки, карточки с фильтрами, комментарии, участники, теги, чек-листы, дочерние карточки, внешние ссылки, блокировки, типы карточек, спринты, кастомные поля и пользователи. Пишете «перенеси всё из Review в Done и поставь дедлайн на пятницу» — переносит.

MCP-сервер к API канбан-платформы Kaiten. 63 инструмента: пространства, доски, колонки, дорожки, карточки (с богатыми фильтрами), комментарии, участники, теги, чек-листы, дочерние карточки, внешние ссылки, блокировки, типы карточек, спринты, кастомные поля и пользователи.

[npm] [License: MIT]

Часть серии WWmcp от @theYahia.

Быстрый старт

Claude Desktop

Добавьте в claude_desktop_config.json:

json
{  "mcpServers": {    "kaiten": {      "command": "npx",      "args": ["-y", "@theyahia/kaiten-mcp"],      "env": {        "KAITEN_DOMAIN": "your-domain",        "KAITEN_TOKEN": "your-api-token"      }    }  }}

Claude Code

bash
claude mcp add kaiten -e KAITEN_DOMAIN=your-domain -e KAITEN_TOKEN=your-token -- npx -y @theyahia/kaiten-mcp

Cursor / Windsurf

json
{  "kaiten": {    "command": "npx",    "args": ["-y", "@theyahia/kaiten-mcp"],    "env": { "KAITEN_DOMAIN": "your-domain", "KAITEN_TOKEN": "your-api-token" }  }}

Авторизация

  1. В Kaiten откройте Профиль → API-токены и создайте токен.
  2. Запомните свой поддомен (например, mycompany из mycompany.kaiten.ru).
ПеременнаяОбяз.Описание
KAITEN_DOMAINда*Поддомен (mycompany) или полный хост (mycompany.kaiten.io). Голый поддомен разворачивается в .kaiten.ru.
KAITEN_TOKENдаBearer-токен из раздела Профиль → API-токены.
KAITEN_BASE_URLнетПолный базовый URL API для self-hosted / on-premise Kaiten, например https://kaiten.mycorp.ru/api/latest. Перекрывает KAITEN_DOMAIN.

* KAITEN_DOMAIN обязателен, если не задан KAITEN_BASE_URL.

У токена должны быть права на те сущности, с которыми вы работаете: читающим инструментам нужны права просмотра, а создающим, изменяющим и удаляющим — права редактирования.

Попробуйте этот промпт

«Создай задачу в колонке „In Progress“ доски „Sprint 23“, назначь @alex, добавь тег bug»

Агент выстроит цепочку list_spaces → list_boards → list_columns → create_card → list_users → add_card_member → add_card_tag.

Инструменты (63)

Количество считается по реестру при старте; точное число сервер пишет в лог при запуске.

Пространства

list_spaces · get_space · create_space · update_space · delete_space

Доски, колонки, дорожки

list_boards · get_board · create_board · update_board · delete_board · list_columns · create_column · update_column · delete_column · list_lanes · create_lane · update_lane · delete_lane

Карточки

list_cards (богатые фильтры: доска/колонка/дорожка/пространство, поисковый запрос, тег, тип, владелец, ответственный, участники, состояния, условие, архив, ASAP, просрочка, сроки, сортировка) · get_card · create_card · update_card (заголовок, описание, владелец, срок, ASAP, размер) · move_card (колонка + дорожка) · delete_card · get_card_location_history

Комментарии

add_comment · list_comments · update_comment · delete_comment

Участники и теги карточек

list_card_members · add_card_member · update_card_member_role · remove_card_member · list_card_tags · add_card_tag · remove_card_tag

Чек-листы

create_checklist · get_checklist · update_checklist · remove_checklist · add_checklist_item · update_checklist_item · remove_checklist_item

Дочерние карточки, ссылки, блокировки

list_card_children · add_card_child · remove_card_child · list_card_external_links · add_card_external_link · update_card_external_link · remove_card_external_link · list_card_blockers · block_card · update_card_blocker · unblock_card

Рабочее пространство и справочники

list_tags · list_users · get_current_user · list_card_types · list_sprints · get_sprint_summary · list_custom_properties · get_custom_property · list_custom_property_select_values

Списочные инструменты возвращают компактную проекцию (только ключевые поля), чтобы не жечь токены на больших досках. Инструменты get_* и все мутации возвращают полный JSON API.

HTTP-транспорт

По умолчанию сервер общается через stdio (для Claude Desktop и Claude Code). Чтобы запустить его как streamable-HTTP сервер:

bash
kaiten-mcp --http 3000# илиHTTP_PORT=3000 kaiten-mcp
  • GET /health → { status, tools, version }
  • POST /mcp → эндпоинт MCP streamable-HTTP

CORS выключен по умолчанию: задайте KAITEN_HTTP_CORS_ORIGIN с разрешённым origin (эндпоинт действует от имени вашего токена, поэтому никакого дефолтного wildcard нет).

Демо-промпты

Покажи все пространства, потом доски в пространстве 5Покажи колонки и дорожки на доске 123Создай карточку «Починить баг входа» на доске 123 в колонке 456Поставь карточке 789 срок на следующую пятницу и пометь как ASAPДобавь @alex в участники карточки 789 и повесь тег «bug»Добавь к карточке 789 чек-лист «QA» с пунктами «написать тесты» и «выкатить»Перенеси карточку 789 в колонку «Done»Кто я? (get_current_user)

Решение проблем

  • 401 / ошибка авторизации — проверьте, что KAITEN_TOKEN действителен и имеет права на нужную сущность. Сервер сообщает об ошибках авторизации явно.
  • .kaiten.io / self-hosted — задайте KAITEN_DOMAIN как полный хост (acme.kaiten.io) или KAITEN_BASE_URL как полный базовый URL вашего API.
  • list_boards ничего не возвращает без space_id — Kaiten отдаёт доски по пространствам; передайте space_id (это документированный путь).

Что не вошло

Эти возможности есть в API Kaiten, но сознательно оставлены за рамками интерактивного ассистента: SCIM-провижининг, массовые импорты, фреймворк аддонов и управление подписками на вебхуки. Документы и итерации, а также записывающие операции по кастомным полям и типам карточек пока не вынесены (формат их запросов нужно подтвердить на живом инстансе) — заведите issue, если они вам нужны.

Разработка

bash
npm installnpm run dev        # запуск из исходников (tsx)npm run build      # сборка в dist/npm test           # vitestnpm run coverage   # vitest + покрытиеnpm run lint       # eslintnpm run typecheck  # tsc --noEmit

Справочник API

Официальная документация API Kaiten: https://developers.kaiten.ru

Хорошо сочетается с

  • planfix-mcp — российский таск-трекер и CRM
  • megaplan-mcp — российская all-in-one бизнес-платформа
  • yandex-tracker-mcp — трекер Яндекса в духе Jira

Все 46 серверов — в каталоге WWmcp.

Лицензия

MIT


Часть WWmcp — каталог MCP для развивающихся рынков. ⭐ Поставьте звезду каталогу, если серверы оказались полезны, и заведите issue, если нужен сервер к ещё одному незападному API.


Часть WWmcp · Telegram: @vhodvai

来源:README.md,提交 74d58c3

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分