이 문서가 필요한 경우
- 이슈스티커에 쌓인 이슈를 팀이 이미 쓰는 도구로 넘기고 싶습니다.
- Jira와 Notion 중 첫 연동 대상을 정해야 합니다.
- OAuth, 프로젝트/데이터베이스 권한, 필드 동기화에서 막힐 가능성을 미리 보고 싶습니다.
끝나면 확인할 것
- 이슈를 끝까지 처리할 기본 도구를 하나 골랐습니다.
- 연결할 계정이 해당 프로젝트나 데이터베이스에 접근할 수 있는지 확인했습니다.
- 처음 노출할 필드와 나중에 추가할 필드를 구분했습니다.
먼저 정할 것
연동은 “이슈를 어디에서 끝까지 처리할지”를 정한 뒤 붙이는 편이 좋습니다. 개발팀이 스프린트와 릴리즈를 Jira에서 관리한다면 Jira를 먼저 연결하세요. 기획, QA, 운영팀이 Notion 데이터베이스를 기준으로 움직인다면 Notion이 더 자연스럽습니다.
두 서비스를 모두 연결할 수도 있지만, 처음에는 한 곳만 정해 검수 흐름을 확인하는 것을 권장합니다.
Jira가 맞는 경우
Jira는 개발 티켓으로 바로 이어져야 하는 버그에 잘 맞습니다.
- 담당자, 우선순위, 스프린트, 컴포넌트처럼 개발 프로세스에 필요한 필드를 씁니다.
- QA가 남긴 캡처와 녹화가 티켓 설명에 붙습니다.
- Jira에서 바뀐 필드를 다시 이슈스티커에서 확인할 수 있습니다.
- webhook을 연결하면 상태 변경을 더 빠르게 맞출 수 있습니다.
Notion이 맞는 경우
Notion은 QA 보드, 운영 요청, 고객 피드백을 한 데이터베이스에서 보는 팀에 잘 맞습니다.
- 데이터베이스 속성에 맞춰 이슈 제목, 상태, 링크, 담당자 정보를 채웁니다.
- 비개발자가 Notion에서 바로 정리하고 코멘트를 남길 수 있습니다.
- QA 회의나 릴리즈 체크리스트와 함께 보기 쉽습니다.
연동 전에 확인할 것
관리자 권한이 있는 계정으로 연결하세요. Jira 프로젝트나 Notion 데이터베이스를 선택하려면 해당 서비스 안에서 접근 권한이 필요합니다.
프로젝트마다 연동 대상을 따로 정할 수 있습니다. 운영 서비스, 스테이징, 클라이언트별 프로젝트를 나눠 쓰는 팀이라면 처음부터 프로젝트 단위로 연결 상태를 확인해 두세요.
처음에는 필드를 적게 켜는 편이 좋습니다. 필드가 많아지면 리포트를 남기는 사람이 멈칫하고, 필수값 누락으로 외부 이슈 생성이 실패할 가능성도 커집니다.
자주 막히는 지점
OAuth 화면에서 권한을 허용했는데도 목록이 보이지 않는다면, 외부 서비스 안에서 계정 권한을 먼저 확인해야 합니다. 필드가 안 보이거나 동기화가 늦는 경우는 대부분 권한, 선택한 프로젝트/데이터베이스, 필드 타입 문제입니다.