Jira, GitHub, Linear 연동하기
매니패스트에서 Jira, GitHub, Linear을 연결하고 기획 내용을 이슈로 조회, 생성, 수정하는 방법을 안내합니다.
매니패스트에서는 프로젝트 채팅에서 Linear, GitHub, Jira의 이슈를 조회하거나, 기획 내용을 새로운 이슈로 만들고 수정과 댓글 작업을 요청할 수 있습니다.
외부 이슈 트래커에 실제 변경을 반영하기 전에는 승인 카드가 표시됩니다. 카드에서 대상과 변경 내용을 확인하고 실행 버튼을 누르면 이슈가 생성되거나 수정됩니다.
1. 이슈 트래커 연동으로 할 수 있는 일
지원하는 작업
이슈 조회 및 요약: 이슈 키나 URL을 기준으로 제목, 본문, 상태 등 필요한 내용을 찾아 요약합니다.
이슈 생성: PRD, 기능명세서, 유저플로우 등 프로젝트의 기획 내용을 바탕으로 새로운 이슈 초안을 만듭니다.
이슈 수정: 기존 이슈의 제목, 설명, 상태, 담당자, 우선순위, 라벨 등의 변경을 요청합니다.
댓글 작성: 기존 이슈에 남길 댓글을 작성하고 승인 후 등록합니다.
기획과 이슈 연결: 기획 항목을 기준으로 이슈를 만들면 매니패스트 원문으로 돌아오는 출처 링크가 함께 추가됩니다.
서비스별 주요 구성
Linear: 워크스페이스와 팀을 연결하고 이슈 키를 기준으로 작업합니다.
GitHub: fine-grained 개인용 액세스 토큰과 대상 저장소를 등록해 작업합니다.
Jira: Atlassian 계정과 Jira 사이트를 연결하고 프로젝트 키를 기준으로 작업합니다.
2. 이슈 트래커 연결 화면 열기
AI와 연결에서 트래커 선택하기
이슈 작업에 사용할 매니패스트 프로젝트를 엽니다.
프로젝트 화면에서 AI와 연결을 누릅니다.
기획서에서 이슈/티켓 만들기 항목을 선택합니다.
연결할 서비스에서 연결을 누릅니다.
트래커 연결은 AI와 연결 화면 안에서 진행됩니다. 연결이 완료된 서비스에는 연결됨 상태와 연결된 계정 또는 저장소 정보가 표시됩니다.
연결 상태 확인하기
연결: 서비스 인증 또는 토큰 등록을 시작합니다.
연결됨: 매니가 해당 서비스의 이슈를 조회하고 작업할 수 있는 상태입니다.
연결 관리: 연결된 계정과 저장소를 확인하고 연결 정보를 관리합니다.
3. 연결하기
Linear 연결하기
Linear 인증 진행하기
트래커 목록에서 Linear를 선택하고 연결을 누릅니다.
Linear 인증 화면에서 연결할 계정과 워크스페이스를 확인합니다.
매니패스트가 요청하는 권한을 확인하고 연결을 승인합니다.
매니패스트로 돌아오면 Linear가 연결됨으로 표시되는지 확인합니다.
프로젝트 채팅에서 조회하거나 작업할 Linear 이슈를 요청합니다.
여러 Linear 워크스페이스를 사용한다면 인증 화면에 표시된 워크스페이스가 실제로 이슈를 관리할 곳인지 확인한 뒤 승인하세요.
Linear 요청 시 확인할 정보
팀 또는 프로젝트: 새로운 이슈가 들어갈 조직과 업무 공간을 지정합니다.
이슈 식별자: 기존 이슈를 조회하거나 수정할 때는 영문 팀 키-숫자 형식으로 입력합니다. 예: ABC-123
우선순위, 담당자, 라벨: 필요한 속성을 요청하고 승인 카드에서 반영할 내용을 확인합니다.
출처 링크: 기획 항목을 기준으로 생성한 이슈에서 매니패스트 원문을 함께 확인할 수 있습니다.
GitHub 연결하기
GitHub는 fine-grained 개인용 액세스 토큰과 대상 저장소를 직접 등록해 연결합니다. 이슈 작업에 필요한 저장소와 권한만 선택해 안전하게 사용할 수 있습니다.
토큰을 만들기 전에 확인하기
이슈를 만들거나 수정할 GitHub 계정 또는 조직을 확인합니다.
연결할 저장소 목록을 준비합니다.
조직 저장소는 조직 정책에 따라 관리자 승인 절차를 거칠 수 있습니다.
토큰은 비밀번호처럼 관리하고 문서, 채팅, 스크린샷에 값을 남기지 않습니다.
fine-grained 토큰 발급하기
매니패스트의 GitHub 연결 화면에서 토큰 발급을 누릅니다.
GitHub 토큰 설정에서 Resource owner를 선택합니다.
Repository access에서 Only select repositories를 선택하고 이슈 작업에 사용할 저장소를 지정합니다.
Permissions → Repository permissions → Issues를 Read and write로 설정합니다.
설정을 확인하고 토큰을 발급합니다.
자세한 토큰 설정은 GitHub 개인용 액세스 토큰 공식 문서에서 확인할 수 있습니다.
매니패스트에 저장소와 토큰 등록하기
이미지에서 확인할 항목
1. 저장소 접근 범위: GitHub 토큰이 접근할 저장소 범위를 선택합니다. 이슈 작업에 사용할 저장소만 포함하도록 범위를 설정합니다.
2. Issues 권한: Permissions의 Repository permissions에서 Issues를 Read and write로 설정합니다.
3. 연결 정보 입력: 매니패스트의 대상 저장소에 owner/repo를 입력하고, 액세스 토큰에 발급한 토큰을 입력한 뒤 연결합니다.
대상 저장소에 GitHub URL의 owner/repo 부분을 입력합니다.
여러 저장소를 연결하려면 각 owner/repo를 쉼표로 구분합니다.
액세스 토큰에 발급받은 토큰을 붙여넣습니다.
연결을 누르고 연결된 계정과 저장소를 확인합니다.
프로젝트 채팅에서 이슈를 만들 저장소를 지정해 요청합니다.
예를 들어 GitHub 주소가 github.com/소유자/저장소라면 대상 저장소에는 소유자/저장소만 입력합니다.
조직 저장소 연결하기
조직이 fine-grained 토큰 승인을 사용하는 경우 조직 관리자의 승인 절차를 진행합니다. 필요한 저장소와 Issues: Read and write 권한만 선택하면 이슈 관리 범위를 명확하게 유지할 수 있습니다.
Jira 연결하기
Jira 인증 진행하기
트래커 목록에서 Jira를 선택하고 연결을 누릅니다.
Atlassian 인증 화면에서 연결할 Jira 사이트를 확인합니다.
요청 권한을 확인하고 Accept 버튼을 누릅니다.
매니패스트로 돌아오면 Jira가 연결됨으로 표시되는지 확인합니다.
프로젝트 채팅에서 조회하거나 작업할 Jira 이슈를 요청합니다.
Jira 요청 시 확인할 정보
사이트와 프로젝트: 이슈를 만들 Jira 사이트와 프로젝트를 지정합니다.
이슈 키: 기존 이슈를 조회하거나 수정할 때는 프로젝트 키-숫자 형식으로 입력합니다. 예: PROJECT-123
새 이슈 번호: 새로운 Jira 이슈 번호는 Jira가 자동으로 발급합니다.
기존 이슈 수정: 수정할 이슈 키와 변경할 항목을 함께 적습니다.
4. 매니에게 이슈 작업 요청하기
요청에 포함하면 좋은 정보
연결 서비스: Linear, GitHub, Jira 중 어느 서비스에서 작업할지 지정합니다.
작업 유형: 조회, 생성, 수정, 댓글 중 원하는 작업을 먼저 말합니다.
대상: 기획 문서나 기능 항목, 기존 이슈 키, GitHub 저장소 등 작업 대상을 지정합니다.
변경 내용: 제목, 설명, 상태, 담당자, 우선순위, 라벨처럼 필요한 항목을 구체적으로 적습니다.
완료 기준: 생성할 이슈에 반드시 포함할 조건과 확인 결과를 함께 적습니다.
요청 예시
Linear 생성: “@기능명세서의 리마인드 알림 기능을 Linear 이슈로 만들어줘. 배경과 완료 조건도 포함해줘.”
GitHub 생성: “@PRD의 예약 취소 예외 조건을 연결한 웹앱 저장소의 GitHub 이슈로 만들어줘.”
Jira 조회: “Jira의 PROJECT-123 이슈를 요약하고 현재 기획서와 다른 점을 정리해줘.”
이슈 수정: “Linear의 ABC-123 우선순위를 높음으로 바꾸고, 변경 이유를 설명에 추가해줘.”
댓글 작성: “GitHub의 해당 이슈에 ‘재현 조건을 확인했습니다’라는 댓글을 남겨줘.”
요청을 하나의 작업 단위로 구체적으로 작성하면 승인 카드에서 대상과 변경 내용을 빠르게 확인할 수 있습니다.
5. 승인 카드 확인하고 반영하기
매니는 외부 이슈 트래커를 변경하기 전에 생성, 수정, 댓글 승인 카드를 보여줍니다. 승인 전에는 외부 서비스에 변경이 반영되지 않습니다.
승인 전에 확인할 항목
연결 서비스와 대상: 올바른 Linear 워크스페이스, Jira 사이트와 프로젝트 또는 GitHub 저장소인지 확인합니다.
이슈 제목과 본문: 기획 의도, 범위, 완료 조건이 정확하게 담겼는지 확인합니다.
속성: 상태, 담당자, 우선순위, 라벨 등 표시된 속성을 확인합니다.
댓글 내용: 외부 이슈에 등록할 문구를 확인합니다.
출처와 링크: 기획 항목과 이슈가 올바르게 연결됐는지 확인합니다.
승인하고 결과 확인하기
내용이 맞으면 카드 하단의 이슈 생성, 적용 등 작업에 맞는 실행 버튼을 누릅니다. 작업이 끝나면 완료 안내와 생성되거나 수정된 이슈의 링크를 확인합니다.
6. 연결 정보 관리하기
연결된 서비스 관리하기
Linear, Jira: 연결 관리에서 연결 계정과 상태를 확인하고 사용할 계정을 관리합니다.
GitHub: 연결된 카드의 저장소 수정에서 대상 저장소를 변경하거나 추가합니다.
연동 해제: 더 이상 사용하지 않는 연결은 연동 해제를 눌러 정리합니다.
GitHub 저장소 관리하기
등록한 저장소 범위는 저장소 수정에서 확인할 수 있습니다. 새로운 저장소를 추가할 때는 GitHub 토큰의 저장소 접근 범위에도 같은 저장소를 포함하고, Issues: Read and write 권한을 유지합니다.
토큰을 안전하게 관리하기
GitHub 토큰은 담당 계정에서 관리하고 필요한 저장소만 연결합니다. 담당자나 저장소 운영 범위가 바뀌면 GitHub에서 토큰 설정을 갱신하고 매니패스트의 연결 정보도 함께 정리합니다.
마지막 업데이트