Streamable HTTP · spec 2025-11-25

MCP-сервер для AI-агентов по родной спецификации

KvaTask реализует Streamable HTTP MCP по последней спецификации. AI-агент получает список задач не через API-обёртку, а нативно — через tools/list, resources/list, prompts/list. Работает в любом MCP-клиенте.

~/projects/PM — ai-client → kvatask MCP connected
Готовые prompts

Сценарии, которые AI знает с первого подключения

Не нужно объяснять агенту, как разобрать бэклог или провести стенд-ап — он получает готовые промпты через prompts/list и сразу понимает, какие данные забирать и в каком формате отвечать.

triage_inbox

Разобрать входящий бэклог

Делит свежие задачи на критичные баги, фичи и техдолг. Помечает дубликаты через create_task_link, у багов без шагов воспроизведения просит автора уточнить — комментарием.

daily_standup

Стенд-ап по активному спринту

Достаёт текущий спринт, группирует задачи по ассайни, отмечает заблокированные и просроченные. Выдаёт компактную сводку «вчера / сегодня / блокеры» по каждому участнику.

sprint_health

Здоровье спринта

Считает burndown, ловит риски — задачи без оценки, долго висящие в работе, длинные цепочки блокеров. Отвечает в формате отчёта «зелёный/жёлтый/красный».

task_breakdown

Декомпозиция эпика

Берёт epic, предлагает 3-7 подзадач (`subtask`), уточняет приоритеты по срокам и зависимости. Создаёт через create_task и связывает create_task_link.

release_notes

Release notes из закрытых задач

Собирает done-задачи за период, фильтрует баги/фичи, форматирует для CHANGELOG.md или Telegram-канала. На входе — даты, на выходе — готовый markdown.

bug_repro_template

Шаблон bug-репорта

Просит у автора задачи шаги воспроизведения, ожидаемое и фактическое поведение, окружение. Создаёт чек-лист в комментарии — пользователь только заполняет пробелы.

Прозрачность AI

Видно, кто что делал — человек или AI

Как только подключаете AI-клиент к KvaTask, каждое его действие помечается. Нельзя «незаметно» переписать описание задачи, обновить статус или закрыть бэклог — UI покажет, что это сделал AI, и когда.

  • Бейдж 🤖 ИИ на карточках, в которых AI оставил комментарий или поменял поля. Комментарии от AI хранятся с comment_type='ai' и видны отдельно.
  • ai_last_touch_at — timestamp последнего AI-действия. Используется для подписи «🤖 touched 4 мин назад» в карточке Kanban.
  • claim_task с TTL 30 мин — AI явно отмечает «работаю над этим». Пока claim жив, на карточке висит «🤖 AI working». Снимается через release_task или update_task {status:"done"}.
  • Аудит-лог — все MCP-операции пишутся отдельно от обычной активности. Можно отфильтровать «что AI сделал за последние сутки».
PM-254
Login rate-limit по (ip+email) — фикс cross-tenant DoS
Review 🤖 ИИ · 4 мин назад 🤖
PM-262
Кэш-аудит /api/billing/usage
Perf 🤖 AI working · 12 мин 🤖
PM-265
Уведомления на почту при упоминании через @
Feature ДК Дмитрий К.
Безопасность

API-ключи с привязкой к проекту

При создании API-ключа можно привязать его к одному проекту. Тогда AI видит только этот проект — даже list_projects и search_tasks автоматически фильтруются.

Глобальный ключ — большой урон при утечке

Ключ имеет доступ ко всем проектам организации. Если он утёк — под угрозой весь бэклог: разработка, продукт, маркетинг, биллинг.

Ключ с привязкой к проекту — узкий контекст

Ключ привязан к одному проекту. create_task на любом другом проекте отклоняется. get_me возвращает только этот проект, ресурс kvatask://project доступен. При утечке под угрозой только один проект.

Подключить за две минуты

Конфиг универсальный — большинство MCP-клиентов используют именно такой формат. Если ваш клиент настраивается через интерфейс, просто перенесите поля из JSON.

  1. Создайте API-ключВ KvaTask откройте «Настройки → API-ключи → Создать ключ». Скопируйте kvt_… — он показывается только один раз. Можно привязать ключ к конкретному проекту.
  2. Вставьте JSON в конфиг своего AI-клиентаТот же блок подходит и для настольного приложения, и для редактора кода с MCP. Подставьте свой ключ в Authorization:
    {
      "mcpServers": {
        "kvatask": {
          "type": "http",
          "url": "https://app.kvatask.ru/mcp",
          "headers": {
            "Authorization": "Bearer kvt_your_api_key"
          }
        }
      }
    }
  3. Перезапустите AI-клиентЧерез несколько секунд в списке MCP-серверов появится «kvatask». Спросите «какие задачи у меня в работе?» — агент вызовет search_tasks и вернёт ваш бэклог.

Если клиент поддерживает только стандарт SSE (старая версия MCP) — используйте URL https://app.kvatask.ru/mcp/sse, остальные поля те же.

AI работает с вашим бэклогом за 2 минуты

Зарегистрируйтесь, создайте API-ключ и вставьте конфиг в свой AI-клиент. Бесплатно для команд до 5 человек, без привязки карты.