- GitHub 연동 이슈 키를 기준으로 PR과 커밋을 이슈에 자동 연결합니다.
- AI로 해결 이슈를 Claude 또는 Codex 에이전트에 전달하고 PR을 받습니다.
- MCP 서버 Claude, Cursor 등의 AI 도우미에서 이슈를 읽고 수정합니다.
- API 토큰 접근 범위와 만료일을 지정하고 언제든 취소할 수 있는 접근 키입니다.
GitHub 연동: 코드와 함께 이슈를 관리하세요
회사 설정에서 Subtask GitHub 앱을 설치한 다음 저장소를 워크스페이스에 연결합니다. 연결하면 다음 기능을 사용할 수 있습니다.
- 제목, 설명 또는 브랜치 이름에
WEB-128과 같은 이슈 키가 포함된 PR이 해당 이슈에 연결됩니다. - 메시지에 이슈 키가 포함된 커밋이 이슈 아래에 표시됩니다.
- 이슈 상세 정보에서 PR이 열림, 초안, 닫힘, 병합됨 중 어떤 상태인지 확인합니다.
GitHub에서 전달되는 이벤트는 서명으로 검증합니다. 연결된 저장소는 언제든 변경하거나 연결을 해제할 수 있습니다.
AI로 해결: 이슈에서 PR까지
설명이 명확하게 작성된 이슈에서 AI로 해결을 클릭하면 Subtask가 연결된 저장소의 워크플로를 실행합니다. 설명에 더해 "서드 파티 스크립트를 추가하지 마세요"와 같은 지시를 추가할 수 있습니다. 에이전트는 자체 GitHub Actions 환경에서 저장소의 코드를 실행하고 브랜치를 만들어 PR을 엽니다. 진행 과정은 다음과 같습니다.
- 이슈를 AI에 전달합니다. 같은 이슈에 두 번째 AI 작업을 동시에 시작할 수 없습니다.
- 추가 정보가 필요하면 에이전트가 질문하고 이슈가 지정한 상태로 이동합니다. 답변하면 질문과 답변을 포함한 새 실행이 시작됩니다.
- PR이 생성되면 이슈가 검토 중 등 지정한 상태로 이동합니다.
- PR을 검토합니다. 변경을 원하면 내용을 설명하고 수정을 요청합니다. 에이전트는 같은 PR에 커밋을 추가합니다.
- PR을 병합하면 이슈가 완료 상태로 이동합니다.
저장소에 AI 키가 없는 경우 등 일반적인 실패 원인은 해결 절차와 함께 표시됩니다.
AI 세션: 질문과 답변을 한 화면에서
AI와 함께 작업하는 이슈에는 AI 세션 탭이 생깁니다. 설명, 댓글과 하위 작업은 이슈 탭에 정리되고 AI 관련 내용은 모두 이곳에 모입니다.
- 실행마다 카드 하나. 카드 상단에는 결과(질문, PR 생성, 수정 추가, 실패), 소요 시간, 예상 비용, PR과 GitHub Actions 로그가 표시됩니다. 카드 안에는 보낸 메시지와 에이전트의 답변이 함께 표시됩니다.
- 누가 응답할 차례인지 명확하게. 에이전트가 작업하는 동안 탭에 로딩 표시가 나타납니다. 질문에 답하거나 검토할 차례가 되면 내 차례가 표시됩니다.
- 하나의 메시지 입력창. 현재 상태에 따라 에이전트의 질문에 답하거나 열린 PR의 수정을 요청하거나 이슈를 처음부터 다시 해결할 수 있습니다. 답변은 에이전트의 이전 질문과 함께 다음 실행에 전달됩니다.
- 실행 중지. 실수로 실행을 시작했다면 오른쪽 상태 패널에서 중지할 수 있습니다.
- 전체 현황. 상태 패널에는 진행 단계, PR, 실행 횟수, 총 소요 시간과 비용이 표시됩니다.
PR 링크와 에이전트 요약처럼 AI가 이슈에 남기는 기록은 활동 피드의 별도 AI 필터에 모이므로 팀의 댓글 사이에 뒤섞이지 않습니다.
AI 제공자와 비용 한도를 직접 선택하세요
회사 단위로 Claude, Codex, Codex 구독 또는 자체 워크플로를 AI 제공자로 설정합니다. 기본 제공자의 경우 워크플로 파일을 확인하고 다운로드한 뒤 설정 안내를 단계별로 따르면 됩니다. AI 키는 GitHub 저장소의 비밀 정보에 보관되며 Subtask는 볼 수 없습니다.
워크스페이스별로 AI 사용 여부, 제공자와 기준 브랜치를 선택하고 월별 이슈 수와 비용 한도를 설정합니다. 화면에서 이번 달 사용량, 확인된 예상 비용과 남은 한도를 볼 수 있습니다. 준비 상태 점검에서는 저장소나 워크플로 설정에서 빠진 부분을 안내합니다.
AI로 이슈 설명 초안을 작성하세요
이슈 제목과 기존 설명을 바탕으로 설명 초안을 생성합니다. 결과를 미리 보고 필요하면 다시 생성한 뒤 만족스러우면 현재 설명에 덧붙일 수 있습니다. 잘 작성된 설명은 AI로 해결 기능의 결과를 개선하는 데도 도움이 됩니다. 이 기능에는 회사별 월간 한도가 있으며 서버에서 AI 설정이 활성화되면 표시됩니다.
MCP 서버: AI 도우미를 Subtask에 연결하세요
Claude Desktop, Claude Code, Cursor 또는 MCP를 지원하는 다른 AI 도우미에 Subtask MCP 서버를 추가하세요. 그러면 채팅으로 Subtask에서 다음 작업을 수행할 수 있습니다.
- 워크스페이스와 이슈 상태 목록 조회
- 워크스페이스, 스프린트 또는 담당자별 이슈 목록 및 이슈 상세 정보 조회
- 이슈 생성 및 요약, 설명, 담당자, 스프린트, 마감일, 예상 시간, 스토리 포인트 수정
- 댓글 추가와 상태 변경
- 관계 유형을 지정해 이슈 연결
- 이슈의 AI 해결 실행 시작
'이번 스프린트에서 내 미완료 이슈를 나열하고 가장 긴급한 이슈의 설명을 요약해 줘'와 같은 요청을 Subtask를 열지 않고 처리할 수 있습니다.
API 토큰: 접근 범위와 만료일을 지정하세요
자체 자동화를 위한 API 토큰을 생성합니다. 토큰마다 이름을 지정하고 접근 범위를 선택하세요.
| 범위 | 허용 작업 |
|---|---|
workspaces:read | 워크스페이스 읽기 |
issues:read | 이슈 읽기 |
issues:write | 이슈 생성 및 수정 |
ai:run | AI 해결 실행 시작 |
전체 토큰은 생성 시 한 번만 표시됩니다. 토큰에는 최대 365일까지 만료일을 지정합니다. 목록에는 접두사, 접근 범위, 상태, 마지막 사용일과 만료일이 표시되며 언제든 토큰을 취소할 수 있습니다. 토큰은 소유자의 역할 권한을 넘을 수 없으며 비활성 사용자의 요청이나 만료된 토큰의 요청은 거부됩니다.
자주 묻는 질문
AI가 코드를 자동으로 병합하나요?
에이전트가 이해하지 못한 내용이 있으면 어떻게 되나요?
실행 중인 AI 작업을 중지할 수 있나요?
Subtask에 AI 키를 제공해야 하나요?
어떤 AI 모델을 사용할 수 있나요?
MCP 서버는 유료인가요?
GitLab이나 Bitbucket도 지원하나요?
팀의 모든 업무를 한곳에서 관리하세요
Subtask를 무료로 시작하고 팀을 초대해 보세요. 몇 분이면 첫 업무를 만들 수 있습니다. 사용자 수가 늘어도 요금은 그대로입니다.
무료 계정 만들기