@che-tools/kaiten-mcp 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +114 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
# @che-tools/kaiten-mcp
|
|
2
|
+
|
|
3
|
+
MCP-сервер для [Kaiten](https://kaiten.ru/): пространства, доски, карточки, комментарии, чек-листы, внешние ссылки, поиск.
|
|
4
|
+
|
|
5
|
+
## Требования
|
|
6
|
+
|
|
7
|
+
- Node.js >= 18
|
|
8
|
+
- Аккаунт Kaiten и API-токен
|
|
9
|
+
|
|
10
|
+
Токен: Настройки профиля → Ключ доступа API → Создать ключ.
|
|
11
|
+
Домен — поддомен инстанса (`mycompany` для `mycompany.kaiten.ru`).
|
|
12
|
+
|
|
13
|
+
## Переменные окружения
|
|
14
|
+
|
|
15
|
+
| Переменная | Описание |
|
|
16
|
+
| --------------- | -------------------------------- |
|
|
17
|
+
| `KAITEN_DOMAIN` | Поддомен (например, `mycompany`) |
|
|
18
|
+
| `KAITEN_TOKEN` | Bearer-токен API Kaiten |
|
|
19
|
+
|
|
20
|
+
## Быстрый старт
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
KAITEN_DOMAIN=mycompany KAITEN_TOKEN=xxx npx -y @che-tools/kaiten-mcp
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Cursor
|
|
27
|
+
|
|
28
|
+
`~/.cursor/mcp.json` или конфиг проекта:
|
|
29
|
+
|
|
30
|
+
```json
|
|
31
|
+
{
|
|
32
|
+
"mcpServers": {
|
|
33
|
+
"kaiten": {
|
|
34
|
+
"command": "npx",
|
|
35
|
+
"args": ["-y", "@che-tools/kaiten-mcp"],
|
|
36
|
+
"env": {
|
|
37
|
+
"KAITEN_DOMAIN": "mycompany",
|
|
38
|
+
"KAITEN_TOKEN": "your-token"
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## Другие клиенты
|
|
46
|
+
|
|
47
|
+
Конфиг везде один и тот же: `npx` + `-y` + `@che-tools/kaiten-mcp` и переменные `KAITEN_DOMAIN` / `KAITEN_TOKEN`.
|
|
48
|
+
|
|
49
|
+
| Клиент | Куда писать |
|
|
50
|
+
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
51
|
+
| GitHub Copilot (VS Code) | User MCP config или `.vscode/mcp.json` (`servers`, `"type": "stdio"`) |
|
|
52
|
+
| Claude Desktop | macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`; Windows: `%APPDATA%\Claude\claude_desktop_config.json` (или Settings → Developer → Edit Config) |
|
|
53
|
+
| Claude Code | `claude mcp add --scope user kaiten -e KAITEN_DOMAIN=… -e KAITEN_TOKEN=… -- npx -y @che-tools/kaiten-mcp` · либо `~/.claude.json` / `.mcp.json` |
|
|
54
|
+
| Qwen CLI | `qwen mcp add … -- npx -y @che-tools/kaiten-mcp` · `.qwen/settings.json` |
|
|
55
|
+
| Gemini CLI | `gemini mcp add … -- npx -y @che-tools/kaiten-mcp` · `~/.gemini/settings.json` |
|
|
56
|
+
| KiloCode | Global/Project MCP (`mcp_settings.json` / `.kilocode/mcp.json`) |
|
|
57
|
+
|
|
58
|
+
Пример JSON (Claude Desktop, Claude Code, Qwen, Gemini, KiloCode, Cursor):
|
|
59
|
+
|
|
60
|
+
```json
|
|
61
|
+
{
|
|
62
|
+
"mcpServers": {
|
|
63
|
+
"kaiten": {
|
|
64
|
+
"command": "npx",
|
|
65
|
+
"args": ["-y", "@che-tools/kaiten-mcp"],
|
|
66
|
+
"env": {
|
|
67
|
+
"KAITEN_DOMAIN": "mycompany",
|
|
68
|
+
"KAITEN_TOKEN": "your-token"
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Для Copilot — та же схема, но ключ `servers` и поле `"type": "stdio"`.
|
|
76
|
+
|
|
77
|
+
## space_id
|
|
78
|
+
|
|
79
|
+
Из ссылки на карточку: `space/20874/boards/card/59923149` → `space_id=20874`, `card_id=59923149`.
|
|
80
|
+
Параметр опциональный; при указании запросы идут через `/spaces/:spaceId/cards/...`.
|
|
81
|
+
|
|
82
|
+
## Инструменты
|
|
83
|
+
|
|
84
|
+
| Инструмент | Описание |
|
|
85
|
+
| ------------------------------ | --------------------------- |
|
|
86
|
+
| `kaiten_list_spaces` | Список пространств |
|
|
87
|
+
| `kaiten_list_boards` | Список досок |
|
|
88
|
+
| `kaiten_get_board` | Доска по id |
|
|
89
|
+
| `kaiten_list_users` | Список пользователей |
|
|
90
|
+
| `kaiten_get_card` | Карточка по id |
|
|
91
|
+
| `kaiten_create_card` | Создать карточку |
|
|
92
|
+
| `kaiten_move_card` | Переместить карточку |
|
|
93
|
+
| `kaiten_update_card` | Изменить заголовок/описание |
|
|
94
|
+
| `kaiten_get_card_tasks` | Описание и пункты чек-листа |
|
|
95
|
+
| `kaiten_add_checklist` | Добавить чек-лист |
|
|
96
|
+
| `kaiten_add_checklist_item` | Добавить пункт чек-листа |
|
|
97
|
+
| `kaiten_update_checklist_item` | Изменить пункт чек-листа |
|
|
98
|
+
| `kaiten_add_comment` | Добавить комментарий |
|
|
99
|
+
| `kaiten_get_comments` | Список комментариев |
|
|
100
|
+
| `kaiten_add_external_link` | Прикрепить ссылку |
|
|
101
|
+
| `kaiten_update_external_link` | Изменить ссылку |
|
|
102
|
+
| `kaiten_get_external_links` | Список внешних ссылок |
|
|
103
|
+
| `kaiten_search_cards` | Поиск карточек |
|
|
104
|
+
| `kaiten_list_board_cards` | Карточки доски |
|
|
105
|
+
|
|
106
|
+
## API
|
|
107
|
+
|
|
108
|
+
- Документация: https://developers.kaiten.ru/
|
|
109
|
+
- Базовый URL: `https://<домен>.kaiten.ru/api/v1`
|
|
110
|
+
- Лимит: 5 запросов в секунду
|
|
111
|
+
|
|
112
|
+
## License
|
|
113
|
+
|
|
114
|
+
MIT
|