Velocity
resmiManajemen proyek yang berpusat pada AI. Manajemen proyek untuk tahun 2026 dan seterusnya.
Apa yang bisa Anda lakukan dengan Velocity MCP?
- Membuat dan memperbarui isu — Minta asisten Anda untuk melaporkan bug atau mengedit kolom isu yang ada melalui
create_issueatauupdate_issue. - Mencari dan mengambil konteks isu — Gunakan
search_issues,get_issue, atauget_issue_contextuntuk menemukan tugas terkait, komentar, dan peristiwa tertaut. - Mengelola visibilitas proyek dan siklus — Ambil detail proyek, siklus sprint, dan progres sprint aktif dengan
list_projects,get_cycle, atauget_active_sprint. - Merencanakan dan memberikan suara pada item roadmap — Buat, perbarui, atau beri suara pada item dan versi roadmap menggunakan
create_roadmap_item,vote_roadmap_item, ataulist_roadmap_versions. - Melacak progres alur kerja agen — Tautkan commit atau PR ke isu dan periksa proses yang tertunda melalui
link_commit,link_pr, atauget_pending_agent_runs. - Mengonfigurasi ruang kerja dan domain — Tambahkan atau verifikasi domain kustom dan kelola pengaturan ruang kerja dengan
add_domain,verify_domain, atauupdate_workspace.
Server MCP Terhosting
npx add-mcp 'https://velocity.quest/api/mcp'Terpasang ke Claude Code, Codex, Cursor, dan lainnya
Dokumentasi
Server MCP
Hubungkan agen AI ke Velocity melalui Model Context Protocol.
Apa itu MCP?
Model Context Protocol (MCP) adalah standar terbuka yang memungkinkan agen AI berinteraksi dengan alat eksternal melalui antarmuka terpadu. Velocity menyertakan server MCP bawaan dengan 84 alat untuk pelacakan masalah, PRD dan cerita pengguna, konteks proyek, acara ruang kerja, manajemen ruang kerja dan pengguna, perencanaan peta jalan, domain kustom, koordinasi agen Claude, dan lainnya.
Agen AI seperti Claude Code, Claude Desktop, Codex, Cursor, dan klien lain yang kompatibel dengan MCP dapat terhubung ke Velocity dan membuat masalah, mencari tugas, memperbarui status, mengelola proyek, merencanakan peta jalan, dan mengonfigurasi domain — semuanya tanpa meninggalkan alur kerja mereka.
Ketersediaan dan akses
MCP tersedia untuk anggota aktif ruang kerja pada paket Pro, Business, atau Enterprise. Ruang kerja gratis tidak dapat menggunakan MCP. Hubungkan melalui OAuth browser atau token koneksi ruang kerja dari Settings → MCP. Kunci API pribadi tidak dapat mengautentikasi MCP. Lihat pengaturan dan pemecahan masalah.
Respons tools/list dari server yang terhubung adalah katalog alat dan skema input saat ini. Alat yang terdaftar masih dapat memerlukan izin tulis, peran pemilik/admin, hak fitur, konfigurasi integrasi, atau sewa pekerja terkelola. Akses alat saja tidak memulai pekerja atau menjamin pengodean otonom, peninjauan, penggabungan, atau penerapan.
Kasus Penggunaan
- Asisten pengodean AI — buat laporan bug langsung dari peninjauan kode
- Triage otomatis — agen mengategorikan dan memprioritaskan masalah yang masuk
- Pembaruan status — agen memperbarui progres masalah saat mereka menyelesaikan pekerjaan
- Pencarian & konteks — agen menemukan masalah terkait untuk menginformasikan pekerjaan mereka
- Manajemen proyek — agen membaca proyek, siklus, dan tonggak pencapaian
- Perencanaan peta jalan — agen mengelola item peta jalan, versi, dan pemungutan suara
- Manajemen domain — agen menambahkan dan memverifikasi domain kustom
- Koordinasi agen AI — pekerja yang dikonfigurasi memproses masalah, menautkan komit, dan melacak progres sprint
Alat yang Tersedia
Tabel-tabel ini adalah alat terpilih. Referensi alat juga mencakup perencanaan PRD dan cerita, lampiran pribadi, acara ruang kerja, pemantauan masalah/cek, dan profil pengiriman. MCP saat ini membaca konteks proyek/siklus; gunakan GraphQL API untuk membuat proyek, siklus, atau tonggak proyek.
PRD dan cerita pengguna
Baca dan edit PRD, persyaratan, dan cerita; pisahkan cerita, tautkan masalah, dan buat masalah dari proposal cerita yang ditinjau. Alat proposal AI memerlukan mcp:write, hak pakai rencana AI yang sesuai, dan kredit yang tersedia. Proposal memerlukan tindakan peninjauan dan penyimpanan terpisah; persetujuan PRD manusia tetap berada di Velocity. Lihat Dari ide ke masalah.
Pelacakan Masalah
| Alat | Cakupan | Deskripsi |
|---|---|---|
list_issues | baca | Daftar masalah dengan filter untuk proyek, status, prioritas, penanggung jawab, label |
get_issue | baca | Dapatkan detail lengkap masalah berdasarkan ID atau pengenal (mis., ENG-123) |
create_issue | tulis | Buat masalah baru dengan judul, deskripsi, prioritas, status |
update_issue | tulis | Perbarui kolom masalah yang ada |
search_issues | baca | Pencarian teks lengkap di seluruh judul dan deskripsi masalah |
add_comment | tulis | Tambahkan komentar ke masalah |
list_comments | baca | Daftar semua komentar pada masalah |
Proyek & Siklus
| Alat | Cakupan | Deskripsi |
|---|---|---|
list_projects | baca | Daftar semua proyek dengan filter status opsional |
get_project | baca | Dapatkan detail proyek termasuk tonggak pencapaian dan jumlah masalah |
list_cycles | baca | Daftar siklus sprint dengan filter status opsional |
get_cycle | baca | Dapatkan detail siklus dengan jumlah masalah dan progres |
Metadata Ruang Kerja
| Alat | Cakupan | Deskripsi |
|---|---|---|
list_teams | baca | Daftar semua tim di ruang kerja |
list_labels | baca | Daftar semua label yang tersedia |
list_statuses | baca | Daftar semua status masalah di seluruh tim |
list_members | baca | Daftar anggota ruang kerja dengan peran |
Peta Jalan
| Alat | Cakupan | Deskripsi |
|---|---|---|
list_roadmap_items | baca | Daftar item peta jalan dengan filter status, kategori, dan versi |
create_roadmap_item | tulis | Buat item peta jalan baru |
update_roadmap_item | tulis | Perbarui item peta jalan yang ada |
delete_roadmap_item | tulis | Hapus item peta jalan |
vote_roadmap_item | tulis | Alihkan suara pada item peta jalan |
list_roadmap_versions | baca | Daftar semua versi peta jalan (rilis) |
create_roadmap_version | tulis | Buat versi peta jalan baru |
get_roadmap_settings | baca | Dapatkan visibilitas peta jalan dan pengaturan pemungutan suara |
update_roadmap_settings | tulis | Perbarui pengaturan peta jalan |
Ruang Kerja & Pengguna
| Alat | Cakupan | Deskripsi |
|---|---|---|
list_workspaces | baca | Daftar ruang kerja pengguna; OAuth hanya mengembalikan ruang kerja yang terhubung |
create_workspace | tulis | Buat ruang kerja baru (pengguna menjadi pemilik) |
delete_workspace | tulis | Hapus ruang kerja secara permanen (khusus pemilik) |
get_workspace | baca | Dapatkan detail ruang kerja saat ini (nama, paket, jumlah anggota) |
update_workspace | tulis | Perbarui nama ruang kerja (deskripsi tidak didukung) |
get_current_user | baca | Dapatkan profil pengguna yang terautentikasi |
update_current_user | tulis | Perbarui nama tampilan atau avatar pengguna |
list_user_api_keys | baca | Daftar kunci API pribadi (awalan velu_) |
create_user_api_key | tulis | Buat kunci API pribadi (mengembalikan kunci sekali) |
revoke_user_api_key | tulis | Cabut kunci API pribadi |
Domain Kustom
| Alat | Cakupan | Deskripsi |
|---|---|---|
list_domains | baca | Daftar domain kustom dengan status verifikasi |
add_domain | tulis | Tambahkan domain kustom dengan instruksi pengaturan DNS |
verify_domain | tulis | Periksa status verifikasi domain |
remove_domain | tulis | Hapus domain kustom |
Alur kerja agen
| Alat | Cakupan | Deskripsi |
|---|---|---|
transition_issue | tulis | Pindahkan masalah ke status berdasarkan nama (mis., "In Progress") alih-alih UUID |
get_my_issues | baca | Dapatkan masalah yang ditugaskan ke pengguna yang terautentikasi, difilter berdasarkan grup status |
get_active_sprint | baca | Dapatkan siklus aktif dengan jumlah masalah dan progres |
link_commit | tulis | Catat SHA komit terhadap masalah |
link_pr | tulis | Catat URL permintaan tarik terhadap masalah |
get_issue_context | baca | Konteks masalah yang kaya: komentar, aktivitas, label, peristiwa tertaut |
get_pending_agent_runs | baca | Dapatkan run API atau Claude Code yang tertunda untuk pekerja lokal |
update_agent_run | tulis | Perbarui status, token, dan hasil run agen |
Sumber Daya
Server MCP juga mengekspos sumber daya hanya-baca ini untuk konteks cepat:
| URI | Deskripsi |
|---|---|
velocity://workspace | Metadata ruang kerja (nama, slug, paket, jumlah anggota/tim) |
velocity://issues | Masalah terbaru (20 terakhir, diurutkan berdasarkan waktu pembaruan) |
velocity://projects | Semua proyek dengan status dan progres |
velocity://roadmap | Item peta jalan, versi, dan ringkasan pengaturan |
velocity://domains | Domain kustom dengan status verifikasi |
Keterbatasan kredensial
Koneksi OAuth tidak dapat mendaftar, membuat, atau mencabut kunci API pribadi, bahkan ketika alat tersebut muncul di katalog. Kelola kunci di pengaturan Velocity atau gunakan token koneksi untuk alat-alat ini. Token koneksi memiliki kemampuan akun yang lebih luas; jaga kerahasiaannya dan cabut koneksi yang tidak digunakan.
Cakupan
Hibah OAuth MCP menggunakan cakupan ini. Token koneksi dari Settings → MCP mencakup keduanya:
mcp:read— Baca alat dan sumber daya, tunduk pada batasan kredensial dan fiturmcp:write— Tulis alat, tunduk pada pemeriksaan kebijakan peran, fitur, dan pekerja (minta denganmcp:read)
Langkah Berikutnya
- Pengaturan & Autentikasi — masuk atau buat token koneksi dan konfigurasikan klien Anda
- Referensi Alat — dokumentasi parameter terperinci untuk setiap alat