MCP-сервер Kaiten с ограничением по пространствам и доскам
kaiten-mcp
Stdio-сервер на Bun для карточек, документов и учета времени Kaiten: белые списки пространств, досок и хостов вложений, правка по версии карточки
- 0 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Пишет и архивирует карточки от имени владельца токена
- Рамки пространств и досок помогают, но задаются самим пользователем
Установка
- Работает в
- Сервисы
Ручная установка
{
"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 и вызывает только инструменты чтения, нужны те же токен и адрес.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Kaiten — все инструментыMCP-сервер для Kaiten с документами
kaiten-mcp
MCP-сервер для Kaiten на 66 инструментов, единственный из набора с поддержкой документов Kaiten и вложенных обсуждений в них
Локальный stdio-сервер на Node.js 24: поиск и правка карточек Kaiten, чек-листы, комментарии и пользовательские поля из Codex и Claude Code
MCP-сервер для Kaiten: карточки, комментарии, пространства и доски с управлением детализацией ответов
Kaiten MCP
kaiten-mcp
MCP-сервер для Kaiten на Swift: пространства, доски, колонки, дорожки, карточки, комментарии и пользовательские поля
Go-бинарник без записи: 23 инструмента чтения для Kaiten, все запросы идут методом GET, подключение в Codex, Claude Code и Claude Desktop
Kaiten MCP Tools: чтение карточек и вложений, 37 инструментов
kaiten-mcp-tools
Npm-пакет только для чтения: 37 инструментов по карточкам, доскам, документам и учету времени, оригиналы вложений скачиваются для разбора агентом
Коротко о README
Текст идет от требований к быстрому старту, затем два примера подключения: JSON для Cursor и `config.toml` для Codex. Далее таблица переменных окружения с описанием ограничений и два списка инструментов, чтения и записи, с указанием обязательных параметров вроде `expected_version`. Отдельно оговорено, что Kaiten пишет от имени владельца токена.