Velocity

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

MCP Server

เชื่อมต่อ AI agents เข้ากับ Velocity ผ่าน Model Context Protocol

MCP คืออะไร?

Model Context Protocol (MCP) เป็นมาตรฐานเปิดที่ช่วยให้ AI agents สามารถโต้ตอบกับเครื่องมือภายนอกผ่านอินเทอร์เฟซแบบรวมศูนย์ Velocity มี MCP server ในตัวพร้อมเครื่องมือ 84 รายการสำหรับการติดตาม issue, PRD และ user stories, บริบทของโปรเจกต์, เหตุการณ์ใน workspace, การจัดการ workspace และผู้ใช้, การวางแผน roadmap, custom domains, การประสานงาน Claude agent และอื่นๆ อีกมากมาย

AI agents เช่น Claude Code, Claude Desktop, Codex, Cursor และไคลเอนต์อื่นๆ ที่รองรับ MCP สามารถเชื่อมต่อกับ Velocity และสร้าง issue, ค้นหางาน, อัปเดตสถานะ, จัดการโปรเจกต์, วางแผน roadmap และกำหนดค่าโดเมน — ทั้งหมดโดยไม่ต้องออกจากเวิร์กโฟลว์ของตน

ความพร้อมใช้งานและการเข้าถึง

MCP พร้อมใช้งานสำหรับสมาชิกปัจจุบันของ workspace ในแผน Pro, Business หรือ Enterprise เท่านั้น workspace ฟรีไม่สามารถใช้ MCP ได้ เชื่อมต่อผ่าน browser OAuth หรือ workspace connection token จาก Settings → MCP personal API keys ไม่สามารถใช้ยืนยันตัวตนกับ MCP ได้ ดู การตั้งค่าและการแก้ไขปัญหา

การตอบสนอง tools/list ของเซิร์ฟเวอร์ที่เชื่อมต่อคือแคตตาล็อกเครื่องมือและ input-schema ปัจจุบัน เครื่องมือที่แสดงอยู่อาจยังต้องมี write scope, บทบาท owner/admin, สิทธิ์ตามฟีเจอร์, การกำหนดค่าการผสานรวม หรือ managed worker lease การเข้าถึงเครื่องมือเพียงอย่างเดียวไม่ได้เริ่มต้น worker หรือรับประกันการเขียนโค้ดอัตโนมัติ การรีวิว การรวมโค้ด หรือการ deploy

กรณีการใช้งาน

• AI coding assistants — สร้างรายงานบั๊กโดยตรงจากการรีวิวโค้ด
• Automated triage — agents จัดหมวดหมู่และจัดลำดับความสำคัญของ issue ที่เข้ามา
• Status updates — agents อัปเดตความคืบหน้าของ issue เมื่อทำงานเสร็จ
• Search & context — agents ค้นหา issue ที่เกี่ยวข้องเพื่อใช้ประกอบการทำงาน
• Project management — agents อ่านโปรเจกต์, cycles และ milestones
• Roadmap planning — agents จัดการรายการ roadmap, เวอร์ชัน และการโหวต
• Domain management — agents เพิ่มและตรวจสอบ custom domains
• AI agent coordination — workers ที่กำหนดค่าประมวลผล issue, เชื่อมโยง commits และติดตามความคืบหน้าของ sprint

เครื่องมือที่พร้อมใช้งาน

ตารางเหล่านี้เป็นเครื่องมือที่คัดเลือกมา เอกสารอ้างอิงเครื่องมือ ยังครอบคลุมถึง การวางแผน PRD และ story, ไฟล์แนบส่วนตัว, เหตุการณ์ใน workspace, การติดตาม issue/check และ delivery profiles ปัจจุบัน MCP อ่านบริบทของโปรเจกต์/cycle; ใช้ GraphQL API เพื่อสร้างโปรเจกต์, cycles หรือ project milestones

PRDs และ user stories

อ่านและแก้ไข PRD, ข้อกำหนด และ stories; แยก stories, เชื่อมโยง issues และสร้าง issues จากข้อเสนอ story ที่ได้รับการรีวิว เครื่องมือ AI proposal ต้องใช้ mcp:write, สิทธิ์ AI plan ที่เกี่ยวข้อง และเครดิตที่พร้อมใช้งาน ข้อเสนอต้องมีการรีวิวและบันทึกแยกกัน; การอนุมัติ PRD โดยมนุษย์ยังคงอยู่ใน Velocity ดู จากแนวคิดสู่ issues

