> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Backlog

> Nulab의 Backlog를 CloudThinker에 연결하여 이슈 추적, 마일스톤 계획, 위키, 풀 리퀘스트 컨텍스트를 활용합니다

Backlog 스페이스를 연결하면 CloudThinker 에이전트가 이슈를 추적하고, 마일스톤을 계획하며, 위키를 읽고, 코드 리뷰 중 티켓 컨텍스트를 가져올 수 있습니다. Backlog는 발급한 사용자의 프로젝트 접근 권한을 상속하는 **스페이스 범위 API 키**로 인증합니다.

***

## 사전 요구사항

* 작업하려는 프로젝트에 접근할 수 있는 **Backlog 스페이스**.
* 발급 사용자의 **Personal Settings → API** 탭에서 생성한 **스페이스 범위 API 키**.
* 생성/수정 작업을 위한 해당 **프로젝트 권한**을 가진 키 사용자.

<Info>
  읽기 전용 추적은 대상 프로젝트를 볼 수 있는 사용자의 키로 가능합니다. 이슈, 위키, 풀 리퀘스트 생성 또는 수정에는 해당 사용자가 프로젝트에 쓰기 권한이 있어야 합니다. 스페이스에서 API 접근을 제한하는 경우, 키를 발급받기 전에 스페이스 관리자가 이를 활성화해야 합니다.
</Info>

***

## 설정

<Steps>
  <Step title="API 키 생성">
    Backlog에서 프로필 메뉴를 열고 **Personal Settings → API**로 이동합니다. 메모를 입력(예: `cloudthinker`)하고 **Submit**을 클릭하여 키를 생성한 후 복사합니다.
  </Step>

  <Step title="CloudThinker에서 연결 추가">
    **Connections → Backlog**로 이동하여 다음을 입력합니다:

    * **Domain**: Backlog의 전체 도메인, 예: `<myorg>.backlog.com` — 스페이스 키가 아닌 전체 호스트
    * **API Key**: 방금 생성한 키

    **Connect**를 클릭합니다. CloudThinker가 자격 증명을 확인하고 **Connected** 상태를 표시합니다.
  </Step>
</Steps>

<Warning>
  API 키를 생성할 때 복사하여 안전하게 보관하세요. 비밀번호처럼 취급하세요 — 키를 가진 사람은 누구든 발급 사용자의 스페이스 접근 권한을 갖게 됩니다.
</Warning>

***

## 연결 세부 정보

| 필드                    | 설명                              | 예시                    |
| --------------------- | ------------------------------- | --------------------- |
| **BACKLOG\_DOMAIN**   | 스페이스 키가 아닌 Backlog 스페이스의 전체 도메인 | `<myorg>.backlog.com` |
| **BACKLOG\_API\_KEY** | 연결 인증에 사용되는 스페이스 범위 API 키       | —                     |

***

## 필요 권한

API 키는 발급한 사용자의 접근 권한을 상속합니다. 읽기 작업은 대상 프로젝트를 볼 수 있는 사용자의 키로 가능합니다. 생성, 수정, 삭제 작업에는 해당 사용자가 프로젝트에 **쓰기 권한**이 있어야 하며, CloudThinker에서 명시적인 [승인](/ko/guide/approval)도 필요합니다.

<Tip>
  최소 권한 원칙을 따르세요: CloudThinker가 필요로 하는 프로젝트 접근 권한만 가진 사용자로 키를 발급하고, 가드레일을 제거하지 말고 쓰기 작업은 승인 게이트를 유지하세요.
</Tip>

***

## 에이전트 기능

연결 후 에이전트는 Backlog 프로젝트, 이슈, 위키, 레포지토리에 대한 읽기 접근과 승인 게이트 쓰기 작업을 수행할 수 있습니다.

