Jira 이슈를,
직접 고른 에이전트가 처리합니다
스프린트는 Jira에서 계획됩니다. 나에게 할당된 티켓이 명세, 스크린샷, 인수 조건과 함께 그곳에 있습니다. 필요한 것은 각각에 에이전트 하나가, 내 머신에서, 작업에 맞는 CLI로 일하는 것입니다.
AgentsRoom은 이 이슈들을 설명, 유형, 라벨, 첨부 파일과 함께 프로젝트의 백로그로 가져옵니다. 각 이슈는 티켓이 되고, 이를 Claude Code, Codex, GitHub Copilot CLI, Cursor 또는 다른 에이전트 CLI에 맡깁니다. 티켓 하나에 에이전트 하나입니다. 가져오기는 읽기만 합니다: Jira에는 아무것도 다시 쓰지 않습니다.
Jira 프로젝트 두 개, JQL 쿼리 하나, 티켓마다 에이전트 하나: 가져오기는 Jira를 읽기만 하고 절대 쓰지 않습니다.
많은 팀이 Jira에서 일을 계획합니다: 백로그, 스프린트, 오늘 아침 할당받은 이슈. 그리고 그 일은 점점 더 Claude Code, Codex 같은 에이전트 CLI에서 이루어집니다. 그 사이의 흔한 방법은 복사해 붙여넣기입니다: 요약을 프롬프트에 넣고, 이어서 설명을 넣고, 그 과정에서 스크린샷을 잃어버립니다.
Jira 가져오기가 그 단계를 대신합니다. Atlassian 이메일과 API 토큰으로 Jira Cloud 사이트를 연결하고, 프로젝트를 고르거나 JQL 쿼리를 쓰고, 이슈를 미리 본 뒤 가져옵니다. 이슈는 프로젝트 백로그의 TODO 열에 일반 티켓으로 들어오며, 설명은 Markdown으로 변환되고 첨부 파일은 내려받아져 있습니다. 그다음에는 다른 티켓과 똑같이 각 티켓에서 에이전트를 시작합니다.
양방향 동기화가 아닙니다. AgentsRoom은 Jira에 읽기 요청만 보냅니다: 상태 전환도, 댓글도, 필드 변경도 없습니다. 에이전트가 이슈에 댓글을 달거나 Done으로 옮기게 하고 싶다면, 그것은 Atlassian 자체의 MCP 서버가 하는 일이고, 아래에서 설명하듯 두 가지는 함께 동작합니다.
Jira 가져오기가 하는 일
Linear, GitHub Issues, Notion에 더해 백로그의 소스가 하나 더 늘었습니다.
프로젝트 하나 또는 직접 쓴 JQL
목록에서 프로젝트 하나를 고르면 쿼리가 자동으로 채워집니다. 프로젝트가 수십 개라면 검색란도 있습니다. 또는 JQL을 직접 쓰세요: assignee = currentUser(), 스프린트, 컴포넌트, 라벨. Jira가 검색할 수 있는 것이라면 가져오기도 가져올 수 있습니다.
이슈 하나를 키로
방금 맡은 이슈 하나만 필요한가요? TODO 열의 가져오기 버튼에 PROJ-123이나 Jira 링크를 붙여넣으세요. 저장된 가져오기는 건드리지 않고, 그 이슈만 열 맨 위에 들어옵니다.
읽기 쉬운 설명
Jira는 설명을 텍스트가 아니라 구조화된 문서로 저장합니다. 가져오기는 이를 Markdown(제목, 목록, 코드 블록, 표, 링크)으로 변환하므로, 에이전트는 원시 데이터가 아니라 작성된 그대로의 명세를 읽습니다.
에이전트가 열 수 있는 첨부 파일
이슈에 첨부된 파일은 Jira 로그인 뒤에 있어서, 링크만으로는 에이전트에게 쓸모가 없습니다. 가져오기는 이 파일들을 내 컴퓨터로 내려받아 티켓에 첨부합니다: 스크린샷, PDF 명세, 내보내기 파일.
의미가 통하는 유형과 상태
Bug, Story, Task, Epic: 잘 알려진 이슈 유형은 티켓 유형에 대응되고, Jira 유형도 태그로 남아 팀의 용어가 그대로 유지됩니다. 상태는 Jira가 워크플로 전체에서 공유하는 카테고리를 따르므로, Done 이슈는 완료 상태로 들어옵니다.
읽기 전용, 토큰은 내 머신에
Jira에는 읽기 요청만 도착합니다. API 토큰은 내 컴퓨터에 암호화되어 저장되고 우리 서버에는 절대 도착하지 않습니다. 다른 머신으로 프로젝트를 따라가는 것은 쿼리뿐이며, 그곳에서 토큰을 다시 붙여넣습니다.
동작 방식
네 단계입니다. 처음 두 단계는 머신마다 한 번만 합니다.
- 1
API 토큰 만들기
Atlassian 계정에서 Security를 열고 API tokens로 들어가 토큰을 만드세요. 클래식 토큰을 쓰세요: 범위가 지정된 토큰은 프로젝트 목록이 비어서 돌아올 수 있습니다.
- 2
Jira 사이트 연결하기
프로젝트의 백로그에서 티켓 가져오기를 클릭하고 JIRA를 고르세요. 사이트 주소(팀 이름만 써도 됨), Atlassian 이메일, 토큰을 입력합니다.
- 3
고르고 미리 보기
프로젝트를 고르거나 JQL 쿼리를 쓴 뒤 미리 보기를 클릭하세요. 키나 제목으로 목록을 검색하고, 원하는 이슈에 체크한 뒤 가져옵니다. 한 번에 최대 500개까지입니다.
- 4
티켓마다 에이전트에게 맡기기
이제 이슈는 TODO의 티켓이 되었고, 각각 Jira로 돌아가는 링크가 있습니다. 에이전트와 모델을 할당하고, 별도 브랜치에서 작업하게 하려면 이 작업을 위해 별도 워크트리에서 코딩에 체크한 뒤, 티켓을 In Progress로 드래그하세요. 나중에 다시 가져오기로 보드를 다시 맞출 수 있습니다.
Atlassian과 에이전트 CLI가 이미 자체적으로 하는 일
Atlassian에는 Jira와 Confluence용 공식 원격 MCP 서버가 있으며, 주소는 https://mcp.atlassian.com/v2/mcp이고 OAuth로 로그인합니다. Atlassian은 Claude Code용으로 claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp를 실행한 뒤 /mcp로 로그인하라고, Codex용으로 codex mcp add atlassian --url https://mcp.atlassian.com/v2/mcp를 실행하라고 안내합니다. 그러면 에이전트는 세션 안에서 이슈를 찾고, 읽고, 만들고, 수정하는 도구를 얻습니다.
Jira에서는 담당자 필드에서 작업 항목을 에이전트에게 할당할 수도 있습니다: Atlassian 자체의 Rovo 에이전트, 그리고 GitHub Copilot, Cursor처럼 다른 플랫폼에서 연결된 에이전트입니다. 에이전트는 그 항목을 처리하고 진행 상황을 그곳에 보고합니다. 실행되는 곳은 그 에이전트를 돌리는 플랫폼이지, 내 컴퓨터의 터미널이 아닙니다.
AgentsRoom 가져오기는 다른 필요에 답합니다: 나머지 티켓 옆에 이슈를 보드로 놓고, 이슈마다 에이전트 하나를 내 머신에서, 내가 고른 CLI로 돌리는 것입니다. Jira 통합이 전혀 없는 CLI도 포함됩니다. 둘은 서로 배타적이지 않습니다: 작업을 계획하고 실행하려면 이슈를 가져오고, 에이전트가 직접 자기 이슈에 댓글을 달거나 상태를 전환해야 할 때는 Atlassian의 MCP 서버를 주세요.
알아 둘 점
- Jira Cloud만 지원합니다. Jira Server와 Data Center는 지원하지 않습니다.
- 한 방향뿐입니다: 여기서 티켓이 완료된 뒤에도 Jira로는 아무것도 돌아가지 않습니다. 이슈 상태를 직접 전환하거나, 에이전트에게 Atlassian의 MCP 서버를 주세요.
- 토큰은 연결한 컴퓨터에 남습니다. 다른 머신에서는 그곳에도 토큰을 붙여넣을 때까지 보드 버튼에 다시 연결이 표시되고, JIRA 연결 안 됨 배지가 붙습니다.
- 가져오기 한 번에 이슈 최대 500개, 이슈 하나에 첨부 파일 최대 10개, 파일당 8 MB까지입니다.
- 우선순위, 담당자, 댓글, 컴포넌트, 버전, 에픽 링크, 스토리 포인트는 가져오지 않습니다: 티켓에는 요약, 설명, 유형, 라벨, 파일이 담깁니다.
- Jira 연결과 쿼리 작성은 데스크톱에서 합니다. 휴대폰에서는 가져오기를 다시 실행하거나 키로 이슈 하나를 가져올 수 있으며, 둘 다 내 컴퓨터에서 실행되므로 컴퓨터가 켜져 있어야 합니다.
자주 묻는 질문
Atlassian의 MCP 서버와 같은 건가요?
아닙니다. Atlassian의 MCP 서버는 MCP를 지원하는 CLI에서, 에이전트 하나에게 세션 안에서 Jira를 읽고 수정하는 도구를 줍니다. AgentsRoom 가져오기는 에이전트가 시작하기 전에 이슈를 프로젝트의 백로그로 가져오므로, 이슈를 계획하고, 각각 다른 에이전트에게 맡기고, 보드에서 추적할 수 있습니다. 둘 다 쓸 수 있습니다: 작업을 정리하는 데는 가져오기를, 자기 이슈에 댓글을 달거나 닫아야 하는 에이전트에게는 MCP 서버를.
에이전트가 끝나면 AgentsRoom이 Jira 이슈를 업데이트하나요?
아닙니다. 가져오기는 읽기 요청만 보냅니다: 상태 전환도, 댓글도, 필드 변경도 없습니다. 여기서 티켓이 완료되면 Jira에서 이슈를 직접 옮기거나, Atlassian의 MCP 서버를 통해 에이전트가 하게 하세요. 읽기 권한만 요청하기 때문에, 전환과 조건이 어떻든 가져오기는 어떤 워크플로에서도 동작합니다.
나에게 할당된 이슈만 가져올 수 있나요?
네, JQL로 가능합니다: assignee = currentUser() AND statusCategory != Done은 볼 수 있는 모든 프로젝트에서 내 미완료 이슈를 가져옵니다. project = ABC, 스프린트, 라벨을 더하면 범위를 좁힐 수 있습니다. 쿼리는 프로젝트와 함께 저장되므로, 나중에 다시 가져오기로 같은 쿼리를 다시 실행합니다.
방금 할당받은 이슈 하나만 가져올 수 있나요?
네. TODO 열의 가져오기 버튼을 쓰고 그 키(PROJ-123)나 Jira 링크를 붙여넣으세요. 저장된 가져오기는 바뀌지 않고 이슈가 TODO 맨 위에 들어오며, 나중에 티켓에서 그 이슈만 따로 다시 가져올 수 있습니다.
Jira API 토큰이 내 컴퓨터를 벗어나나요?
아닙니다. 토큰은 연결한 컴퓨터에 암호화되어 저장되고 우리 서버에는 절대 도착하지 않습니다. 계정에 저장되는 것은 가져오기 쿼리(사이트와 JQL)뿐이므로, 가져오기는 다른 머신으로 프로젝트를 따라가고, 그곳에서 토큰을 다시 붙여넣으면 됩니다.
가져온 Jira 이슈에서는 어떤 에이전트 CLI가 작업할 수 있나요?
AgentsRoom이 지원하는 에이전트 CLI 17개(Claude, Codex, GitHub Copilot CLI, Cursor 및 그 외 13개) 모두입니다. 가져온 이슈는 일반 티켓입니다: 할당한 에이전트와 모델로, 공유 체크아웃이나 자체 git 워크트리에서 실행됩니다.
Jira Server나 Data Center에서도 동작하나요?
현재는 아닙니다. 가져오기는 Atlassian API 토큰으로 Jira Cloud REST API와 통신하는데, Jira Server와 Data Center는 이를 같은 방식으로 제공하지 않습니다. 자체 호스팅 Jira 사용자도 자신의 설치를 지원하는 Jira MCP 서버를 에이전트에게 줄 수는 있습니다.
이런 것도 함께 보세요
티켓 가져오기
Jira, Linear, GitHub Issues, Notion 티켓을 하나의 백로그로 모으고, 하나씩 내 머신에서 Claude Code, Codex, Cursor 또는 모든 에이전트 CLI에 맡기세요. 읽기 전용.
Linear 가져오기
Linear 이슈를 AgentsRoom으로 가져와 하나씩 Claude Code, Codex 또는 다른 에이전트 CLI에 맡기세요. 여러 워크스페이스, 나에게 할당됨, 팀, 프로젝트, 상태. 읽기 전용.
작업 관리
드래그 앤 드롭으로 AI 에이전트를 지휘하는 시각적 칸반 보드. TODO에 작업을 만들고 In Progress로 끌어다 놓으면 Claude 에이전트가 자동으로 생성되며, Pending과 Done 칼럼으로 진행 상황을 추적하세요. 병렬 AI 코딩을 위한 백로그 기반 개발.
Git worktree
AI 에이전트나 티켓마다 바로 빌드할 수 있는 전용 git worktree를 주세요(의존성 설치, .env 복사 완료). 그런 다음 창 하나에서 리뷰하고, 커밋하고, 병합하세요.
MCP 서버
MCP 서버를 한 번 선언하면 Claude Code, Codex, 모든 에이전트 CLI에 전달됩니다. 공식 MCP 레지스트리에서 고르고, 키는 시크릿 관리자에 보관하고, Notion이나 Linear 같은 OAuth 서버에는 '연결' 버튼 하나로 로그인하세요.
Jira 이슈를 에이전트에게 맡기세요
AgentsRoom을 다운로드하고, 저장소를 프로젝트로 연 뒤, 백로그에서 티켓 가져오기를 클릭하고 JIRA를 고르세요.
컴패니언 앱: 이동 중에도 에이전트를 모니터링
Claude, Codex, Antigravity CLI 또는 다른 AI 공급자를 사용하세요.
버그와 요청을 공개 백로그로 바로 보내세요.