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

​
사전 요구사항

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

​
설정

1

API 키 생성

Backlog에서 프로필 메뉴를 열고 Personal Settings → API로 이동합니다. 메모를 입력(예: cloudthinker)하고 Submit을 클릭하여 키를 생성한 후 복사합니다.
2

CloudThinker에서 연결 추가

Connections → Backlog로 이동하여 다음을 입력합니다:
  • Domain: Backlog의 전체 도메인, 예: <myorg>.backlog.com — 스페이스 키가 아닌 전체 호스트
  • API Key: 방금 생성한 키
Connect를 클릭합니다. CloudThinker가 자격 증명을 확인하고 Connected 상태를 표시합니다.
API 키를 생성할 때 복사하여 안전하게 보관하세요. 비밀번호처럼 취급하세요 — 키를 가진 사람은 누구든 발급 사용자의 스페이스 접근 권한을 갖게 됩니다.

​
연결 세부 정보

필드설명예시
BACKLOG_DOMAIN스페이스 키가 아닌 Backlog 스페이스의 전체 도메인<myorg>.backlog.com
BACKLOG_API_KEY연결 인증에 사용되는 스페이스 범위 API 키—

​
필요 권한

API 키는 발급한 사용자의 접근 권한을 상속합니다. 읽기 작업은 대상 프로젝트를 볼 수 있는 사용자의 키로 가능합니다. 생성, 수정, 삭제 작업에는 해당 사용자가 프로젝트에 쓰기 권한이 있어야 하며, CloudThinker에서 명시적인 승인도 필요합니다.
최소 권한 원칙을 따르세요: CloudThinker가 필요로 하는 프로젝트 접근 권한만 가진 사용자로 키를 발급하고, 가드레일을 제거하지 말고 쓰기 작업은 승인 게이트를 유지하세요.

​
에이전트 기능

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

​
연결 확인

@alex list my Backlog projects and show the open issues in one of them

​
예시 프롬프트

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

​
트러블슈팅

API 키가 없거나 만료되었거나 폐기되었습니다 — 또는 스페이스에서 API 접근이 활성화되어 있지 않습니다. Personal Settings → API에서 새 키를 발급하고, 스페이스가 API 접근을 허용하는지 확인한 후 다시 연결합니다.
BACKLOG_DOMAIN이 전체 도메인 대신 스페이스 키로 설정되어 있습니다. 예: <myorg>.backlog.com과 같이 완전한 호스트를 사용하고 다시 연결합니다.
키 사용자가 어떤 프로젝트의 멤버도 아니거나 예상하는 프로젝트에 대한 가시성이 없습니다. Backlog에서 해당 프로젝트에 사용자를 추가한 후 탐색을 다시 실행합니다.
키 사용자가 프로젝트에 쓰기 권한이 없습니다. 올바른 프로젝트 역할을 가진 사용자로 키를 재발급하고, 프롬프트가 표시되면 작업을 승인합니다.
매우 큰 응답은 답변을 집중적으로 유지하기 위해 트리밍됩니다. 단일 프로젝트, 마일스톤, 또는 상태로 요청 범위를 제한하거나, 먼저 개수를 요청한 후 세부 사항을 확인합니다.

​
보안

  • 최소 권한 — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
  • 기본 읽기 전용 — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
  • 자격증명 교체 — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
  • 오프보딩 시 취소 — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.
  • 최소 권한 사용자 — CloudThinker가 필요로 하는 프로젝트 접근 권한만 가진 사용자로 API 키를 발급합니다.
  • 올바른 도메인 — 스페이스 키가 아닌 전체 도메인(<myorg>.backlog.com)을 저장합니다.

​
관련 항목

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

Atlassian 연결

Jira 및 Confluence 이슈 추적 및 지식 베이스

승인

승인 게이트 작업 방식