MCP-сервер Kaiten с ограничением по пространствам и доскам

kaiten-mcp

Stdio-сервер на Bun для карточек, документов и учета времени Kaiten: белые списки пространств, досок и хостов вложений, правка по версии карточки

  • 0 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Пишет и архивирует карточки от имени владельца токена
  • Рамки пространств и досок помогают, но задаются самим пользователем
Все причины и проверки
Российский стек

servertdot/kaiten-mcp

Установка

Сервисы

Ручная установка

{
  "mcpServers": {
    "kaiten": {
      "command": "bun",
      "args": ["run", "/absolute/path/to/kaiten-mcp/src/index.ts"],
      "env": {
        "KAITEN_TOKEN": "your-token",
        "KAITEN_BASE_URL": "https://your-company.kaiten.ru/api/v1"
      }
    }
  }
}

Фрагмент настроек Cursor из README.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Пишет и архивирует карточки от имени владельца токена
  • Рамки пространств и досок помогают, но задаются самим пользователем

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

Что делает

Сервер на Bun дает агенту чтение и запись в Kaiten: поиск карточек, описание, комментарии, чек-листы, дочерние связи, вложения, связанные документы и записи учета времени. Читают карту пространств с досками, колонками и дорожками, документы компании по uid или ключу, теги, пользователей, типы карточек, блокеры и ленту активности. Пишут карточки, перемещают их внутри пространства, архивируют и правят связанные Markdown-документы. Рамки задаются окружением: разрешенные пространства и доски, пространство по умолчанию, проверка автора записи через `KAITEN_EXPECTED_ACTOR_ID` и белый список хостов вложений с лимитом 5 МиБ. Правка карточки требует `expected_version`, а текст документов и вложений помечен как недоверенные данные.

Для кого. Командам, которые пускают агента в общий Kaiten и хотят заранее ограничить его конкретными пространствами, досками и проверкой автора правок.

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

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

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

  • Агент должен перемещать карточки между пространствами: сервер это запрещает
  • Нужен готовый пакет для `npx`: установка идет из клона репозитория
  • Среда без Bun: сервер запускается только им

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

Найди карточки пространства Разработка с тегом bug и прочитай описание и комментарии самой старой

MCP

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

Переменные окружения

KAITEN_TOKEN обязательная, секрет
Bearer-токен из профиля Kaiten
KAITEN_BASE_URL обязательная
Домен или полный URL API
KAITEN_SPACE_IDS
Разрешенные пространства через запятую
KAITEN_ALLOWED_BOARD_IDS
Разрешенные доски для записи
KAITEN_EXPECTED_ACTOR_ID
Блокирует запись, если токен принадлежит другому пользователю
KAITEN_FILE_HOSTS
Белый список хостов вложений

Ограничения

Установка идет из клона репозитория через Bun 1.x, пакета в npm нет, в репозитории не указана лицензия. Записи в Kaiten выполняются от имени владельца токена: `KAITEN_EXPECTED_ACTOR_ID` только отказывает при несовпадении, подменить автора он не может. Для вложений нужен явный белый список хостов, иначе файлы не читаются. Живая проверка записи вынесена в отдельный скрипт с флагом `--confirm-live-write`. Звезд нет, автор один, коммиты идут регулярно, последний 27 октября 2026.

Как отключить. Уберите запись `kaiten` из конфигурации MCP клиента или выполните `claude mcp remove kaiten`, токен отзовите в профиле Kaiten.

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

Как ограничить агента одним пространством?

Задайте `KAITEN_SPACE_IDS` со списком разрешенных пространств и `KAITEN_DEFAULT_SPACE_ID`. Для записи дополнительно сужает доступ `KAITEN_ALLOWED_BOARD_IDS`.

Что даст `KAITEN_EXPECTED_ACTOR_ID`?

Сервер откажется писать, если токен принадлежит не тому пользователю, которого вы ожидаете. Автора записи это не подменяет: Kaiten всегда пишет от имени владельца токена.

Что нужно для чтения вложений?

Хост файлов в `KAITEN_FILE_HOSTS`, например `files.your-company.kaiten.ru`. Лимит размера по умолчанию 5 МиБ меняется переменной `KAITEN_MAX_ATTACHMENT_BYTES`.

Зачем `expected_version` при правке?

Сервер сверяет версию карточки, которую агент прочитал, с текущей и отказывает при расхождении. Это защищает от затирания чужой правки.

Как проверить сервер без записи?

Команда `bun run smoke` поднимает сервер по stdio и вызывает только инструменты чтения, нужны те же токен и адрес.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

MCP-сервер для Kaiten на 66 инструментов, единственный из набора с поддержкой документов Kaiten и вложенных обсуждений в них

MCP-серверШирокий доступ
Российский стек

MCP-сервер для Kaiten: карточки, комментарии, пространства и доски с управлением детализацией ответов

MCP-серверШирокий доступ33Звезды репозитория

Kaiten MCP

kaiten-mcp

Российский стек

MCP-сервер для Kaiten на Swift: пространства, доски, колонки, дорожки, карточки, комментарии и пользовательские поля

MCP-серверШирокий доступ20Звезды репозитория
Российский стек

Npm-пакет только для чтения: 37 инструментов по карточкам, доскам, документам и учету времени, оригиналы вложений скачиваются для разбора агентом

MCP-серверМинимальный доступ1Звезды репозитория

Коротко о README

Текст идет от требований к быстрому старту, затем два примера подключения: JSON для Cursor и `config.toml` для Codex. Далее таблица переменных окружения с описанием ограничений и два списка инструментов, чтения и записи, с указанием обязательных параметров вроде `expected_version`. Отдельно оговорено, что Kaiten пишет от имени владельца токена.

Бейдж для README

Сообщить о проблеме