การติดตาม Issue

เครื่องมือ	ขอบเขต	คำอธิบาย
list_issues	อ่าน	แสดงรายการ issues พร้อมตัวกรองตามโปรเจกต์, สถานะ, ความสำคัญ, ผู้รับผิดชอบ, ป้ายกำกับ
get_issue	อ่าน	ดูรายละเอียดทั้งหมดของ issue ตาม ID หรือ identifier (เช่น ENG-123)
create_issue	เขียน	สร้าง issue ใหม่พร้อมชื่อเรื่อง, คำอธิบาย, ความสำคัญ, สถานะ
update_issue	เขียน	อัปเดตฟิลด์ของ issue ที่มีอยู่
search_issues	อ่าน	ค้นหาข้อความเต็มในชื่อเรื่องและคำอธิบายของ issues
add_comment	เขียน	เพิ่มความคิดเห็นใน issue
list_comments	อ่าน	แสดงรายการความคิดเห็นทั้งหมดใน issue

โปรเจกต์และ Cycles

เครื่องมือ	ขอบเขต	คำอธิบาย
list_projects	อ่าน	แสดงรายการโปรเจกต์ทั้งหมดพร้อมตัวกรองสถานะเพิ่มเติม
get_project	อ่าน	ดูรายละเอียดโปรเจกต์รวมถึง milestones และจำนวน issues
list_cycles	อ่าน	แสดงรายการ sprint cycles พร้อมตัวกรองสถานะเพิ่มเติม
get_cycle	อ่าน	ดูรายละเอียด cycle พร้อมจำนวน issues และความคืบหน้า

ข้อมูลเมตาของ Workspace

เครื่องมือ	ขอบเขต	คำอธิบาย
list_teams	อ่าน	แสดงรายการทีมทั้งหมดใน workspace
list_labels	อ่าน	แสดงรายการป้ายกำกับทั้งหมดที่มี
list_statuses	อ่าน	แสดงรายการสถานะ issues ทั้งหมดในทุกทีม
list_members	อ่าน	แสดงรายการสมาชิก workspace พร้อมบทบาท

Roadmap

เครื่องมือ	ขอบเขต	คำอธิบาย
list_roadmap_items	อ่าน	แสดงรายการ roadmap items พร้อมตัวกรองสถานะ, หมวดหมู่ และเวอร์ชัน
create_roadmap_item	เขียน	สร้างรายการ roadmap ใหม่
update_roadmap_item	เขียน	อัปเดตรายการ roadmap ที่มีอยู่
delete_roadmap_item	เขียน	ลบรายการ roadmap
vote_roadmap_item	เขียน	เปิด/ปิดการโหวตบนรายการ roadmap
list_roadmap_versions	อ่าน	แสดงรายการเวอร์ชัน roadmap ทั้งหมด (releases)
create_roadmap_version	เขียน	สร้างเวอร์ชัน roadmap ใหม่
get_roadmap_settings	อ่าน	ดูการมองเห็น roadmap และการตั้งค่าการโหวต
update_roadmap_settings	เขียน	อัปเดตการตั้งค่า roadmap

Workspace และผู้ใช้

เครื่องมือ	ขอบเขต	คำอธิบาย
list_workspaces	อ่าน	แสดงรายการ workspace ของผู้ใช้; OAuth คืนค่าเฉพาะ workspace ที่เชื่อมต่อเท่านั้น
create_workspace	เขียน	สร้าง workspace ใหม่ (ผู้ใช้กลายเป็น owner)
delete_workspace	เขียน	ลบ workspace อย่างถาวร (เฉพาะ owner)
get_workspace	อ่าน	ดูรายละเอียด workspace ปัจจุบัน (ชื่อ, แผน, จำนวนสมาชิก)
update_workspace	เขียน	อัปเดตชื่อ workspace (ไม่รองรับคำอธิบาย)
get_current_user	อ่าน	ดูโปรไฟล์ของผู้ใช้ที่ยืนยันตัวตน
update_current_user	เขียน	อัปเดตชื่อที่แสดงหรือรูปโปรไฟล์ของผู้ใช้
list_user_api_keys	อ่าน	แสดงรายการ personal API keys (คำนำหน้า velu_)
create_user_api_key	เขียน	สร้าง personal API key (คืนค่า key เพียงครั้งเดียว)
revoke_user_api_key	เขียน	เพิกถอน personal API key

