# 이슈 트래커 연결하기

> Linear, GitHub, Jira, monday.com을 연결하고 채팅에서 기획서 항목을 이슈로 만들어요.

이슈 트래커를 연결하면 기획서의 요구사항이나 기능을 채팅에서 바로 이슈로 만들 수 있어요. AI가 이슈 초안을 쓰고, 내가 승인 카드에서 확인한 뒤에만 트래커에 만들어져요. Linear, GitHub, Jira, monday.com을 연결할 수 있어요.

> [!IMPORTANT]
> 이슈 트래커 연결은 Pro와 Team 요금제에서 쓸 수 있어요. 연결은 내 계정에 적용되고, 내가 속한 그룹 가운데 하나라도 Pro 또는 Team이면 쓸 수 있어요. 그렇지 않으면 목록의 트래커 옆에 **Pro** 표시가 붙고, 트래커를 고르면 **Pro 플랜부터 쓸 수 있어요** 안내가 보여요. [요금제 비교](https://manyfast.io/docs/account/plans)를 참고해요.

## 연결 화면 열기

1. 사이드바에서 **커넥터**를 눌러요. 에디터에서는 왼쪽 레일의 **커넥터**를 눌러도 돼요.
2. **프로젝트 관리** 탭을 골라요.
3. 연결할 트래커를 골라요. 오른쪽에 연결 상태(GitHub는 저장소와 토큰 입력 칸)와 **연결** 버튼, **연결 후 사용 방법**이 나와요.

![커넥터 화면의 프로젝트 관리 탭. Linear, GitHub, Jira, monday.com이 목록에 있다.](https://manyfast.io/content-assets/connectors.issue-trackers-DSejoKjO.webp)

연결한 트래커에는 **연결됨**이 표시돼요.

## Linear 연결하기

1. Linear를 고르고 **연결**을 눌러요.
2. Linear에 로그인한 뒤 접근 권한을 허용해요.
3. 매니패스트로 돌아오면 **연결됨**과 연결된 계정이 보여요.

## GitHub 연결하기

GitHub는 등록한 저장소에 이슈를 만들 때만 써요. 저장소의 코드는 읽지 않아요. GitHub는 로그인 대신 직접 만든 토큰으로 연결해요.

1. GitHub를 고르고 **토큰 발급하기**를 눌러 GitHub의 새 토큰 화면을 열어요. **토큰 설정 방법**을 누르면 아래 순서를 화면에서도 볼 수 있어요.
2. **Resource owner**에서 저장소를 가진 개인 계정이나 조직을 골라요.
3. **Repository access**에서 **Only select repositories**를 고르고, 이슈를 만들 저장소를 골라요.
4. **Permissions** > **Repository permissions** > **Issues**를 **Read and write**로 바꿔요.
5. 페이지 아래의 **Generate token**을 눌러 토큰을 만들고 복사해요.
6. 매니패스트로 돌아와 **대상 저장소**에 저장소 주소(예: `https://github.com/acme/web`)를 붙여 넣어요. 여러 개는 쉼표로 구분하고, 최대 20개까지 등록할 수 있어요.
7. **액세스 토큰**에 복사한 토큰을 붙여 넣고 **연결**을 눌러요.

> [!WARNING]
> 공개 저장소에 만든 이슈는 인터넷의 누구나 볼 수 있어요. 등록한 저장소 가운데 공개 저장소가 있으면 연결 화면에 안내가 보여요.

- 조직 저장소는 조직 소유자의 승인이 필요할 수 있어요.
- 접근할 수 없는 저장소는 등록되지 않고, 어떤 저장소가 빠졌는지 화면에 보여요. 저장소 이름과 토큰의 **Repository access** 선택을 확인해요.
- 연결한 뒤 저장소 목록만 바꾸려면 **저장소 수정**을 눌러요. 토큰은 그대로 두고 목록만 바뀌어요. 목록에 없는 저장소에는 AI가 이슈를 만들 수 없어요.

## Jira 연결하기

1. Jira를 고르고 **연결**을 눌러요.
2. Atlassian 계정으로 로그인하고 권한을 허용해요. Atlassian 권한 화면에 앱 검토 관련 안내가 보일 수 있어요.
3. 매니패스트로 돌아오면 **연결됨**이 보여요.
4. 여러 Jira 사이트에 소속돼 있으면 첫 번째 사이트가 자동으로 연결돼요. 다른 사이트를 쓰려면 **이슈를 만들 사이트**에서 고르고 **저장**을 눌러요.

매니패스트는 Jira 이슈 읽기·쓰기, 담당자 지정에 쓰는 사용자 조회, 연결을 유지하는 오프라인 접근 권한을 요청하고, 토큰은 암호화해 내 계정에만 저장해요.

## monday.com 연결하기

monday.com은 우리 팀 monday 계정에 Manyfast 앱이 설치돼 있어야 연결할 수 있어요. 설치는 계정마다 한 번이면 되고, monday 관리자만 할 수 있어요.

1. monday.com을 고르고 먼저 **연결**을 눌러요.
2. 앱이 설치되지 않았다며 막히면 **앱 설치**를 눌러요. monday 설치 화면이 새 탭에서 열려요.
3. 설치를 마친 뒤 매니패스트로 돌아와 다시 **연결**을 눌러요.

> [!NOTE]
> monday 관리자가 아니면 설치 화면에서 더 진행되지 않아요. 관리자에게 **앱 설치**를 한 번만 눌러 달라고 부탁하세요. 그다음부터는 팀원이 각자 연결할 수 있어요.

- 아이템은 내가 고른 보드와 그룹에 만들어지고, 상태는 그 보드에 이미 있는 라벨만 쓸 수 있어요.
- 보드가 팀 전체에 공개돼 있는지, 게스트와 공유 중인지는 매니패스트에서 알 수 없어요. 밖에 보이면 안 되는 내용이라면 monday에서 보드의 공개 범위를 먼저 확인해요.

## 채팅에서 이슈 만들기

1. 에디터의 [채팅](https://manyfast.io/docs/ai/chat)에서 이슈로 만들 기획서 항목을 고르고 "Linear 이슈로 만들어줘"처럼 트래커 이름을 넣어 요청해요.
2. AI가 이슈 초안을 담은 승인 카드를 보여 줘요. 초안 내용을 확인해요. GitHub는 등록한 저장소 가운데 하나를, Jira는 프로젝트 키를, monday.com은 보드와 그룹을 함께 확인해요.
3. **이슈 생성**을 누르면 트래커에 이슈가 만들어지고, 만들어진 이슈 링크가 카드에 보여요. 만들지 않으려면 **거절**을 눌러요.

> [!WARNING]
> 승인하면 내 트래커 계정 이름으로 이슈가 만들어지고, 지우려면 그 트래커에서 직접 지워야 해요. GitHub 이슈는 보통 지울 수 없고 닫기만 할 수 있어요.

이미 있는 이슈를 찾아 읽거나, 이슈 수정이나 코멘트를 요청할 수도 있어요. 수정과 코멘트도 승인 카드에서 확인한 뒤에 반영돼요.

## 연결 관리하기

- **연동 해제**를 누르면 확인 창이 열려요. 해제하면 채팅에서 이슈를 만들거나 고칠 수 없어요.
- GitHub 연동을 해제하면 저장된 토큰이 지워져요. 다시 연결하려면 토큰을 새로 만들어야 해요.
- Linear, Jira, monday.com은 다시 연결할 때 동의 화면을 한 번 더 거쳐요.
- 인증이 만료되거나 취소되면 **다시 연결해주세요**가 보여요. **다시 연결**을 눌러 다시 로그인해요. GitHub는 새 토큰을 만들어 다시 입력해요.

## 다음 단계

- [AI와 채팅하기](https://manyfast.io/docs/ai/chat)
- [AI 도구 연결하기 (MCP)](https://manyfast.io/docs/connect/mcp)
- [요금제 비교](https://manyfast.io/docs/account/plans)

원문: https://manyfast.io/docs/connect/issue-trackers
