Velocity

官方

以AI为核心的项目管理。面向2026年及未来的项目管理。

访问 velocity.quest

你可以用 Velocity MCP 做什么？

  • 创建和更新问题 — 让您的助手通过 create_issue 或 update_issue 提交错误或编辑现有问题的字段。
  • 搜索和检索问题上下文 — 使用 search_issues、get_issue 或 get_issue_context 查找相关任务、评论和关联事件。
  • 管理项目和周期可见性 — 使用 list_projects、get_cycle 或 get_active_sprint 拉取项目详情、冲刺周期和当前冲刺进度。
  • 规划并对路线图项目投票 — 使用 create_roadmap_item、vote_roadmap_item 或 list_roadmap_versions 创建、更新或对路线图项目和版本进行投票。
  • 跟踪代理工作流进度 — 使用 link_commit、link_pr 或 get_pending_agent_runs 将提交或拉取请求关联到问题，并检查待处理运行。
  • 配置工作区和域名 — 使用 add_domain、verify_domain 或 update_workspace 添加或验证自定义域名并管理工作区设置。

托管 MCP 服务器

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

可安装到 Claude Code、Codex、Cursor 等客户端

文档

MCP 服务器

通过模型上下文协议将 AI 代理连接到 Velocity。

什么是 MCP？

模型上下文协议（MCP）是一种开放标准，允许 AI 代理通过统一接口与外部工具交互。Velocity 内置了一个 MCP 服务器，提供 84 个工具，涵盖问题跟踪、PRD 和用户故事、项目上下文、工作区事件、工作区和用户管理、路线图规划、自定义域名、Claude 代理协调等功能。

Claude Code、Claude Desktop、Codex、Cursor 等 AI 代理以及其他兼容 MCP 的客户端可以连接到 Velocity，创建问题、搜索任务、更新状态、管理项目、规划路线图和配置域名——所有这些都无需离开其工作流程。

可用性和访问

MCP 适用于 Pro、Business 或 Enterprise 工作区的当前成员。免费工作区无法使用 MCP。通过浏览器 OAuth 或从 设置 → 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写入按名称（例如“进行中”）而非 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 设置中管理密钥，或使用连接令牌来使用这些工具。连接令牌具有更广泛的账户能力；请保持其私密性，并撤销未使用的连接。

范围

MCP OAuth 授权使用以下范围。来自设置 → MCP 的连接令牌包含两者：

  • mcp:read — 读取工具和资源，受凭据和功能限制约束
  • mcp:write — 写入工具，受角色、功能和工作者策略检查约束（使用 mcp:read 请求）

后续步骤