Custom Domains

เครื่องมือ	ขอบเขต	คำอธิบาย
list_domains	อ่าน	แสดงรายการ custom domains พร้อมสถานะการตรวจสอบ
add_domain	เขียน	เพิ่ม custom domain พร้อมคำแนะนำการตั้งค่า DNS
verify_domain	เขียน	ตรวจสอบสถานะการยืนยันโดเมน
remove_domain	เขียน	ลบ custom domain

เวิร์กโฟลว์ Agent

เครื่องมือ	ขอบเขต	คำอธิบาย
transition_issue	เขียน	ย้าย issue ไปยังสถานะตามชื่อ (เช่น "In Progress") แทน UUID
get_my_issues	อ่าน	ดู issues ที่มอบหมายให้ผู้ใช้ที่ยืนยันตัวตน กรองตามกลุ่มสถานะ
get_active_sprint	อ่าน	ดู cycle ที่ใช้งานอยู่พร้อมจำนวน issues และความคืบหน้า
link_commit	เขียน	บันทึก commit SHA กับ issue
link_pr	เขียน	บันทึก URL ของ pull request กับ issue
get_issue_context	อ่าน	บริบท issue แบบสมบูรณ์: ความคิดเห็น, กิจกรรม, ป้ายกำกับ, เหตุการณ์ที่เชื่อมโยง
get_pending_agent_runs	อ่าน	ดู API หรือ Claude Code runs ที่รออยู่สำหรับ local worker
update_agent_run	เขียน	อัปเดตสถานะ, tokens และผลลัพธ์ของ agent run

ทรัพยากร

MCP server ยังเปิดเผยทรัพยากรแบบอ่านอย่างเดียวเหล่านี้เพื่อให้ได้บริบทอย่างรวดเร็ว:

URI	คำอธิบาย
velocity://workspace	ข้อมูลเมตาของ workspace (ชื่อ, slug, แผน, จำนวนสมาชิก/ทีม)
velocity://issues	issues ล่าสุด (20 รายการล่าสุด เรียงตามเวลาอัปเดต)
velocity://projects	โปรเจกต์ทั้งหมดพร้อมสถานะและความคืบหน้า
velocity://roadmap	ภาพรวมของ roadmap items, เวอร์ชัน และการตั้งค่า
velocity://domains	custom domains พร้อมสถานะการตรวจสอบ

ข้อจำกัดด้านข้อมูลประจำตัว

การเชื่อมต่อ OAuth ไม่สามารถแสดงรายการ, สร้าง หรือเพิกถอน personal API keys แม้ว่าเครื่องมือเหล่านั้นจะปรากฏในแคตตาล็อกก็ตาม จัดการ keys ในหน้าการตั้งค่า Velocity หรือใช้ connection token สำหรับเครื่องมือเหล่านี้ Connection tokens มีความสามารถด้านบัญชีที่กว้างกว่า; เก็บไว้เป็นความลับและเพิกถอนการเชื่อมต่อที่ไม่ใช้งาน

ขอบเขต (Scopes)

การอนุญาต MCP OAuth ใช้ scopes เหล่านี้ Connection tokens จาก Settings → MCP ประกอบด้วยทั้งสอง:

• mcp:read — อ่านเครื่องมือและทรัพยากร ภายใต้ข้อจำกัดด้านข้อมูลประจำตัวและฟีเจอร์
• mcp:write — เขียนเครื่องมือ ภายใต้การตรวจสอบนโยบายบทบาท, ฟีเจอร์ และ worker (ขอด้วย mcp:read)

ขั้นตอนถัดไป

• การตั้งค่าและการยืนยันตัวตน — ลงชื่อเข้าใช้หรือสร้าง connection token และกำหนดค่าไคลเอนต์ของคุณ
• เอกสารอ้างอิงเครื่องมือ — เอกสารพารามิเตอร์โดยละเอียดสำหรับแต่ละเครื่องมือ