MCP-сервер для Kaiten с гибкой детализацией ответов

kaiten-mcp

Форк популярного MCP для Kaiten с 63 инструментами, регулируемой детализацией ответов и подробным гайдом по особенностям API для модели

MCP-серверРоссийский стек

amico1285/kaiten-mcpАвтор:Amico1285

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/amico1285-kaiten-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio --env 'KAITEN_API_TOKEN=<ваш KAITEN_API_TOKEN>' --env 'KAITEN_URL=<значение KAITEN_URL>' kaiten -- npx -y kaiten-mcp

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>",
        "KAITEN_URL": "<значение KAITEN_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

KAITEN_API_TOKENсекрет, обязательная
KAITEN_URLобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>",
        "KAITEN_URL": "<значение KAITEN_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

KAITEN_API_TOKENсекрет, обязательная
KAITEN_URLобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"kaiten","type":"stdio","command":"npx","args":["-y","kaiten-mcp"],"env":{"KAITEN_API_TOKEN":"<ваш KAITEN_API_TOKEN>","KAITEN_URL":"<значение KAITEN_URL>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "kaiten": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>",
        "KAITEN_URL": "<значение KAITEN_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

KAITEN_API_TOKENсекрет, обязательная
KAITEN_URLобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add kaiten --env 'KAITEN_API_TOKEN=<ваш KAITEN_API_TOKEN>' --env 'KAITEN_URL=<значение KAITEN_URL>' -- npx -y kaiten-mcp

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.kaiten]
command = "npx"
args = ["-y", "kaiten-mcp"]
env = { KAITEN_API_TOKEN = "<ваш KAITEN_API_TOKEN>", KAITEN_URL = "<значение KAITEN_URL>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

KAITEN_API_TOKENсекрет, обязательная
KAITEN_URLобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>",
        "KAITEN_URL": "<значение KAITEN_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

KAITEN_API_TOKENсекрет, обязательная
KAITEN_URLобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>",
        "KAITEN_URL": "<значение KAITEN_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

KAITEN_API_TOKENсекрет, обязательная
KAITEN_URLобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>",
        "KAITEN_URL": "<значение KAITEN_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

KAITEN_API_TOKENсекрет, обязательная
KAITEN_URLобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>",
        "KAITEN_URL": "<значение KAITEN_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

KAITEN_API_TOKENсекрет, обязательная
KAITEN_URLобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "kaiten": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "kaiten-mcp"
      ],
      "environment": {
        "KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>",
        "KAITEN_URL": "<значение KAITEN_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

KAITEN_API_TOKENсекрет, обязательная
KAITEN_URLобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>",
        "KAITEN_URL": "<значение KAITEN_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

KAITEN_API_TOKENсекрет, обязательная
KAITEN_URLобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<ваш KAITEN_API_TOKEN>",
        "KAITEN_URL": "<значение KAITEN_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

KAITEN_API_TOKENсекрет, обязательная
KAITEN_URLобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит c35f098.

Текст для агента

Создай токен в профиле Kaiten и добавь сервер в конфигурацию MCP клиента командой npx -y kaiten-mcp с переменными KAITEN_API_TOKEN и KAITEN_URL.

Другие способы из описания автора

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": ["-y", "kaiten-mcp"],
      "env": {
        "KAITEN_API_TOKEN": "your-api-token",
        "KAITEN_URL": "https://your-company.kaiten.ru"
      }
    }
  }
}

Фрагмент конфигурации из README.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер закрывает 63 операции над Kaiten: карточки, комментарии, учет времени, пространства и доски, подзадачи, теги, чек-листы, файлы, кастомные поля, пользователей, участников и блокировки карточек, внешние ссылки, спринты. Каждый инструмент принимает параметр verbosity (min, normal, max, raw), который управляет объемом возвращаемых данных. Есть кэш справочных данных с настраиваемым временем жизни, автоматические повторы при 429 и ошибках сети с экспоненциальной задержкой и идемпотентные ключи для операций записи. К проекту приложен файл LLM_GUIDE.md с описанием модели данных Kaiten и неочевидных особенностей API, которые автор советует прочитать модели перед первым вызовом.

Для кого. Для команд на Kaiten, которым важна тонкая настройка объема ответов и устойчивость к сбоям API.

Подходит, если

Нужна загрузка и учет файлов на карточке, а не только текстовые поля
Важно управлять размером ответа отдельно на каждый вызов через verbosity
Нужны автоповторы и идемпотентность на запись, чтобы не плодить дубли при сбоях

Не подходит, если

Нужен минимальный набор без 63 инструментов и лишних настроек: проще взять сервер поменьше
У Kaiten настроен OAuth-вход: API поддерживает только токены, сервер это учитывает

Пример запроса к агенту

Найди карточки в Kaiten с просроченным сроком и покажи, сколько времени в них залогировано

Ограничения

Это форк проекта iamtemazhe/mcp-kaiten с доработками автора, а не независимая разработка с нуля. Удаление карточки с залогированным временем сначала требует удалить логи времени отдельно. Автор один, звезд немного.

Как отключить. Удалите запись kaiten из конфигурации MCP клиента.

MCP

Транспорт: stdio
Авторизация: API-ключ

Переменные окружения
Переменные окружения
KAITEN_API_TOKEN обязательная, секрет	API-токен, Bearer
KAITEN_URL обязательная	Адрес инстанса Kaiten
KAITEN_DEFAULT_SPACE_ID	ID пространства по умолчанию для поиска карточек
KAITEN_ALLOWED_SPACE_IDS	Список ID пространств, к которым разрешен доступ
KAITEN_ALLOWED_BOARD_IDS	Список ID досок, к которым разрешен доступ

Проверка безопасности

Загружает и удаляет файлы на карточках
Может удалять карточки, комментарии и чек-листы

Коротко о README

README описывает происхождение проекта как форк mcp-kaiten с пятью волнами доработок (22 новых инструмента, починка схем, проверки перед записью), дает быстрый старт с одной командой npx, таблицу переменных окружения, список инструментов по 14 группам, механизмы надежности (кэш, ретраи, идемпотентность) и раздел с особенностями API Kaiten, обнаруженными на практике.

Частые вопросы

Что такое verbosity у инструментов?

Параметр min/normal/max/raw, который регулирует объем полей в ответе, от компактного до полного сырого JSON API.

Нужно ли указывать ID пользователя?

Нет, текущий пользователь определяется автоматически по токену.

SiYuan

Официальный

Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам

MCP-серверСредний риск46,5 тыс.

gws

Выбор редакции

CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие

CLIВысокий риск31,2 тыс.

QMD

Выбор редакции

Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP

CLIСредний риск30,1 тыс.

Taskmaster

Выбор редакции

Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI

MCP-серверСредний риск28,1 тыс.

Установка

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

Ограничения

MCP

Проверка безопасности

Коротко о README

Частые вопросы

Похожие

SiYuan

gws

QMD

Taskmaster