Velocity

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

Máy chủ MCP

Kết nối các tác nhân AI với Velocity thông qua Giao thức Ngữ cảnh Mô hình (Model Context Protocol).

MCP là gì?

Giao thức Ngữ cảnh Mô hình (MCP) là một tiêu chuẩn mở cho phép các tác nhân AI tương tác với các công cụ bên ngoài thông qua một giao diện thống nhất. Velocity bao gồm một máy chủ MCP tích hợp với 84 công cụ để theo dõi vấn đề, PRD và câu chuyện người dùng, ngữ cảnh dự án, sự kiện không gian làm việc, quản lý không gian làm việc và người dùng, lập kế hoạch lộ trình, tên miền tùy chỉnh, điều phối tác nhân Claude, v.v.

Các tác nhân AI như Claude Code, Claude Desktop, Codex, Cursor và các máy khách tương thích MCP khác có thể kết nối với Velocity và tạo vấn đề, tìm kiếm tác vụ, cập nhật trạng thái, quản lý dự án, lập kế hoạch lộ trình và cấu hình tên miền — tất cả mà không cần rời khỏi quy trình làm việc của họ.

Tính khả dụng và truy cập

MCP khả dụng cho các thành viên hiện tại của không gian làm việc trên gói Pro, Business hoặc Enterprise. Không gian làm việc miễn phí không thể sử dụng MCP. Kết nối thông qua OAuth trình duyệt hoặc mã thông báo kết nối không gian làm việc từ Cài đặt → MCP. Khóa API cá nhân không thể xác thực MCP. Xem thiết lập và khắc phục sự cố.

Phản hồi tools/list của máy chủ đã kết nối là danh mục công cụ và lược đồ đầu vào hiện tại. Một công cụ được liệt kê vẫn có thể yêu cầu phạm vi ghi, vai trò chủ sở hữu/quản trị viên, quyền tính năng, cấu hình tích hợp hoặc hợp đồng thuê công nhân được quản lý. Chỉ có quyền truy cập công cụ không khởi động công nhân hoặc đảm bảo mã hóa, đánh giá, hợp nhất hoặc triển khai tự động.

Trường hợp sử dụng

• Trợ lý mã hóa AI — tạo báo cáo lỗi trực tiếp từ đánh giá mã
• Phân loại tự động — tác nhân phân loại và ưu tiên các vấn đề đến
• Cập nhật trạng thái — tác nhân cập nhật tiến độ vấn đề khi họ hoàn thành công việc
• Tìm kiếm & ngữ cảnh — tác nhân tìm các vấn đề liên quan để hỗ trợ công việc của họ
• Quản lý dự án — tác nhân đọc các dự án, chu kỳ và cột mốc
• Lập kế hoạch lộ trình — tác nhân quản lý các mục lộ trình, phiên bản và bỏ phiếu
• Quản lý tên miền — tác nhân thêm và xác minh tên miền tùy chỉnh
• Điều phối tác nhân AI — công nhân được cấu hình xử lý vấn đề, liên kết cam kết và theo dõi tiến độ sprint

Công cụ khả dụng

Các bảng này là các công cụ được chọn. Tài liệu tham khảo công cụ cũng bao gồm lập kế hoạch PRD và câu chuyện, tệp đính kèm riêng tư, sự kiện không gian làm việc, giám sát vấn đề/kiểm tra và hồ sơ giao hàng. MCP hiện đọc ngữ cảnh dự án/chu kỳ; sử dụng API GraphQL để tạo dự án, chu kỳ hoặc cột mốc dự án.

PRD và câu chuyện người dùng

Đọc và chỉnh sửa PRD, yêu cầu và câu chuyện; chia câu chuyện, liên kết vấn đề và tạo vấn đề từ các đề xuất câu chuyện đã được đánh giá. Các công cụ đề xuất AI yêu cầu mcp:write, quyền kế hoạch AI tương ứng và tín dụng khả dụng. Đề xuất yêu cầu các hành động đánh giá và lưu riêng biệt; phê duyệt PRD của con người vẫn nằm trong Velocity. Xem Từ ý tưởng đến vấn đề.

Theo dõi vấn đề

Công cụ	Phạm vi	Mô tả
list_issues	đọc	Liệt kê vấn đề với bộ lọc theo dự án, trạng thái, mức ưu tiên, người được giao, nhãn
get_issue	đọc	Lấy chi tiết đầy đủ của một vấn đề theo ID hoặc định danh (ví dụ: ENG-123)
create_issue	ghi	Tạo một vấn đề mới với tiêu đề, mô tả, mức ưu tiên, trạng thái
update_issue	ghi	Cập nhật các trường của một vấn đề hiện có
search_issues	đọc	Tìm kiếm toàn văn trên tiêu đề và mô tả vấn đề
add_comment	ghi	Thêm bình luận vào một vấn đề
list_comments	đọc	Liệt kê tất cả bình luận trên một vấn đề

Dự án & Chu kỳ

Công cụ	Phạm vi	Mô tả
list_projects	đọc	Liệt kê tất cả dự án với bộ lọc trạng thái tùy chọn
get_project	đọc	Lấy chi tiết dự án bao gồm cột mốc và số lượng vấn đề
list_cycles	đọc	Liệt kê các chu kỳ sprint với bộ lọc trạng thái tùy chọn
get_cycle	đọc	Lấy chi tiết chu kỳ với số lượng vấn đề và tiến độ

Siêu dữ liệu không gian làm việc