| 기능                 | 설명                                                                  |
| ------------------ | ------------------------------------------------------------------- |
| **프로젝트 및 스페이스 탐색** | 프로젝트, 카테고리, 커스텀 필드, 우선순위, 최근 스페이스 활동 목록 조회                          |
| **이슈 추적**          | 이슈 검색, 읽기, 집계; 이슈 생성 및 수정, 상태 변경, 댓글 추가 — **쓰기 시 승인 필요**            |
| **마일스톤 및 릴리즈**     | 마일스톤/버전 목록 조회 및 릴리즈 계획; 생성 또는 수정 — **쓰기 시 승인 필요**                   |
| **위키 및 문서**        | 프로젝트 위키 및 문서 읽기; 위키 페이지 생성 또는 수정 — **쓰기 시 승인 필요**                   |
| **Git 및 풀 리퀘스트**   | 레포지토리 및 풀 리퀘스트 검사, 코드 리뷰 중 티켓 컨텍스트 가져오기, PR에 댓글 달기 — **쓰기 시 승인 필요** |

### 연결 확인

```text theme={null}
@alex list my Backlog projects and show the open issues in one of them
```

### 예시 프롬프트

```text theme={null}
@alex summarize the open Backlog issues for the PLATFORM project and #report anything overdue
@alex this PR references PROJ-123 — pull the Backlog ticket and #recommend whether the change matches it
@alex list the milestones for my main project and their completion status
```

<Note>
  프로젝트가 많은 스페이스의 경우, 에이전트가 집중된 결과를 반환할 수 있도록 단일 프로젝트 또는 마일스톤으로 요청 범위를 제한하세요.
</Note>

***

## 트러블슈팅

<Accordion title="401 Unauthorized">
  API 키가 없거나 만료되었거나 폐기되었습니다 — 또는 스페이스에서 API 접근이 활성화되어 있지 않습니다. **Personal Settings → API**에서 새 키를 발급하고, 스페이스가 API 접근을 허용하는지 확인한 후 다시 연결합니다.
</Accordion>

<Accordion title="요청이 404를 반환하거나 잘못된 스페이스">
  **BACKLOG\_DOMAIN**이 전체 도메인 대신 스페이스 키로 설정되어 있습니다. 예: `<myorg>.backlog.com`과 같이 완전한 호스트를 사용하고 다시 연결합니다.
</Accordion>

<Accordion title="연결은 되지만 프로젝트나 이슈가 표시되지 않음">
  키 사용자가 어떤 프로젝트의 멤버도 아니거나 예상하는 프로젝트에 대한 가시성이 없습니다. Backlog에서 해당 프로젝트에 사용자를 추가한 후 탐색을 다시 실행합니다.
</Accordion>

<Accordion title="생성 또는 수정 작업이 권한 오류로 실패">
  키 사용자가 프로젝트에 쓰기 권한이 없습니다. 올바른 프로젝트 역할을 가진 사용자로 키를 재발급하고, 프롬프트가 표시되면 작업을 승인합니다.
</Accordion>

<Accordion title="대형 프로젝트에서 결과가 잘림">
  매우 큰 응답은 답변을 집중적으로 유지하기 위해 트리밍됩니다. 단일 프로젝트, 마일스톤, 또는 상태로 요청 범위를 제한하거나, 먼저 개수를 요청한 후 세부 사항을 확인합니다.
</Accordion>

***

## 보안

* **최소 권한** — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
* **기본 읽기 전용** — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
* **자격증명 교체** — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
* **오프보딩 시 취소** — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.

- **최소 권한 사용자** — CloudThinker가 필요로 하는 프로젝트 접근 권한만 가진 사용자로 API 키를 발급합니다.
- **올바른 도메인** — 스페이스 키가 아닌 전체 도메인(`<myorg>.backlog.com`)을 저장합니다.

***

## 관련 항목

<CardGroup cols={2}>
  <Card title="Atlassian 연결" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/atlassian.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=64fcf0381646a233832602a9086a14eb" href="/ko/guide/connections/atlassian" width="24" height="24" data-path="images/icons/atlassian.svg">
    Jira 및 Confluence 이슈 추적 및 지식 베이스
  </Card>

  <Card title="승인" icon="shield-check" href="/ko/guide/approval">
    승인 게이트 작업 방식
  </Card>
</CardGroup>