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 將提交或 PR 連結至議題，並檢查待處理的執行。
  • 設定工作區與網域 — 使用 add_domain、verify_domain 或 update_workspace 新增或驗證自訂網域，並管理工作區設定。

託管 MCP 伺服器

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

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

MCP 伺服器

透過 Model Context Protocol 將 AI 代理連線至 Velocity。

什麼是 MCP？

Model Context Protocol（MCP）是一種開放標準，讓 AI 代理能透過統一介面與外部工具互動。Velocity 內建 MCP 伺服器，提供 84 個工具，涵蓋問題追蹤、PRD 與使用者故事、專案脈絡、工作區事件、工作區與使用者管理、路線圖規劃、自訂網域、Claude 代理協調等功能。

Claude Code、Claude Desktop、Codex、Cursor 及其他相容 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 請求）

後續步驟