Velocity

npx add-mcp 'https://velocity.quest/api/mcp'

MCP-сервер

Подключите AI-агентов к Velocity через Model Context Protocol.

Что такое MCP?

Model Context Protocol (MCP) — это открытый стандарт, который позволяет AI-агентам взаимодействовать с внешними инструментами через единый интерфейс. Velocity включает встроенный MCP-сервер с 84 инструментами для отслеживания задач, PRD и пользовательских историй, контекста проекта, событий рабочего пространства, управления рабочим пространством и пользователями, планирования дорожной карты, пользовательских доменов, координации агентов Claude и многого другого.

AI-агенты, такие как Claude Code, Claude Desktop, Codex, Cursor и другие MCP-совместимые клиенты, могут подключаться к Velocity и создавать задачи, искать задачи, обновлять статусы, управлять проектами, планировать дорожную карту и настраивать домены — не покидая свой рабочий процесс.

Доступность и доступ

MCP доступен текущим участникам рабочих пространств на тарифах Pro, Business или Enterprise. Бесплатные рабочие пространства не могут использовать MCP. Подключение выполняется через браузерный OAuth или токен подключения рабочего пространства из раздела Settings → MCP. Личные API-ключи не могут аутентифицировать MCP. См. настройка и устранение неполадок.

Ответ tools/list подключённого сервера — это актуальный каталог инструментов и входных схем. Инструмент из списка всё равно может требовать область записи, роль владельца/администратора, право на функцию, конфигурацию интеграции или аренду управляемого воркера. Доступ к инструменту сам по себе не запускает воркер и не гарантирует автономное кодирование, ревью, слияние или развёртывание.

Сценарии использования

• AI-ассистенты для кодирования — создание отчётов об ошибках прямо из код-ревью
• Автоматическая сортировка — агенты категоризируют и приоритизируют входящие задачи
• Обновление статусов — агенты обновляют прогресс задач по мере выполнения работы
• Поиск и контекст — агенты находят связанные задачи для информирования своей работы
• Управление проектами — агенты читают проекты, циклы и вехи
• Планирование дорожной карты — агенты управляют элементами дорожной карты, версиями и голосованием
• Управление доменами — агенты добавляют и проверяют пользовательские домены
• Координация AI-агентов — настроенные воркеры обрабатывают задачи, связывают коммиты и отслеживают прогресс спринта

Доступные инструменты

Эти таблицы содержат избранные инструменты. Справочник инструментов также охватывает планирование PRD и историй, приватные вложения, события рабочего пространства, мониторинг задач/проверок и профили доставки. В настоящее время MCP читает контекст проектов/циклов; используйте GraphQL API для создания проектов, циклов или вех проекта.

PRD и пользовательские истории

Читайте и редактируйте PRD, требования и истории; разделяйте истории, связывайте задачи и создавайте задачи из проверенных предложений историй. Инструменты AI-предложений требуют mcp:write, соответствующего права на AI-тариф и доступных кредитов. Предложения требуют отдельных действий проверки и сохранения; утверждение PRD человеком остаётся в Velocity. См. От идеи к задачам.

Отслеживание задач

Инструмент	Область	Описание
list_issues	чтение	Список задач с фильтрами по проекту, статусу, приоритету, исполнителю, метке
get_issue	чтение	Получить полные сведения о задаче по ID или идентификатору (например, ENG-123)
create_issue	запись	Создать новую задачу с заголовком, описанием, приоритетом, статусом
update_issue	запись	Обновить поля существующей задачи
search_issues	чтение	Полнотекстовый поиск по заголовкам и описаниям задач
add_comment	запись	Добавить комментарий к задаче
list_comments	чтение	Список всех комментариев к задаче

Проекты и циклы

Инструмент	Область	Описание
list_projects	чтение	Список всех проектов с необязательным фильтром по статусу
get_project	чтение	Получить сведения о проекте, включая вехи и количество задач
list_cycles	чтение	Список спринтерских циклов с необязательным фильтром по статусу
get_cycle	чтение	Получить сведения о цикле с количеством задач и прогрессом

Метаданные рабочего пространства

