> For the complete documentation index, see [llms.txt](https://docs.manyfast.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.manyfast.io/use/jira-github-linear.md).
# Jira, GitHub, Linear 연동하기
매니패스트에서 Jira, GitHub, Linear을 연결하고 기획 내용을 이슈로 조회, 생성, 수정하는 방법을 안내합니다.
매니패스트에서는 프로젝트 채팅에서 **Linear, GitHub, Jira**의 이슈를 조회하거나, 기획 내용을 새로운 이슈로 만들고 수정과 댓글 작업을 요청할 수 있습니다.
외부 이슈 트래커에 실제 변경을 반영하기 전에는 승인 카드가 표시됩니다. 카드에서 대상과 변경 내용을 확인하고 실행 버튼을 누르면 이슈가 생성되거나 수정됩니다.
## 1. 이슈 트래커 연동으로 할 수 있는 일
#### **지원하는 작업**
* **이슈 조회 및 요약:** 이슈 키나 URL을 기준으로 제목, 본문, 상태 등 필요한 내용을 찾아 요약합니다.
* **이슈 생성:** PRD, 기능명세서, 유저플로우 등 프로젝트의 기획 내용을 바탕으로 새로운 이슈 초안을 만듭니다.
* **이슈 수정:** 기존 이슈의 제목, 설명, 상태, 담당자, 우선순위, 라벨 등의 변경을 요청합니다.
* **댓글 작성:** 기존 이슈에 남길 댓글을 작성하고 승인 후 등록합니다.
* **기획과 이슈 연결:** 기획 항목을 기준으로 이슈를 만들면 매니패스트 원문으로 돌아오는 출처 링크가 함께 추가됩니다.
#### **서비스별 주요 구성**
* **Linear:** 워크스페이스와 팀을 연결하고 이슈 키를 기준으로 작업합니다.
* **GitHub:** fine-grained 개인용 액세스 토큰과 대상 저장소를 등록해 작업합니다.
* **Jira:** Atlassian 계정과 Jira 사이트를 연결하고 프로젝트 키를 기준으로 작업합니다.
## 2. 이슈 트래커 연결 화면 열기
#### **AI와 연결에서 트래커 선택하기**
1. 이슈 작업에 사용할 **매니패스트 프로젝트**를 엽니다.
2. 프로젝트 화면에서 **AI와 연결**을 누릅니다.
3. **기획서에서 이슈/티켓 만들기** 항목을 선택합니다.
4. 연결할 서비스에서 **연결**을 누릅니다.
트래커 연결은 **AI와 연결** 화면 안에서 진행됩니다. 연결이 완료된 서비스에는 **연결됨** 상태와 연결된 계정 또는 저장소 정보가 표시됩니다.
#### **연결 상태 확인하기**
* **연결:** 서비스 인증 또는 토큰 등록을 시작합니다.
* **연결됨:** 매니가 해당 서비스의 이슈를 조회하고 작업할 수 있는 상태입니다.
* **연결 관리:** 연결된 계정과 저장소를 확인하고 연결 정보를 관리합니다.
## 3. 연결하기
### Linear 연결하기
#### **Linear 인증 진행하기**
1. 트래커 목록에서 **Linear**를 선택하고 **연결**을 누릅니다.
2. Linear 인증 화면에서 연결할 계정과 워크스페이스를 확인합니다.
3. 매니패스트가 요청하는 권한을 확인하고 연결을 승인합니다.
4. 매니패스트로 돌아오면 Linear가 **연결됨**으로 표시되는지 확인합니다.
5. 프로젝트 채팅에서 조회하거나 작업할 Linear 이슈를 요청합니다.
여러 Linear 워크스페이스를 사용한다면 인증 화면에 표시된 워크스페이스가 실제로 이슈를 관리할 곳인지 확인한 뒤 승인하세요.
#### **Linear 요청 시 확인할 정보**
* **팀 또는 프로젝트:** 새로운 이슈가 들어갈 조직과 업무 공간을 지정합니다.
* **이슈 식별자:** 기존 이슈를 조회하거나 수정할 때는 **영문 팀 키-숫자** 형식으로 입력합니다. 예: **ABC-123**
* **우선순위, 담당자, 라벨:** 필요한 속성을 요청하고 승인 카드에서 반영할 내용을 확인합니다.
* **출처 링크:** 기획 항목을 기준으로 생성한 이슈에서 매니패스트 원문을 함께 확인할 수 있습니다.
### GitHub 연결하기
GitHub는 **fine-grained 개인용 액세스 토큰**과 **대상 저장소**를 직접 등록해 연결합니다. 이슈 작업에 필요한 저장소와 권한만 선택해 안전하게 사용할 수 있습니다.
#### **토큰을 만들기 전에 확인하기**
* 이슈를 만들거나 수정할 GitHub 계정 또는 조직을 확인합니다.
* 연결할 저장소 목록을 준비합니다.
* 조직 저장소는 조직 정책에 따라 관리자 승인 절차를 거칠 수 있습니다.
* 토큰은 비밀번호처럼 관리하고 문서, 채팅, 스크린샷에 값을 남기지 않습니다.
#### **fine-grained 토큰 발급하기**
1. 매니패스트의 GitHub 연결 화면에서 **토큰 발급**을 누릅니다.
2. GitHub 토큰 설정에서 **Resource owner**를 선택합니다.
3. **Repository access**에서 **Only select repositories**를 선택하고 이슈 작업에 사용할 저장소를 지정합니다.
4. **Permissions → Repository permissions → Issues**를 **Read and write**로 설정합니다.
5. 설정을 확인하고 토큰을 발급합니다.
자세한 토큰 설정은 [GitHub 개인용 액세스 토큰 공식 문서](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)에서 확인할 수 있습니다.
#### **매니패스트에 저장소와 토큰 등록하기**
GitHub 토큰이 접근할 저장소 범위와 Issues 권한을 설정합니다.
매니패스트에 대상 저장소 주소와 발급한 토큰을 입력합니다.
#### 이미지에서 확인할 항목
* **1. 저장소 접근 범위:** GitHub 토큰이 접근할 저장소 범위를 선택합니다. 이슈 작업에 사용할 저장소만 포함하도록 범위를 설정합니다.
* **2. Issues 권한:** Permissions의 Repository permissions에서 Issues를 Read and write로 설정합니다.
* **3. 연결 정보 입력:** 매니패스트의 대상 저장소에 owner/repo를 입력하고, 액세스 토큰에 발급한 토큰을 입력한 뒤 연결합니다.
1. **대상 저장소**에 GitHub URL의 **owner/repo** 부분을 입력합니다.
2. 여러 저장소를 연결하려면 각 **owner/repo**를 쉼표로 구분합니다.
3. **액세스 토큰**에 발급받은 토큰을 붙여넣습니다.
4. **연결**을 누르고 연결된 계정과 저장소를 확인합니다.
5. 프로젝트 채팅에서 이슈를 만들 저장소를 지정해 요청합니다.
예를 들어 GitHub 주소가 **github.com/소유자/저장소**라면 **대상 저장소**에는 **소유자/저장소**만 입력합니다.
#### **조직 저장소 연결하기**
조직이 fine-grained 토큰 승인을 사용하는 경우 조직 관리자의 승인 절차를 진행합니다. 필요한 저장소와 **Issues: Read and write** 권한만 선택하면 이슈 관리 범위를 명확하게 유지할 수 있습니다.
### Jira 연결하기
#### **Jira 인증 진행하기**
1. 트래커 목록에서 **Jira**를 선택하고 **연결**을 누릅니다.
2. Atlassian 인증 화면에서 연결할 Jira 사이트를 확인합니다.
3. 요청 권한을 확인하고 **Accept** 버튼을 누릅니다.
4. 매니패스트로 돌아오면 Jira가 **연결됨**으로 표시되는지 확인합니다.
5. 프로젝트 채팅에서 조회하거나 작업할 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에서 토큰 설정을 갱신하고 매니패스트의 연결 정보도 함께 정리합니다.