Công cụ	Phạm vi	Mô tả
list_teams	đọc	Liệt kê tất cả nhóm trong không gian làm việc
list_labels	đọc	Liệt kê tất cả nhãn khả dụng
list_statuses	đọc	Liệt kê tất cả trạng thái vấn đề trên các nhóm
list_members	đọc	Liệt kê thành viên không gian làm việc với vai trò

Lộ trình

Công cụ	Phạm vi	Mô tả
list_roadmap_items	đọc	Liệt kê các mục lộ trình với bộ lọc trạng thái, danh mục và phiên bản
create_roadmap_item	ghi	Tạo một mục lộ trình mới
update_roadmap_item	ghi	Cập nhật một mục lộ trình hiện có
delete_roadmap_item	ghi	Xóa một mục lộ trình
vote_roadmap_item	ghi	Chuyển đổi bỏ phiếu trên một mục lộ trình
list_roadmap_versions	đọc	Liệt kê tất cả phiên bản lộ trình (bản phát hành)
create_roadmap_version	ghi	Tạo một phiên bản lộ trình mới
get_roadmap_settings	đọc	Lấy cài đặt hiển thị và bỏ phiếu lộ trình
update_roadmap_settings	ghi	Cập nhật cài đặt lộ trình

Không gian làm việc & Người dùng

Công cụ	Phạm vi	Mô tả
list_workspaces	đọc	Liệt kê không gian làm việc của người dùng; OAuth chỉ trả về không gian làm việc đã kết nối
create_workspace	ghi	Tạo một không gian làm việc mới (người dùng trở thành chủ sở hữu)
delete_workspace	ghi	Xóa vĩnh viễn một không gian làm việc (chỉ chủ sở hữu)
get_workspace	đọc	Lấy chi tiết không gian làm việc hiện tại (tên, gói, số lượng thành viên)
update_workspace	ghi	Cập nhật tên không gian làm việc (mô tả không được hỗ trợ)
get_current_user	đọc	Lấy hồ sơ của người dùng đã xác thực
update_current_user	ghi	Cập nhật tên hiển thị hoặc hình đại diện của người dùng
list_user_api_keys	đọc	Liệt kê khóa API cá nhân (tiền tố velu_)
create_user_api_key	ghi	Tạo khóa API cá nhân (trả về khóa một lần)
revoke_user_api_key	ghi	Thu hồi khóa API cá nhân

Tên miền tùy chỉnh

Công cụ	Phạm vi	Mô tả
list_domains	đọc	Liệt kê tên miền tùy chỉnh với trạng thái xác minh
add_domain	ghi	Thêm tên miền tùy chỉnh với hướng dẫn thiết lập DNS
verify_domain	ghi	Kiểm tra trạng thái xác minh tên miền
remove_domain	ghi	Xóa tên miền tùy chỉnh

Quy trình làm việc tác nhân

Công cụ	Phạm vi	Mô tả
transition_issue	ghi	Di chuyển vấn đề đến trạng thái theo tên (ví dụ: "Đang tiến hành") thay vì UUID
get_my_issues	đọc	Lấy các vấn đề được giao cho người dùng đã xác thực, lọc theo nhóm trạng thái
get_active_sprint	đọc	Lấy chu kỳ hoạt động với số lượng vấn đề và tiến độ
link_commit	ghi	Ghi lại SHA cam kết cho một vấn đề
link_pr	ghi	Ghi lại URL yêu cầu kéo cho một vấn đề
get_issue_context	đọc	Ngữ cảnh vấn đề phong phú: bình luận, hoạt động, nhãn, sự kiện liên kết
get_pending_agent_runs	đọc	Lấy các lần chạy API hoặc Claude Code đang chờ xử lý cho một công nhân cục bộ
update_agent_run	ghi	Cập nhật trạng thái, mã thông báo và kết quả của một lần chạy tác nhân

Tài nguyên

Máy chủ MCP cũng hiển thị các tài nguyên chỉ đọc này để có ngữ cảnh nhanh:

URI	Mô tả
velocity://workspace	Siêu dữ liệu không gian làm việc (tên, slug, gói, số lượng thành viên/nhóm)
velocity://issues	Các vấn đề gần đây (20 vấn đề cuối, sắp xếp theo thời gian cập nhật)
velocity://projects	Tất cả dự án với trạng thái và tiến độ
velocity://roadmap	Tổng quan về các mục lộ trình, phiên bản và cài đặt
velocity://domains	Tên miền tùy chỉnh với trạng thái xác minh

Hạn chế thông tin xác thực

Kết nối OAuth không thể liệt kê, tạo hoặc thu hồi khóa API cá nhân, ngay cả khi các công cụ đó xuất hiện trong danh mục. Quản lý khóa trong cài đặt Velocity hoặc sử dụng mã thông báo kết nối cho các công cụ này. Mã thông báo kết nối có khả năng tài khoản rộng hơn; giữ chúng riêng tư và thu hồi các kết nối không sử dụng.

Phạm vi

Các khoản cấp OAuth MCP sử dụng các phạm vi này. Mã thông báo kết nối từ Cài đặt → MCP bao gồm cả hai:

• mcp:read — Đọc công cụ và tài nguyên, tùy thuộc vào hạn chế thông tin xác thực và tính năng
• mcp:write — Ghi công cụ, tùy thuộc vào kiểm tra chính sách vai trò, tính năng và công nhân (yêu cầu với mcp:read)

Các bước tiếp theo

• Thiết lập & Xác thực — đăng nhập hoặc tạo mã thông báo kết nối và cấu hình máy khách của bạn
• Tài liệu tham khảo công cụ — tài liệu tham số chi tiết cho từng công cụ