Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
제작자가 쓴 설명(영어 원문)
Manage Kaiten spaces, boards, cards, comments, and tags with compact MCP responses.
이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.
이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
KAITEN_API_TOKEN, KAITEN_WORKSPACE_SLUG, KAITEN_BASE_URL비밀로 표시된 값은 내 계정의 열쇠예요. 절대 다른 사람과 공유하거나 채팅에 붙여 넣지 마세요.
필요한 것
어떤 앱을 쓰세요?
위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.
Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요
{
"mcpServers": {
"kaiten": {
"command": "uvx",
"args": [
"kaiten-mcp"
],
"env": {
"KAITEN_API_TOKEN": "your-value",
"KAITEN_WORKSPACE_SLUG": "your-value",
"KAITEN_BASE_URL": "your-value"
}
}
}
}터미널에서 이 명령어를 실행하세요
claude mcp add kaiten --env KAITEN_API_TOKEN=your-value --env KAITEN_WORKSPACE_SLUG=your-value --env KAITEN_BASE_URL=your-value -- uvx kaiten-mcp실행하기 전에 빈 값을 채워 주세요.
프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요
{
"mcpServers": {
"kaiten": {
"command": "uvx",
"args": [
"kaiten-mcp"
],
"env": {
"KAITEN_API_TOKEN": "your-value",
"KAITEN_WORKSPACE_SLUG": "your-value",
"KAITEN_BASE_URL": "your-value"
}
}
}
}브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.
프로젝트의 .vscode/mcp.json에 붙여 넣으세요
{
"servers": {
"kaiten": {
"type": "stdio",
"command": "uvx",
"args": [
"kaiten-mcp"
],
"env": {
"KAITEN_API_TOKEN": "your-value",
"KAITEN_WORKSPACE_SLUG": "your-value",
"KAITEN_BASE_URL": "your-value"
}
}
}
}브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.
이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.
선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.
KAITEN_WORKSPACE_SLUG envKAITEN_BASE_URL env이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 7일 점검
레지스트리 이름이 GitHub 계정 evvfebruary 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
입력해야 할 값: KAITEN_API_TOKEN
내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).
GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(0.1.0)은 4개월 전 레지스트리에 올라왔어요.
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Python (uv)도 있어야 해요.
같은 카테고리에는: Spec Driven Development, Remote Desktop Commander, Qemu MCP
같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.
카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Boot and drive QEMU VMs from an AI agent: keys, screenshots, serial. No guest agent.
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
Русский | English
MCP-сервер для [Kaiten](https://kaiten.ru/) — интеграция канбан-досок и задач Kaiten с AI-ассистентами (Cursor, Claude Code и любым MCP-клиентом).
Управляйте карточками прямо из чата: создавайте задачи, перемещайте по колонкам, обновляйте описания, оставляйте комментарии и теги — без ручного копирования из веб-интерфейса и без огромных JSON-ответов API в контексте модели.
POST /mcp) для командного хостингаkaiten-mcp-benchmark), чтобы ответы не раздувались со временемhttps://<компания>.kaiten.ru/profile/api-key)export KAITEN_API_TOKEN='ваш-токен'
export KAITEN_WORKSPACE_SLUG='ваша-компания' # → https://ваша-компания.kaiten.ru/api/v1
uvx kaiten-mcp --transport stdio
uvx скачивает пакет из PyPI, создаёт изолированное окружение и запускает сервер. Клонировать репозиторий не требуется.
Для on-prem / кастомного домена вместо slug задайте полный корень API:
export KAITEN_BASE_URL='https://kaiten.example.com/api/v1'
Остальные переменные — в .env.example.
Для разработки в этом репозитории конфиг уже есть: .cursor/mcp.json. Для использования в другом проекте добавьте сервер в его .cursor/mcp.json, сохранив существующие записи:
{
"mcpServers": { "kaiten": { "command": "uvx", "args": ["kaiten-mcp", "--transport", "stdio"], "env": { "KAITEN_API_TOKEN": "${env:KAITEN_API_TOKEN}", "KAITEN_WORKSPACE_SLUG": "${env:KAITEN_WORKSPACE_SLUG}" } } } }
Этот вариант устанавливает пакет из PyPI и не требует клонирования репозитория. uvx должен быть доступен в PATH процесса Cursor. Для on-prem замените запись workspace slug на "KAITEN_BASE_URL": "${env:KAITEN_BASE_URL}" и экспортируйте полный корень API.
export KAITEN_API_TOKEN='ваш-токен'
export KAITEN_WORKSPACE_SLUG='ваша-компания'
kaiten подключился.${env:KAITEN_API_TOKEN} и ${env:KAITEN_WORKSPACE_SLUG} подставляет Cursor. Не коммитьте реальные токены.
Конфиг проекта: .mcp.json.
export KAITEN_API_TOKEN='ваш-токен'
export KAITEN_WORKSPACE_SLUG='ваша-компания' claude mcp list
Или вручную:
claude mcp add --transport stdio kaiten -- uvx kaiten-mcp --transport stdio
MCP-сервер предоставляет инструменты и доступ к Kaiten. Бесплатный skill подсказывает агенту, как находить и изменять карточки, готовить задачи, делать обзор доски и предлагать улучшения очереди. Установка skill не подключает сервер: сначала настройте MCP.
Сохраните файл skill в .cursor/skills/kaiten/SKILL.md своего проекта. Или скопируйте его из локального клона этого репозитория:
mkdir -p /path/to/your-project/.cursor/skills/kaiten
cp skills/kaiten/SKILL.md /path/to/your-project/.cursor/skills/kaiten/SKILL.md
Замените /path/to/your-project на путь своего проекта; перед заменой существующего skill проверьте его содержимое. Начните новый Agent-чат и убедитесь, что skill доступен. Cursor может выбирать его для запросов о Kaiten; подробности — в документации Cursor. Для другого клиента с поддержкой skills используйте его каталог установки. Инструкции написаны на английском, но агент отвечает на языке пользователя.
Примеры менеджерских запросов:
Обзор отражает доступное текущее состояние доски. Инструменты не предоставляют полной истории для расчёта throughput за неделю или cycle time.
Сценарий записи в Cursor: создать карточку → переместить → получить обзор демонстрационных задач. Тестовый стенд подготовлен; реальная запись в Cursor ещё не выполнена. Подготовка стенда и проверки.
Типовой порядок инструментов:
list_spaces → list_boards → list_columns / list_lanescreate_task / list_tasks / get_task / update_task / move_taskadd_comment / add_tag_to_task при необходимости| Инструмент | Назначение |
|---|---|
list_spaces | Список пространств (id, title) |
list_boards | Доски пространства |
list_columns | Колонки доски |
list_lanes | Дорожки доски |
create_task | Создать карточку (title + board_id) |
get_task | Детали задачи (include_description — по запросу) |
list_tasks | Фильтрованный компактный список (query, board, column, tag, …) |
update_task | Обновление полей (title, description, owner, condition, …) |
move_task | Перемещение (board / column / lane / sort) |
add_comment / list_comments | Комментарии |
list_tags / get_task_tags | Теги |
add_tag_to_task | Добавить тег по имени |
remove_tag_from_task | Снять тег по id |
Streamable HTTP:
uv run kaiten-mcp --transport streamable-http --host 0.0.0.0 --port 8000
GET /healthzPOST /mcpDocker:
docker pull ghcr.io/evvfebruary/kaiten-mcp:latest
docker run --rm -p 8000:8000 \ -e KAITEN_WORKSPACE_SLUG=ваша-компания \ ghcr.io/evvfebruary/kaiten-mcp:latest
Для локальной разработки образ можно собрать командой docker build -t kaiten-mcp ..
Каждый клиент передаёт свой токен:
Authorization: Bearer <kaiten-api-token>
Примеры конфигов:
examples/remote-mcp/cursor.mcp.jsonexamples/remote-mcp/claude.mcp.jsonЗаметки для Kubernetes:
stateless_http=True)AuthorizationHTTP всегда требует Bearer-токен вызывающего; общий KAITEN_API_TOKEN используется только в stdio. Полноценная MCP OAuth-авторизация пока не реализована.
| Переменная | Обязательна | Описание | |||
|---|---|---|---|---|---|
KAITEN_API_TOKEN | Да (stdio) | API-токен; для HTTP — также в Authorization: Bearer | |||
KAITEN_WORKSPACE_SLUG | Да\* | Slug: acme → https://acme.kaiten.ru/api/v1 | |||
KAITEN_BASE_URL | Да\* | Полный корень API (on-prem); имеет приоритет над slug | |||
KAITEN_HOST / KAITEN_PORT | Нет | Bind для HTTP (по умолчанию 127.0.0.1:8000) | |||
KAITEN_LOG_LEVEL | Нет | DEBUG \ | INFO \ | WARNING \ | ERROR |
KAITEN_LOG_FORMAT | Нет | text \ | json | ||
KAITEN_LOG_BODIES | Нет | Компактные redacted-превью в логах | |||
KAITEN_ENABLE_METRICS | Нет | Метрики размера payload без секретов |
\* Нужен либо KAITEN_WORKSPACE_SLUG, либо KAITEN_BASE_URL.
truncated, next_offset, has_moreПроверка бюджетов размера ответа:
uv run kaiten-mcp-benchmark
uv run kaiten-mcp-benchmark --check
Логи всегда идут в stderr (совместимо со stdio MCP).
export KAITEN_LOG_LEVEL=INFO
export KAITEN_LOG_FORMAT=json uv run kaiten-mcp --transport stdio --log-format json
Полезные события: server_starting, tool_start / tool_success / tool_error, kaiten_request, kaiten_rate_limited.
Секреты редактируются; токены видны только как fingerprint вида token_fp=len=40:…ab12.
uv sync --all-groups
uv run ruff format . uv run ruff check . uv run ty check uv run pytest uv run kaiten-mcp-benchmark --check
Проверки совместимости (все 15 инструментов, оба транспорта, документация API):
uv run kaiten-mcp-check offline
uv run kaiten-mcp-check docs
uv run kaiten-mcp-check live
Настройка стенда, ежедневного CI и обновление эталонов — CHECKING.md. Live-проверки требуют полного набора настроек и изменяют только свои тестовые карточки.
Публикация релизов (PyPI, GHCR, Official MCP Registry) описана в RELEASING.md.
src/kaiten_mcp/
api/ # HTTP-клиент и адаптеры эндпоинтов tools/ # MCP-инструменты auth.py # Токен на запрос config.py # Настройки presentation.py metrics.py server.py main.py tests/ benchmarks/ examples/remote-mcp/ server.json # Official MCP Registry metadata RELEASING.md
KAITEN_API_TOKENКак подключить Kaiten к Cursor? Установите зависимости через uv, задайте KAITEN_API_TOKEN и KAITEN_WORKSPACE_SLUG, перезапустите Cursor — конфиг уже в .cursor/mcp.json.
Где взять API-токен Kaiten? В вашем инстансе: Профиль → API-ключ (https://<компания>.kaiten.ru/profile/api-key). OAuth у публичного API Kaiten для этого сценария не используется.
Чем этот сервер отличается от других kaiten-mcp? Фокус на компактных ответах и экономии контекста модели, плюс готовый remote Streamable HTTP для команды без хранения токенов на сервере.
Можно ли развернуть для всей команды? Да: Docker / Kubernetes с streamable-http; каждый сотрудник передаёт свой Bearer-токен в заголовке.
Работает ли с on-prem Kaiten? Да — задайте KAITEN_BASE_URL на ваш /api/v1.
MIT