Shortcut 자동화
Claude Code에서 직접 Shortcut 프로젝트 관리 작업을 자동화하세요. 터미널을 떠나지 않고 스토리를 생성 및 조회하고, 작업과 댓글을 추가하고, 스토리를 일괄 생성하고, 워크플로를 탐색할 수 있습니다.
툴킷 문서: composio.dev/toolkits/shortcut
설정
- Rube MCP 서버를 Claude Code 설정에 추가합니다. URL은
https://rube.app/mcp입니다. - 프롬프트가 표시되면 제공된 연결 링크를 통해 Shortcut 계정을 인증합니다.
- 자연어로 프로젝트 관리 워크플로를 자동화하기 시작합니다.
핵심 워크플로
1. 스토리 생성
전체 구성을 통해 Shortcut 작업 공간에 새 스토리를 추가합니다.
도구: SHORTCUT_CREATE_STORY
"다크 모드 지원"이라는 기능 스토리를 workflow_state_id 500000001, 추정치 5, 레이블 "프론트엔드"로 생성해줘.
SHORTCUT_CREATE_STORY의 주요 파라미터:
name(필수) -- 스토리 제목workflow_state_id-- 스토리를 배치할 워크플로 상태 (project_id보다 권장)story_type--"feature","bug", 또는"chore"description-- 스토리 본문/설명estimate-- 숫자 포인트 추정치 (또는 미추정의 경우 null)epic_id-- 에픽과 연결iteration_id-- 반복과 연결labels--name(및 선택적color,description)을 포함하는 레이블 객체 배열owner_ids-- 할당할 멤버 UUID 배열deadline-- ISO 8601 형식의 마감일tasks--description과 선택적complete,owner_ids를 포함하는 인라인 작업 배열comments--text를 포함하는 인라인 댓글 배열story_links--verb("blocks","duplicates","relates to")로 스토리 연결
중요: workflow_state_id 또는 project_id 중 하나만 제공해야 하며, 둘 다 제공하면 안 됩니다. Shortcut에서 프로젝트가 단계적으로 폐지되고 있으므로 workflow_state_id를 권장합니다.
2. 스토리 일괄 생성
단일 API 호출로 여러 스토리를 생성합니다.
도구: SHORTCUT_CREATE_MULTIPLE_STORIES
버그 스토리 3개를 생성해줘: "로그인 페이지 500 오류", "장바구니 합계 반올림 문제", "검색 결과 빈 상태 오류"
stories배열이 필요하며, 각 요소는SHORTCUT_CREATE_STORY와 동일한 스키마를 따릅니다.- 배열의 각 스토리에는
name이 필요합니다. - 대량 가져오기, 스프린트 계획, 템플릿 기반 스토리 생성에 효율적입니다.
3. 프로젝트 내 스토리 조회
특정 프로젝트 내의 모든 스토리를 검색합니다.
도구: SHORTCUT_LIST_STORIES
프로젝트 42의 모든 스토리를 설명과 함께 보여줘.
project__public__id(정수 프로젝트 ID) 필요- 선택적
includes_description: true로 응답에 스토리 설명 포함 - 모든 스토리와 속성(상태, 유형, 추정치 등)을 반환합니다.
4. 스토리 작업 관리
하위 작업 추적을 위해 스토리 내에 작업(체크리스트)을 생성합니다.
도구: SHORTCUT_CREATE_TASK
스토리 12345에 "다크 모드 토글에 대한 단위 테스트 작성" 작업을 추가해줘.
주요 파라미터:
story__public__id(필수) -- 상위 스토리 IDdescription(필수) -- 작업 설명complete-- 불리언, 기본값 falseowner_ids-- 작업을 할당할 멤버 UUID 배열external_id-- 가져온 경우 외부 도구의 ID
5. 스토리 댓글 추가
토론 및 문서화를 위해 스토리에 댓글을 게시합니다.
도구: SHORTCUT_CREATE_STORY_COMMENT
스토리 12345에 댓글을 추가해줘: "구현 검토 완료 -- 좋아 보이지만 접근성 테스트가 필요함"
주요 파라미터:
story__public__id(필수) -- 스토리 IDtext(필수) -- 댓글 본문author_id-- 멤버 UUID (기본값은 API 토큰 소유자)parent_id-- 스레드 응답을 위한 상위 댓글 ID
6. 워크플로 및 프로젝트 검색
스토리 생성에 필요한 ID를 확인하기 위해 워크플로와 프로젝트를 조회합니다.
도구: SHORTCUT_LIST_WORKFLOWS, SHORTCUT_LIST_PROJECTS
Shortcut 작업 공간의 모든 워크플로를 보여줘서 올바른 워크플로 상태 ID를 찾을 수 있게 해줘.
SHORTCUT_LIST_WORKFLOWS는 모든 워크플로와 해당 상태(ID, 이름, 유형)를 반환합니다.SHORTCUT_LIST_PROJECTS는 모든 프로젝트와 해당 속성을 반환합니다.- 스토리를 생성하기 전에 유효한
workflow_state_id및project_id값을 찾는 데 사용합니다.
알려진 문제점
workflow_state_idvsproject_id:SHORTCUT_CREATE_STORY는 이 중 정확히 하나가 필요합니다. 둘 다 제공하거나 둘 다 제공하지 않으면 거부됩니다. 프로젝트가 단계적으로 폐지되고 있으므로workflow_state_id를 선호합니다.- 프로젝트가 단계적으로 폐지됩니다: Shortcut은 워크플로 기반 구성을 위해 프로젝트를 폐지하고 있습니다. 새 스토리에는
workflow_state_id를 사용하세요. - 레이블은 인라인으로 생성됩니다:
labels배열의 레이블은 존재하지 않는 경우 즉시 생성됩니다. 각 레이블 객체에는name필드가 필요합니다. - 스토리 유형 기본값:
story_type이 생략되면 기본값은"feature"입니다. 버그와 chore의 경우 항상 명시적으로 설정하세요. - 배치 제한:
SHORTCUT_CREATE_MULTIPLE_STORIES는 단일 요청으로 모든 스토리를 처리합니다. 매우 큰 배치는 시간 초과될 수 있으므로 25개 미만으로 유지하세요. - 스토리/프로젝트의 정수 ID: 스토리 및 프로젝트 ID는 정수이며 UUID가 아닙니다. 멤버 및 그룹 ID는 UUID입니다. 형식을 혼동하면 오류가 발생합니다.
move_to위치 지정:move_to필드("first"또는"last")는 상태 간이 아닌 워크플로 상태 내에서 스토리를 이동시킵니다.
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
SHORTCUT_CREATE_STORY | 단일 스토리 생성 (name + workflow_state_id 또는 project_id 필요) |
SHORTCUT_CREATE_MULTIPLE_STORIES | 여러 스토리 일괄 생성 (stories 배열 필요) |
SHORTCUT_LIST_STORIES | 프로젝트의 스토리 조회 (project__public__id 필요) |
SHORTCUT_CREATE_TASK | 스토리에 작업 생성 (story__public__id, description 필요) |
SHORTCUT_CREATE_STORY_COMMENT | 스토리에 댓글 추가 (story__public__id, text 필요) |
SHORTCUT_CREATE_STORY_FROM_TEMPLATE | 템플릿에서 스토리 생성 |
SHORTCUT_LIST_WORKFLOWS | 모든 워크플로 및 해당 상태 조회 |
SHORTCUT_LIST_PROJECTS | 모든 프로젝트 조회 |
Composio 제공