io.github.theYahia/kaiten-mcp
MCP server for Kaiten API — cards, boards. 3 tools.
Open source Open in the app JSON README (API)
About
MCP server for Kaiten API — cards, boards. 3 tools.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- theyahia
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.0
- Stars
- 1
- Forks
- 1
- Open pull requests
- 1
- Last push
- 2026-09-03T04:53:50Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:01:31
- Updated
- 2026-08-29 04:01:31
- Origin id
io.github.theYahia/kaiten-mcp
README
# MCP-сервер для Kaiten — канбан-доски, карточки и спринты через ИИ
> 📦 Часть **[WWmcp — Emerging Markets MCP](https://github.com/theYahia/WWmcp)** — 46 MCP-серверов к незападным API (Бразилия / MENA / Залив / Юго-Восточная Азия / Африка / СНГ).
Если вы искали, как подключить Kaiten к нейросети, разобрать доску и двигать карточки не перетаскивая их мышкой — это оно. 63 инструмента: пространства, доски, колонки, дорожки, карточки с фильтрами, комментарии, участники, теги, чек-листы, дочерние карточки, внешние ссылки, блокировки, типы карточек, спринты, кастомные поля и пользователи. Пишете «перенеси всё из Review в Done и поставь дедлайн на пятницу» — переносит.
> MCP-сервер к API канбан-платформы **Kaiten**. **63 инструмента**: пространства, доски, колонки, дорожки, карточки (с богатыми фильтрами), комментарии, участники, теги, чек-листы, дочерние карточки, внешние ссылки, блокировки, типы карточек, спринты, кастомные поля и пользователи.
[](https://www.npmjs.com/package/@theyahia/kaiten-mcp)
[](https://opensource.org/licenses/MIT)
Часть серии [WWmcp](https://github.com/theYahia/WWmcp) от [@theYahia](https://github.com/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 install
npm run dev # запуск из исходников (tsx)
npm run build # сборка в dist/
npm test # vitest
npm run coverage # vitest + покрытие
npm run lint # eslint
npm run typecheck # tsc --noEmit
```
## Справочник API
Официальная документация API Kaiten: <https://developers.kaiten.ru>
## Хорошо сочетается с
- **[planfix-mcp](https://github.com/theYahia/planfix-mcp)** — российский таск-трекер и CRM
- **[megaplan-mcp](https://github.com/theYahia/megaplan-mcp)** — российская all-in-one бизнес-платформа
- **[yandex-tracker-mcp](https://github.com/theYahia/yandex-tracker-mcp)** — трекер Яндекса в духе Jira
Все 46 серверов — в [каталоге WWmcp](https://github.com/theYahia/WWmcp).
## Лицензия
MIT
---
**Часть [WWmcp](https://github.com/theYahia/WWmcp)** — каталог MCP для развивающихся рынков. ⭐ Поставьте звезду каталогу, если серверы оказались полезны, и [заведите issue](https://github.com/theYahia/WWmcp/issues), если нужен сервер к ещё одному незападному API.
---
Часть [WWmcp](https://github.com/theYahia/WWmcp) · Telegram: [@vhodvai](https://t.me/vhodvai)