프로젝트 관리
Jira를 자율 AI 에이전트에 연결하기
Jira에 연결된 Atako 에이전트는 토큰을 발급한 계정과 동일한 권한으로 워크플로 안에서 이슈를 검색하고, 생성하고, 진행시킬 수 있습니다.
가능한 워크플로우
신규 티켓 분류 및 우선순위 지정
지원 채널이나 폼으로 받은 신호를 바탕으로 에이전트는 적절한 유형과 우선순위로 이슈를 생성하고(create_issue), 업무 규칙에 따라 담당자를 배정하며(assign_issue), 받은 맥락을 댓글로 추가합니다(add_comment). 팀은 실제 작업을 시작하기 전에 티켓을 한 번 더 읽고 분류할 필요 없이 이미 정리된 티켓을 받게 됩니다.
스프린트 진행 상황 주간 리포트
에이전트는 JQL 쿼리로 현재 스프린트의 이슈를 조회하고(search_issues), 기록된 소요 시간을 가져오며(list_worklogs), 최근 변경 사항을 확인한 뒤(get_issue_changelog), 에픽이나 상위 티켓에 요약을 댓글로 게시합니다(add_comment). 별도의 상태 회의 없이도 매주 월요일 아침에 리포트를 받을 수 있으며, 막힌 티켓이 전체 스프린트 목록에 묻히지 않고 눈에 띄게 강조됩니다.
인시던트 관련 티켓 추적 및 종료
다른 채널을 통해 수정이 확인되면 에이전트는 사용 가능한 워크플로 전환을 확인하고(list_transitions), 티켓을 진행시키며(transition_issue), 원래 인시던트와 연결한 뒤(create_issue_link), 관련 watcher에게 알립니다. 티켓에는 전체 진행 과정이 온전히 남아, 흩어진 Slack 메시지나 각자의 기억에 의존해 사후에 시간순으로 재구성할 필요 없이 사후 분석 문서를 작성하는 데 유용합니다.
커넥터 작업
search_issues (읽기, JQL)
JQL 쿼리로 이슈를 검색합니다.
get_issue (읽기)
id나 키로 이슈를 가져옵니다.
get_issue_changelog (읽기)
이슈의 변경 이력을 가져옵니다.
list_worklogs (읽기)
이슈에 기록된 작업 시간을 조회합니다.
list_transitions (읽기)
이슈에서 사용 가능한 워크플로 전환을 조회합니다.
list_projects (읽기)
계정이 볼 수 있는 프로젝트 목록을 조회합니다.
create_issue (쓰기)
프로젝트에 이슈를 생성합니다.
update_issue (쓰기)
기존 이슈의 필드를 업데이트합니다.
transition_issue (쓰기)
이슈를 워크플로상에서 진행시킵니다.
add_comment (쓰기)
이슈에 댓글을 추가합니다.
assign_issue (쓰기)
이슈를 사용자에게 배정합니다.
add_worklog (쓰기)
이슈에 소요된 시간을 기록합니다.
create_issue_link (쓰기)
두 이슈를 서로 연결합니다(차단, 관련).
사전 요구 사항
- 대상 프로젝트에 browse, create, edit 권한이 있는 Jira 계정이 필요합니다(Jira 관리자 권한은 필수가 아닙니다).
- id.atlassian.com의 Security, API tokens에서 API 토큰을 생성해야 합니다.
- Jira 사이트 이름(yourcompany.atlassian.net의 yourcompany 부분)을 알아야 합니다.
- 인증을 위해 email:token 형식으로 식별자를 조합해야 합니다.
- Atako에서 에이전트에 grant를 부여하려면 연동 관리 권한이 필요합니다.
연결 방법
- 1
Atlassian API 토큰 생성
id.atlassian.com에서 Security, API tokens로 이동해 토큰을 생성하고 이름을 지정한 뒤 복사합니다.
- 2
연결 식별자 조합
Jira 계정 이메일과 API 토큰을 email:token 형식으로 결합합니다.
- 3
Atako에서 Jira 연결
설정, 연동에서 Jira 사이트 이름을 입력하고 식별자를 붙여넣습니다.
- 4
에이전트에 grant 부여
에이전트 페이지나 연결 화면에서 허용할 정확한 액션과 그 범위를 선택합니다.
자율 AI 에이전트를 Jira에 연결해야 하는 이유
Jira는 여전히 기술팀이 이슈를 추적하는 곳이지만, 이슈를 둘러싼 분류와 재촉, 리포팅 작업은 실제 개발 작업에 비해 지나치게 많은 시간을 소모합니다. 툴 콜링을 통해 Jira에 연결된 Atako 에이전트는 매주 열리는 상태 회의를 기다리지 않고 자체 환경에서 이 작업의 일부를 지속적으로 처리할 수 있습니다.
일반적인 웹훅이나 예약 스크립트와의 차이는 이렇습니다. 에이전트는 계속 작동하며 행동에 나서기 전에 상황을 해석합니다. 다른 채널(이메일, Slack)로부터 신호를 받으면 JQL 쿼리로 Jira를 조회해 맥락을 파악한 뒤, 부여받은 액션 범위에 따라 이슈를 생성할지, 댓글을 달지, 워크플로상에서 진행시킬지 판단합니다.
Atako 문서에 따르면 Jira 커넥터는 39개 액션(읽기 24개, 쓰기 15개)을 다루며, JQL 검색부터 작업 시간 추적까지 포함합니다. 제품 측면의 구체적인 활용 사례는 CI/CD 인시던트 분류입니다. 에이전트가 파이프라인 실패를 최근 커밋과 대조한 뒤 이미 문서화된 Jira 티켓을 엽니다.
한계와 모범 사례
Atlassian은 Jira Cloud API의 요청 속도 제한을 포인트 기반 모델로 전환하고 있으며, 각 요청은 복잡도에 따라 다른 비용을 소모하고, 시간당 한도 외에 초당 순간 최대치도 적용됩니다. 한 번에 많은 이슈를 조회하는 에이전트는 모든 것을 하나의 요청으로 불러오는 대신 호출을 페이지 단위로 나눠야 합니다.
API 토큰은 이를 생성한 Jira 계정의 권한을 엄격하게 물려받습니다. 해당 계정이 특정 프로젝트에 접근할 수 없다면, Atako 쪽에서 어떤 grant를 설정하든 에이전트도 그 프로젝트에 접근할 수 없습니다.
다른 모든 연동과 마찬가지로 연결 자체만으로는 아무 접근 권한도 주어지지 않습니다. 정확한 grant(에이전트, 액션, 범위)가 필요합니다. Jira 프로젝트에 에이전트를 연결하기 전에 권한 모델과 플랜을 참고하세요.
관련 사용 사례
관련 통합
자주 묻는 질문
에이전트가 Jira 티켓을 스스로 종료할 수 있나요?
가능합니다. transition_issue 액션이 쓰기 범위로 부여되어 있고 프로젝트 워크플로가 요청된 전환을 허용하는 경우입니다. 이 명시적인 grant가 없으면 에이전트는 이슈를 읽고 댓글을 달 수는 있지만 상태를 진행시킬 수는 없습니다.
에이전트를 연결하려면 Jira 관리자여야 하나요?
아닙니다. API 토큰은 이를 생성한 계정의 권한을 그대로 물려받습니다. 대상 프로젝트에 browse, create, edit 접근 권한이 있는 계정이면 충분하며, 전체 Jira 관리자 권한은 필요하지 않습니다.
에이전트의 Jira 접근 권한을 어떻게 철회하나요?
id.atlassian.com에서 API 토큰을 삭제하거나, Atako 쪽에서 연결을 철회하세요. 두 경우 모두 이 연결을 사용하던 모든 에이전트가 즉시 접근 권한을 잃습니다.
에이전트가 Jira 이슈를 영구적으로 삭제할 수 있나요?
delete_issue 액션은 연결된 하위 태스크 삭제를 포함해 커넥터에 존재하지만, 에이전트의 grant가 쓰기 범위로 이를 명시적으로 허용하는 경우에만 사용할 수 있습니다.
다음으로 읽을거리
출처
- Atlassian, Manage API tokens for your Atlassian account · 접속일 2026년 9월 4일
- Atlassian Developer, Rate limiting, Jira Cloud platform · 접속일 2026년 9월 4일
Atako CTO
이 콘텐츠는 Atako의 AI 에이전트가 작성한 후, Atako CTO인 Romain Laodicina가 검토, 수정 및 승인했습니다.