Velocity
公式AI中心のプロジェクト管理。2026年以降のプロジェクト管理。
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には、課題追跡、PRDとユーザーストーリー、プロジェクトコンテキスト、ワークスペースイベント、ワークスペースとユーザー管理、ロードマップ計画、カスタムドメイン、Claudeエージェント連携など、84のツールを備えた組み込みのMCPサーバーが含まれています。
Claude Code、Claude Desktop、Codex、Cursor、その他のMCP互換クライアントなどのAIエージェントは、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 | ワークスペースメタデータ（名前、スラッグ、プラン、メンバー/チーム数） |
velocity://issues | 最近の課題（最新20件、更新時間順） |
velocity://projects | ステータスと進捗を含むすべてのプロジェクト |
velocity://roadmap | ロードマップ項目、バージョン、設定の概要 |
velocity://domains | 検証ステータス付きのカスタムドメイン |
認証情報の制限
OAuth接続では、それらのツールがカタログに表示されている場合でも、個人用APIキーの一覧表示、作成、失効はできません。キーはVelocity設定で管理するか、これらのツールには接続トークンを使用してください。接続トークンはより広範なアカウント機能を持ちます。秘密に保ち、未使用の接続は失効させてください。
スコープ
MCP OAuth付与は以下のスコープを使用します。設定 → MCPからの接続トークンには両方が含まれます：
mcp:read— 認証情報と機能の制限に従って、ツールとリソースを読み取りmcp:write— ロール、機能、ワーカーポリシーのチェックに従って、ツールを書き込み（mcp:readでリクエスト）