Velocity

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

MCP सर्वर

Model Context Protocol के माध्यम से AI एजेंट्स को Velocity से जोड़ें।

MCP क्या है?

Model Context Protocol (MCP) एक खुला मानक है जो AI एजेंट्स को एकीकृत इंटरफ़ेस के ज़रिए बाहरी टूल्स के साथ इंटरैक्ट करने देता है। Velocity में एक अंतर्निहित MCP सर्वर शामिल है जिसमें 84 टूल्स हैं — issue tracking, PRDs और user stories, project context, workspace events, workspace और user management, roadmap planning, custom domains, Claude agent coordination, और बहुत कुछ के लिए।

Claude Code, Claude Desktop, Codex, Cursor और अन्य MCP-संगत क्लाइंट्स जैसे AI एजेंट्स Velocity से जुड़ सकते हैं और issues बना सकते हैं, tasks खोज सकते हैं, statuses अपडेट कर सकते हैं, projects प्रबंधित कर सकते हैं, roadmaps की योजना बना सकते हैं, और domains कॉन्फ़िगर कर सकते हैं — वह सब अपने workflow से बाहर निकले बिना।

उपलब्धता और पहुँच

MCP Pro, Business या Enterprise पर मौजूद workspaces के वर्तमान सदस्यों के लिए उपलब्ध है। Free workspaces MCP का उपयोग नहीं कर सकते। Settings → MCP से browser OAuth या workspace connection token के माध्यम से कनेक्ट करें। Personal API keys MCP को प्रमाणित नहीं कर सकते। setup और troubleshooting देखें।

कनेक्टेड सर्वर का tools/list प्रतिक्रिया वर्तमान tool और input-schema कैटलॉग है। सूचीबद्ध tool के लिए फिर भी write scope, owner/admin भूमिका, feature entitlement, integration configuration या managed worker lease की आवश्यकता हो सकती है। केवल tool पहुँच किसी worker को शुरू नहीं करती और न ही स्वायत्त coding, review, merge या deployment की गारंटी देती है।

उपयोग के मामले

• AI coding assistants — code reviews से सीधे bug reports बनाएँ
• Automated triage — एजेंट्स आने वाले issues को वर्गीकृत और प्राथमिकता देते हैं
• Status updates — एजेंट्स काम पूरा होने पर issue की प्रगति अपडेट करते हैं
• Search और context — एजेंट्स अपने काम को सूचित करने के लिए संबंधित issues ढूँढते हैं
• Project management — एजेंट्स projects, cycles और milestones पढ़ते हैं
• Roadmap planning — एजेंट्स roadmap items, versions और voting प्रबंधित करते हैं
• Domain management — एजेंट्स custom domains जोड़ते और सत्यापित करते हैं
• AI agent coordination — कॉन्फ़िगर किए गए workers issues प्रोसेस करते हैं, commits लिंक करते हैं, और sprint प्रगति ट्रैक करते हैं

उपलब्ध टूल्स

ये तालिकाएँ चयनित टूल्स हैं। tools reference में PRD और story planning, private attachments, workspace events, issue/check monitoring और delivery profiles भी शामिल हैं। MCP वर्तमान में project/cycle context पढ़ता है; projects, cycles या project milestones बनाने के लिए GraphQL API का उपयोग करें।

PRDs और user stories

PRDs, requirements और stories पढ़ें और संपादित करें; stories विभाजित करें, issues लिंक करें, और समीक्षित story proposals से issues बनाएँ। AI proposal tools के लिए mcp:write, संबंधित AI plan entitlement और उपलब्ध credits आवश्यक हैं। Proposals के लिए अलग review और save क्रियाएँ आवश्यक हैं; मानव PRD अनुमोदन Velocity में ही रहता है। From idea to issues देखें।

Issue Tracking

Tool	Scope	विवरण
list_issues	read	project, status, priority, assignee, label के फ़िल्टर के साथ issues की सूची बनाएँ
get_issue	read	ID या identifier (जैसे, ENG-123) से किसी issue का पूरा विवरण प्राप्त करें
create_issue	write	title, description, priority, status के साथ नया issue बनाएँ
update_issue	write	किसी मौजूदा issue के फ़ील्ड अपडेट करें
search_issues	read	issue titles और descriptions में full-text खोज
add_comment	write	किसी issue में टिप्पणी जोड़ें
list_comments	read	किसी issue पर सभी टिप्पणियों की सूची बनाएँ

Projects और Cycles

Tool	Scope	विवरण
list_projects	read	वैकल्पिक status फ़िल्टर के साथ सभी projects की सूची बनाएँ
get_project	read	milestones और issue count सहित project विवरण प्राप्त करें
list_cycles	read	वैकल्पिक status फ़िल्टर के साथ sprint cycles की सूची बनाएँ
get_cycle	read	issue counts और प्रगति सहित cycle विवरण प्राप्त करें

Workspace Metadata

Tool	Scope	विवरण
list_teams	read	workspace में सभी teams की सूची बनाएँ
list_labels	read	सभी उपलब्ध labels की सूची बनाएँ
list_statuses	read	सभी teams में सभी issue statuses की सूची बनाएँ
list_members	read	भूमिकाओं सहित workspace members की सूची बनाएँ

Roadmap

Tool	Scope	विवरण
list_roadmap_items	read	status, category और version फ़िल्टर के साथ roadmap items की सूची बनाएँ
create_roadmap_item	write	नया roadmap item बनाएँ
update_roadmap_item	write	किसी मौजूदा roadmap item को अपडेट करें
delete_roadmap_item	write	किसी roadmap item को हटाएँ
vote_roadmap_item	write	किसी roadmap item पर vote टॉगल करें
list_roadmap_versions	read	सभी roadmap versions (releases) की सूची बनाएँ
create_roadmap_version	write	नया roadmap version बनाएँ
get_roadmap_settings	read	roadmap visibility और voting सेटिंग्स प्राप्त करें
update_roadmap_settings	write	roadmap सेटिंग्स अपडेट करें

Workspace और User

Tool	Scope	विवरण
list_workspaces	read	user workspaces की सूची बनाएँ; OAuth केवल कनेक्टेड workspace लौटाता है
create_workspace	write	नया workspace बनाएँ (user owner बन जाता है)
delete_workspace	write	किसी workspace को स्थायी रूप से हटाएँ (केवल owner)
get_workspace	read	वर्तमान workspace विवरण प्राप्त करें (name, plan, member count)
update_workspace	write	workspace का नाम अपडेट करें (description समर्थित नहीं है)
get_current_user	read	प्रमाणित user की profile प्राप्त करें
update_current_user	write	user का display name या avatar अपडेट करें
list_user_api_keys	read	personal API keys की सूची बनाएँ (velu_ prefix)
create_user_api_key	write	personal API key बनाएँ (key एक बार लौटाता है)
revoke_user_api_key	write	personal API key रद्द करें

Custom Domains

Tool	Scope	विवरण
list_domains	read	verification status सहित custom domains की सूची बनाएँ
add_domain	write	DNS setup निर्देशों के साथ custom domain जोड़ें
verify_domain	write	domain verification status जाँचें
remove_domain	write	custom domain हटाएँ

Agent workflow

Tool	Scope	विवरण
transition_issue	write	UUID के बजाय नाम (जैसे, "In Progress") से issue को status में ले जाएँ
get_my_issues	read	प्रमाणित user को सौंपे गए issues प्राप्त करें, status group के अनुसार फ़िल्टर करें
get_active_sprint	read	issue counts और प्रगति सहित सक्रिय cycle प्राप्त करें
link_commit	write	किसी issue के विरुद्ध commit SHA रिकॉर्ड करें
link_pr	write	किसी issue के विरुद्ध pull request URL रिकॉर्ड करें
get_issue_context	read	समृद्ध issue context: comments, activities, labels, linked events
get_pending_agent_runs	read	local worker के लिए लंबित API या Claude Code runs प्राप्त करें
update_agent_run	write	agent run का status, tokens और result अपडेट करें

Resources

MCP सर्वर त्वरित context के लिए ये read-only resources भी प्रदान करता है:

URI	विवरण
velocity://workspace	Workspace metadata (name, slug, plan, member/team counts)
velocity://issues	हाल के issues (अंतिम 20, update समय के अनुसार क्रमबद्ध)
velocity://projects	status और प्रगति सहित सभी projects
velocity://roadmap	Roadmap items, versions और settings का अवलोकन
velocity://domains	verification status सहित custom domains

Credential सीमाएँ

OAuth कनेक्शन personal API keys को सूचीबद्ध, बना या रद्द नहीं कर सकते, भले ही वे tools कैटलॉग में दिखाई दें। इन tools के लिए Velocity settings में keys प्रबंधित करें या connection token का उपयोग करें। Connection tokens में व्यापक account क्षमताएँ होती हैं; इन्हें निजी रखें और अप्रयुक्त कनेक्शन रद्द करें।

Scopes

MCP OAuth grants इन scopes का उपयोग करते हैं। Settings → MCP से connection tokens दोनों शामिल करते हैं:

• mcp:read — Read tools और resources, credential और feature प्रतिबंधों के अधीन
• mcp:write — Write tools, role, feature और worker policy जाँचों के अधीन (mcp:read के साथ अनुरोध करें)

अगले कदम

• Setup और Auth — साइन इन करें या connection token बनाएँ और अपना client कॉन्फ़िगर करें
• Tools Reference — प्रत्येक tool के लिए विस्तृत parameter दस्तावेज़