Инструмент	Область	Описание
list_teams	чтение	Список всех команд в рабочем пространстве
list_labels	чтение	Список всех доступных меток
list_statuses	чтение	Список всех статусов задач по командам
list_members	чтение	Список участников рабочего пространства с ролями

Дорожная карта

Инструмент	Область	Описание
list_roadmap_items	чтение	Список элементов дорожной карты с фильтрами по статусу, категории и версии
create_roadmap_item	запись	Создать новый элемент дорожной карты
update_roadmap_item	запись	Обновить существующий элемент дорожной карты
delete_roadmap_item	запись	Удалить элемент дорожной карты
vote_roadmap_item	запись	Переключить голос за элемент дорожной карты
list_roadmap_versions	чтение	Список всех версий дорожной карты (релизов)
create_roadmap_version	запись	Создать новую версию дорожной карты
get_roadmap_settings	чтение	Получить настройки видимости и голосования дорожной карты
update_roadmap_settings	запись	Обновить настройки дорожной карты

Рабочее пространство и пользователь

Инструмент	Область	Описание
list_workspaces	чтение	Список рабочих пространств пользователя; OAuth возвращает только подключённое рабочее пространство
create_workspace	запись	Создать новое рабочее пространство (пользователь становится владельцем)
delete_workspace	запись	Безвозвратно удалить рабочее пространство (только владелец)
get_workspace	чтение	Получить сведения о текущем рабочем пространстве (название, тариф, количество участников)
update_workspace	запись	Обновить название рабочего пространства (описание не поддерживается)
get_current_user	чтение	Получить профиль аутентифицированного пользователя
update_current_user	запись	Обновить отображаемое имя или аватар пользователя
list_user_api_keys	чтение	Список личных API-ключей (префикс velu_)
create_user_api_key	запись	Создать личный API-ключ (ключ возвращается один раз)
revoke_user_api_key	запись	Отозвать личный API-ключ

Пользовательские домены

Инструмент	Область	Описание
list_domains	чтение	Список пользовательских доменов со статусом проверки
add_domain	запись	Добавить пользовательский домен с инструкциями по настройке DNS
verify_domain	запись	Проверить статус верификации домена
remove_domain	запись	Удалить пользовательский домен

Рабочий процесс агента

Инструмент	Область	Описание
transition_issue	запись	Переместить задачу в статус по имени (например, "In Progress") вместо UUID
get_my_issues	чтение	Получить задачи, назначенные аутентифицированному пользователю, с фильтром по группе статусов
get_active_sprint	чтение	Получить активный цикл с количеством задач и прогрессом
link_commit	запись	Записать SHA коммита для задачи
link_pr	запись	Записать URL пул-реквеста для задачи
get_issue_context	чтение	Расширенный контекст задачи: комментарии, активности, метки, связанные события
get_pending_agent_runs	чтение	Получить ожидающие запуски API или Claude Code для локального воркера
update_agent_run	запись	Обновить статус, токены и результат запуска агента

Ресурсы

MCP-сервер также предоставляет эти ресурсы только для чтения для быстрого получения контекста:

URI	Описание
velocity://workspace	Метаданные рабочего пространства (название, slug, тариф, количество участников/команд)
velocity://issues	Недавние задачи (последние 20, отсортированные по времени обновления)
velocity://projects	Все проекты со статусом и прогрессом
velocity://roadmap	Обзор элементов дорожной карты, версий и настроек
velocity://domains	Пользовательские домены со статусом проверки

Ограничения учётных данных

OAuth-подключения не могут перечислять, создавать или отзывать личные API-ключи, даже если эти инструменты отображаются в каталоге. Управляйте ключами в настройках Velocity или используйте токен подключения для этих инструментов. Токены подключения имеют более широкие возможности учётной записи; храните их в тайне и отзывайте неиспользуемые подключения.

Области доступа

OAuth-разрешения MCP используют эти области. Токены подключения из Settings → MCP включают обе:

• mcp:read — Инструменты и ресурсы чтения с учётом ограничений учётных данных и функций
• mcp:write — Инструменты записи с учётом проверок ролей, функций и политик воркеров (запрашивается с mcp:read)

Следующие шаги

• Настройка и аутентификация — войдите или создайте токен подключения и настройте свой клиент
• Справочник инструментов — подробная документация параметров для каждого инструмента