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 分