Подключение ИИ-агента

Раздел для администратора организации. Участникам без admin раздел API-ключи недоступен.

KvaTask умеет работать с ИИ-помощниками (Claude, Cursor, Windsurf и другими). Агент подключается к вашим задачам и Wiki — и может создавать, обновлять, искать задачи, писать комментарии, читать и править Wiki. Без копипаста.

Что агент умеет

• Заводит, обновляет и ищет задачи. Ставит приоритеты, назначает исполнителей.
• Делает сводку по спринту: что сделано, что в работе, что залипло.
• Разбивает крупную задачу на подзадачи со связями.
• Читает и пишет Wiki.

Что агент не может

• Удалять проекты и пользователей.
• Менять тариф и подписку.
• Видеть другие организации.
• Отправлять письма от вашего имени.

Шаг 1. Выпустить ключ

⚙ → API-ключи → Создать новый ключ. Заполните:

• Название — например, «Claude на ноутбуке». Чтобы потом не путаться.
• Пользователь — от чьего имени агент будет работать. Действия агента запишутся за этим участником.
• Срок действия (дней) — число или пусто (бессрочный).
• Проект — либо один конкретный, либо доступ ко всем проектам организации.

Нажмите Создать — появится окно с ключом. Ключ начинается с kvt_ и показывается только один раз. Скопируйте и сохраните — переоткрыть нельзя, нужно будет выпустить заново.

На один проект или на все

• На один проект — агент видит и трогает только его. Безопаснее, рекомендуется.
• На все — агент видит все ваши проекты и Wiki. Нужно для кросс-проектной аналитики.

По умолчанию выпускайте ключ на один проект. Под каждого клиента/задачу — отдельный ключ.

Шаг 2. Подключить клиент

Адрес сервера: https://app.kvatask.ru/mcp.

Claude Desktop

Откройте файл настроек:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Добавьте:

{
  "mcpServers": {
    "kvatask": {
      "type": "http",
      "url": "https://app.kvatask.ru/mcp",
      "headers": {
        "Authorization": "Bearer kvt_ваш_ключ"
      }
    }
  }
}

Перезапустите Claude Desktop.

Claude Code (командная строка)

В корне рабочего проекта создайте файл .mcp.json с тем же содержимым. Внутри claude команда /mcp покажет статус.

Cursor

Settings → Features → MCP → Add New MCP Server:

• Name: KvaTask
• Type: HTTP
• URL: https://app.kvatask.ru/mcp
• Headers: Authorization: Bearer kvt_ваш_ключ

Windsurf

Settings → AI → MCP Servers → Add Server:

• Endpoint: https://app.kvatask.ru/mcp
• Auth Header: Authorization: Bearer kvt_ваш_ключ

Без ручного ключа (OAuth)

Свежие Claude Desktop, Claude Code и Cursor поддерживают OAuth. Укажите адрес https://app.kvatask.ru/mcp без заголовка Authorization — клиент сам откроет браузер, вы войдёте и выберете проект.

Шаг 3. Проверить

В чате ИИ-клиента: «покажи мои задачи в работе». Агент ответит списком с ID вида PM-42.

Примеры просьб

• Заведи задачу: «Поправить мобильную вёрстку», тип баг, приоритет средний, срок — пятница.
• Закрой PM-89 и напиши комментарий: «Ушло в релиз 2.4, проверял на staging».
• Сделай сводку по текущему спринту.
• Найди в Wiki всё про биллинг и собери выжимку в 5 строк.

Команда увидит работу агента

Никаких тихих действий:

• 🤖 на карточке задачи — агент работает с ней прямо сейчас.
• Метка «AI касался N минут назад» — агент когда-то трогал задачу.
• AI-метка на комментариях, написанных агентом.

Безопасность

• Один ключ — одно применение. Отдельный под Claude, отдельный под Cursor.
• По умолчанию — ключ на один проект.
• Не храните ключ в открытых репозиториях, используйте переменные окружения.
• Ненужный ключ сразу удаляйте в списке ⚙ → API-ключи.

Не работает