플랫폼 연동
플랫폼 연결은 연동 탭에서 합니다. 연결된 플랫폼이 없으면 "플랫폼 추가" 화면으로, 하나라도 있으면 "내 연동" 화면으로 들어갑니다.
연결하는 법
연결 방식 선택 다이얼로그
생각보다 간단합니다. 세 단계면 됩니다.
- "플랫폼 추가"에서 연결할 플랫폼을 고릅니다.
- 연결 방식 선택 다이얼로그가 뜨면 OAuth(브라우저 로그인) 또는 토큰 직접 입력 중 하나를 고릅니다.
- OAuth면 로그인 창에서 권한을 허용하면 끝, 토큰 방식이면 발급한 토큰과 필요한 값을 입력합니다.
대부분은 OAuth가 가장 편합니다. 다만 조직 정책으로 OAuth를 못 쓰거나 토큰을 선호하신다면 토큰 방식을 쓰면 됩니다. 참고로 Slack은 OAuth 연결만 지원하므로, "Slack 연결"을 누르면 바로 로그인 창이 뜹니다.
플랫폼별 연결 정보
| 플랫폼 | 연결 방식 | 토큰 입력 시 필요값 | 토큰 발급 |
|---|---|---|---|
| Jira | OAuth / API Token | baseUrl, email, apiToken | id.atlassian.com → API tokens |
| GitHub | OAuth / PAT | PAT | github.com/settings/tokens |
| Linear | OAuth / API Key | apiKey | linear.app 보안 설정 |
| Notion | OAuth / Internal Token | token | notion.so 통합(Integration) |
| GitLab | OAuth / PAT | instanceUrl(self-managed만 — https 주소만 받습니다. localhost는 예외), pat | gitlab.com PAT |
| Asana | OAuth / PAT | pat | app.asana.com my-apps |
| ClickUp | OAuth / API Token | pat | app.clickup.com 설정 > Apps |
| Slack | OAuth 전용 | — (토큰 입력 없음) | — |
Slack — 채널·DM으로 가볍게 공유
Slack은 이슈 트래커가 아니라 메시지 앱이라, 다른 플랫폼과는 조금 다르게 동작합니다. 정식 이슈로 올리기 전에 "이거 깨졌어요" 하고 팀 채널에 먼저 던지고 싶을 때 딱 맞습니다.
- 본인 계정으로 전송: OAuth로 연결하면 본인 이름으로 메시지를 보냅니다(봇이 아니라요). 그래서 채널에 따로 봇을 초대할 필요가 없습니다.
- 어디로 보낼지: 공개 채널·비공개 채널은 물론 DM까지, 본인이 참여 중인 대화면 어디든 고를 수 있습니다. (참여하지 않은 채널은 목록에 뜨지 않습니다.)
- 제목은 채널에, 상세는 스레드로: 제목이 채널에 메시지로 올라가고, 환경 정보·스타일 변화·로그 요약 같은 상세 내용과 스크린샷·영상·로그 파일은 그 메시지의 스레드 답글로 정리됩니다. 채널 타임라인은 제목 한 줄로 깔끔하게 유지됩니다.
- 멘션: 호명할 멤버를 고르면 메시지에서
@이름으로 불러 알림을 보냅니다.
Slack은 메시지라 "열림/닫힘" 같은 상태가 없습니다. 그래서 이슈 목록에는 "전송됨" 표시만 뜨고, 누르면 해당 메시지로 바로 이동합니다.
나중에 정식 트래커로 승격하기
Slack 카드의 자세히·트래커로 등록 버튼
Slack으로 가볍게 공유했는데 "이건 정식 이슈로도 남겨야겠다" 싶을 때가 있죠. 걱정 마세요. Slack으로 공유한 이슈는 캡처 이미지·영상·로그 같은 원본 데이터를 그대로 보관해 둡니다. 그래서 Jira·GitHub 같은 트래커를 하나라도 연결해 두면, 이슈 목록에서 그 Slack 카드 오른쪽에 자세히·트래커로 등록 두 버튼이 나타납니다.
- 자세히: 보관해 둔 캡처·로그를 다시 열어 확인합니다. 여기서 제목과 본문 섹션 오른쪽의 연필 모양 수정 버튼을 눌러 트래커로 옮기기 전에 문구를 다듬을 수도 있습니다. Slack에는 가볍게 공유하고, 정식 이슈에는 정돈된 내용을 담고 싶을 때 유용하죠. 다만 이렇게 고친 내용은 이미 보낸 Slack 메시지에는 반영되지 않고, 트래커로 등록할 때만 반영됩니다.
- 트래커로 등록: 제출 창이 열립니다(이때 Slack 탭은 빠집니다). 원하는 트래커를 골라 정식 이슈로 옮기면, 그 카드는 일반 이슈로 바뀌고 Slack 이력은 정리됩니다. 이때 원래 Slack 메시지 스레드에도 등록된 트래커 이슈 링크가 댓글로 남아, 그 대화를 함께 보던 팀원도 "이 버그는 여기 정리됐구나"를 바로 알 수 있습니다.
트래커를 아직 연결하지 않았다면 두 버튼은 보이지 않고, 기존처럼 "전송됨" 표시와 메시지 바로가기만 유지됩니다. 나중에 트래커를 연결하면 같은 카드에 버튼이 자연스럽게 나타납니다. 카드 본문을 누르면 언제나 Slack 메시지로 이동하는 동작은 그대로니 안심하세요.
연결 후 기본값
연결 후 기본값 설정
연결하면 그 플랫폼에서 이슈를 만들 위치의 기본값을 골라 둘 수 있습니다 — Jira·GitLab의 프로젝트, GitHub의 저장소, Linear의 팀, Notion의 데이터베이스, Asana의 프로젝트, ClickUp의 리스트(워크스페이스 → 스페이스 → 리스트 순으로 선택), Slack의 채널처럼요. 한 번만 정해 두면 이슈를 쓸 때마다 다시 고르지 않아도 되니 한결 편합니다.
위치 말고 이슈에 채워질 값도 미리 정해 둘 수 있습니다. 담당자는 Jira·GitHub·GitLab·Linear·Asana·ClickUp에서 지정할 수 있고(Notion·Slack은 담당자 개념이 없습니다), 그 밖에 라벨(GitHub·GitLab·Linear)이나 기본 이슈 타입(Jira)도 함께 골라 둘 수 있습니다. 정해 두면 이슈를 쓸 때 그 값이 미리 채워져 있습니다 — 다만 직전에 제출할 때 고른 값이 있으면 그쪽이 우선입니다. 매번 같은 사람에게 맡기다가 한 번 다른 사람에게 맡기면, 그다음엔 방금 고른 사람이 이어서 채워지는 식이죠.
담당자 후보를 불러오려면 위치를 먼저 정해야 합니다(GitHub은 저장소, GitLab은 프로젝트, Linear는 팀, Asana·ClickUp은 워크스페이스). 아직 안 골랐다면 담당자 칸이 "먼저 선택하세요"라고 안내하며 비활성 상태로 기다립니다. Jira만 예외라서, 프로젝트를 고르기 전에도 담당자를 검색할 수 있습니다.
한 가지 알아 두시면 좋은 점이 있습니다. 위치를 바꾸면 그 아래 담당자·라벨 기본값은 자동으로 비워집니다. 저장소나 프로젝트가 달라지면 예전에 골라 둔 담당자는 그쪽 멤버가 아닐 수 있기 때문인데요, 엉뚱한 사람이 남아 있다가 조용히 배정되는 것보다 낫다고 판단했습니다. 새 위치에서 다시 골라 주세요.
Jira는 프로젝트를 제출할 때도 바꿀 수 있습니다. 여기서 고른 프로젝트는 "평소 쓰는 곳"이고, 이슈를 쓰다가 제출 창의 맨 위 프로젝트 칸에서 다른 프로젝트로 옮겨 등록할 수 있습니다. 이때 연결 설정은 그대로 남으니, 여기 정해 둔 기본 프로젝트가 바뀌지는 않습니다. 프로젝트를 옮기면 이슈 타입·담당자·상위 에픽·연결 이슈는 비워집니다(그 프로젝트에 없는 값일 수 있어서요) — 우선순위와 참조는 프로젝트와 상관없는 값이라 그대로 남습니다. 옮긴 직후에는 이슈 타입 목록이 자동으로 열려 바로 고를 수 있고, 고르기 전까지는 등록 버튼이 잠깁니다. 그리고 위의 "직전에 제출할 때 고른 값이 우선" 규칙은 프로젝트에도 똑같이 적용돼서, 다음에 이슈를 쓰면 방금 등록한 프로젝트로 열립니다.
스프린트를 쓰는 프로젝트라면 제출할 때 스프린트도 고를 수 있습니다. 제출 창에서 이슈 타입 바로 아래에 스프린트 칸이 나타나고, 진행 중이거나 앞으로 예정된 스프린트 중에서 고르면 됩니다. 선택 사항이라 비워 둔 채 등록해도 괜찮습니다. 이 칸은 BugShot이 Jira에 "이 프로젝트와 이슈 타입에 스프린트 필드가 있나요?"라고 물어본 뒤 "있다"는 답을 받았을 때만 보입니다 — 그래서 칸반 보드만 쓰거나 아직 보드를 연결하지 않은 프로젝트에서는 아예 나타나지 않습니다. 보드가 여러 개인 프로젝트라면 스프린트 이름 아래에 어느 보드의 스프린트인지도 함께 보여 줍니다. 여기에도 "직전에 고른 값이 우선" 규칙이 이어져서 다음 이슈에 같은 스프린트가 미리 채워지는데, 그 사이 스프린트가 종료됐다면 알아서 비워집니다.
Jira를 OAuth(브라우저 로그인)로 연결해 두셨다면 스프린트 목록이 비어 보일 수 있습니다. 스프린트를 읽으려면 Jira 권한이 하나 더 필요한데, 이미 연결해 둔 계정은 연결하던 시점의 권한만 가지고 있기 때문입니다. 연동 설정에서 Jira를 한 번 다시 연결해 주시면 목록이 제대로 뜹니다. API 토큰으로 연결하셨다면 해당되지 않습니다.
연결 해제
"내 연동"에서 플랫폼별로 연결을 끊을 수 있고(플러그 해제 아이콘), 모든 연결을 한 번에 해제하는 것도 가능합니다. 해제해도 이미 제출한 이슈에는 아무 영향이 없으니 안심하세요.