MCP-сервер для Kaiten с командным хостингом
kaiten-mcp
MCP-сервер для Kaiten с пакетом на PyPI, локальным stdio и удаленным Streamable HTTP для всей команды через Docker или Kubernetes
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Создает и обновляет карточки на реальной доске
- В командном режиме сервер хостится отдельно, токены передаются на его сторону
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/evvfebruary-kaiten-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'KAITEN_API_TOKEN=<ваш KAITEN_API_TOKEN>' kaiten-mcp -- uvx kaiten-mcp==0.1.0Или добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"kaiten-mcp": {
"command": "uvx",
"args": [
"kaiten-mcp==0.1.0"
],
"env": {
"KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
KAITEN_API_TOKENсекрет, обязательная- Kaiten API token from Profile > API key.
KAITEN_WORKSPACE_SLUGнеобязательная- Kaiten workspace slug. Required unless KAITEN_BASE_URL is set.
KAITEN_BASE_URLнеобязательная- Full Kaiten API root for on-prem or custom domains. Required unless KAITEN_WORKSPACE_SLUG is set.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"kaiten-mcp": {
"command": "uvx",
"args": [
"kaiten-mcp==0.1.0"
],
"env": {
"KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
KAITEN_API_TOKENсекрет, обязательная- Kaiten API token from Profile > API key.
KAITEN_WORKSPACE_SLUGнеобязательная- Kaiten workspace slug. Required unless KAITEN_BASE_URL is set.
KAITEN_BASE_URLнеобязательная- Full Kaiten API root for on-prem or custom domains. Required unless KAITEN_WORKSPACE_SLUG is set.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"kaiten-mcp","type":"stdio","command":"uvx","args":["kaiten-mcp==0.1.0"],"env":{"KAITEN_API_TOKEN":"<ваш KAITEN_API_TOKEN>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"kaiten-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"kaiten-mcp==0.1.0"
],
"env": {
"KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
KAITEN_API_TOKENсекрет, обязательная- Kaiten API token from Profile > API key.
KAITEN_WORKSPACE_SLUGнеобязательная- Kaiten workspace slug. Required unless KAITEN_BASE_URL is set.
KAITEN_BASE_URLнеобязательная- Full Kaiten API root for on-prem or custom domains. Required unless KAITEN_WORKSPACE_SLUG is set.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add kaiten-mcp --env 'KAITEN_API_TOKEN=<ваш KAITEN_API_TOKEN>' -- uvx kaiten-mcp==0.1.0Или добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.kaiten-mcp]
command = "uvx"
args = ["kaiten-mcp==0.1.0"]
env = { KAITEN_API_TOKEN = "<ваш KAITEN_API_TOKEN>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
KAITEN_API_TOKENсекрет, обязательная- Kaiten API token from Profile > API key.
KAITEN_WORKSPACE_SLUGнеобязательная- Kaiten workspace slug. Required unless KAITEN_BASE_URL is set.
KAITEN_BASE_URLнеобязательная- Full Kaiten API root for on-prem or custom domains. Required unless KAITEN_WORKSPACE_SLUG is set.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
gemini mcp add -s user -e 'KAITEN_API_TOKEN=<ваш KAITEN_API_TOKEN>' kaiten-mcp uvx kaiten-mcp==0.1.0Или добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"kaiten-mcp": {
"command": "uvx",
"args": [
"kaiten-mcp==0.1.0"
],
"env": {
"KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
KAITEN_API_TOKENсекрет, обязательная- Kaiten API token from Profile > API key.
KAITEN_WORKSPACE_SLUGнеобязательная- Kaiten workspace slug. Required unless KAITEN_BASE_URL is set.
KAITEN_BASE_URLнеобязательная- Full Kaiten API root for on-prem or custom domains. Required unless KAITEN_WORKSPACE_SLUG is set.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"kaiten-mcp": {
"command": "uvx",
"args": [
"kaiten-mcp==0.1.0"
],
"env": {
"KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
KAITEN_API_TOKENсекрет, обязательная- Kaiten API token from Profile > API key.
KAITEN_WORKSPACE_SLUGнеобязательная- Kaiten workspace slug. Required unless KAITEN_BASE_URL is set.
KAITEN_BASE_URLнеобязательная- Full Kaiten API root for on-prem or custom domains. Required unless KAITEN_WORKSPACE_SLUG is set.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"kaiten-mcp": {
"command": "uvx",
"args": [
"kaiten-mcp==0.1.0"
],
"env": {
"KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
KAITEN_API_TOKENсекрет, обязательная- Kaiten API token from Profile > API key.
KAITEN_WORKSPACE_SLUGнеобязательная- Kaiten workspace slug. Required unless KAITEN_BASE_URL is set.
KAITEN_BASE_URLнеобязательная- Full Kaiten API root for on-prem or custom domains. Required unless KAITEN_WORKSPACE_SLUG is set.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"kaiten-mcp": {
"command": "uvx",
"args": [
"kaiten-mcp==0.1.0"
],
"env": {
"KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
KAITEN_API_TOKENсекрет, обязательная- Kaiten API token from Profile > API key.
KAITEN_WORKSPACE_SLUGнеобязательная- Kaiten workspace slug. Required unless KAITEN_BASE_URL is set.
KAITEN_BASE_URLнеобязательная- Full Kaiten API root for on-prem or custom domains. Required unless KAITEN_WORKSPACE_SLUG is set.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"kaiten-mcp": {
"type": "local",
"command": [
"uvx",
"kaiten-mcp==0.1.0"
],
"environment": {
"KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
KAITEN_API_TOKENсекрет, обязательная- Kaiten API token from Profile > API key.
KAITEN_WORKSPACE_SLUGнеобязательная- Kaiten workspace slug. Required unless KAITEN_BASE_URL is set.
KAITEN_BASE_URLнеобязательная- Full Kaiten API root for on-prem or custom domains. Required unless KAITEN_WORKSPACE_SLUG is set.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"kaiten-mcp": {
"command": "uvx",
"args": [
"kaiten-mcp==0.1.0"
],
"env": {
"KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
KAITEN_API_TOKENсекрет, обязательная- Kaiten API token from Profile > API key.
KAITEN_WORKSPACE_SLUGнеобязательная- Kaiten workspace slug. Required unless KAITEN_BASE_URL is set.
KAITEN_BASE_URLнеобязательная- Full Kaiten API root for on-prem or custom domains. Required unless KAITEN_WORKSPACE_SLUG is set.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"kaiten-mcp": {
"command": "uvx",
"args": [
"kaiten-mcp==0.1.0"
],
"env": {
"KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
KAITEN_API_TOKENсекрет, обязательная- Kaiten API token from Profile > API key.
KAITEN_WORKSPACE_SLUGнеобязательная- Kaiten workspace slug. Required unless KAITEN_BASE_URL is set.
KAITEN_BASE_URLнеобязательная- Full Kaiten API root for on-prem or custom domains. Required unless KAITEN_WORKSPACE_SLUG is set.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Экспортируй KAITEN_API_TOKEN и KAITEN_WORKSPACE_SLUG, затем запусти сервер командой uvx kaiten-mcp --transport stdio, либо добавь его в Claude Code командой claude mcp add --transport stdio kaiten -- uv run kaiten-mcp --transport stdio.
Другие способы из описания автора
uvx kaiten-mcp --transport stdioТребуются переменные KAITEN_API_TOKEN и KAITEN_WORKSPACE_SLUG в окружении.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер связывает пространства, доски, колонки и дорожки Kaiten с задачами: список пространств и досок, создание и обновление карточек, компактный фильтрованный список задач, перемещение между колонками, комментарии и теги. Запускается локально по stdio командой uvx без клонирования репозитория, либо как удаленный Streamable HTTP сервер в Docker или Kubernetes, где каждый в команде передает свой токен Kaiten в заголовке запроса. По умолчанию ответы обрезаны до ключевых полей и постранично отдаются по 20 записей, чтобы не раздувать контекст модели, а размер payload проверяется отдельными бенчмарками.
Для кого. Для команд на Kaiten, которым нужен и личный локальный сервер, и общий удаленный для нескольких сотрудников.
Подходит, если
- Нужно подключить Kaiten к Cursor или Claude Code без клонирования репозитория, через uvx
- Нужен общий сервер для команды с Docker или Kubernetes, где каждый передает свой токен
- Важна экономия контекста: короткие списки и структурированные логи
Не подходит, если
- Нужны чек-листы или учет времени: этих инструментов в списке нет
- Устраивает готовая OAuth-авторизация в браузере: сервер сознательно использует только токен на запрос
Пример запроса к агенту
Покажи задачи на доске X в Kaiten и перенеси карточку 1234 в колонку In ProgressОграничения
Нет инструментов для чек-листов и учета времени, набор ограничен пространствами, досками и карточками. Для запуска нужен Python 3.12+ и uv. У удаленного HTTP-режима нет встроенной OAuth-авторизации, только Bearer-токен в заголовке.
Как отключить. Остановите процесс или удалите запись kaiten из .cursor/mcp.json либо .mcp.json Claude Code.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| KAITEN_API_TOKEN обязательная, секрет | Bearer или токен из профиля Kaiten |
| KAITEN_WORKSPACE_SLUG обязательная | Slug инстанса, например acme для acme.kaiten.ru; вместо него можно KAITEN_BASE_URL |
| KAITEN_BASE_URL | Полный корень API для on-prem установки |
| KAITEN_HOST | Адрес для HTTP-режима, по умолчанию 127.0.0.1 |
| KAITEN_PORT | Порт для HTTP-режима, по умолчанию 8000 |
Проверка безопасности
- Создает и обновляет карточки на реальной доске
- В командном режиме сервер хостится отдельно, токены передаются на его сторону
Коротко о README
README объясняет запуск через uvx без клонирования, подключение в Cursor и Claude Code через готовые файлы .cursor/mcp.json и .mcp.json, разворачивание удаленного Streamable HTTP сервера в Docker и Kubernetes с моделью токена на запрос, таблицу переменных окружения, подход к экономии токенов со страницами по 20 записей и обрезкой полей, структурированное логирование в stderr и FAQ по отличиям от других kaiten-mcp.
Частые вопросы
Нужно ли клонировать репозиторий?
Нет, uvx скачивает пакет kaiten-mcp из PyPI и запускает его в изолированном окружении.
Можно ли поставить сервер один на всю команду?
Да, режим Streamable HTTP в Docker или Kubernetes, каждый сотрудник передает свой Bearer-токен Kaiten в заголовке запроса.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI