Velocity

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

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 또는 Settings → 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 대신 이름(예: "In Progress")으로 이슈를 상태로 이동
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 부여는 다음 범위를 사용합니다. Settings → MCP의 연결 토큰은 두 가지를 모두 포함합니다:

• mcp:read — 자격 증명 및 기능 제한이 적용되는 읽기 도구 및 리소스
• mcp:write — 역할, 기능 및 워커 정책 검사가 적용되는 쓰기 도구(mcp:read로 요청)

다음 단계

• 설정 및 인증 — 로그인하거나 연결 토큰을 생성하고 클라이언트 구성
• 도구 레퍼런스 — 각 도구의 상세 매개변수 문서