YouTrack 가져오기

YouTrack 이슈를,
직접 고른 에이전트가 처리합니다

스프린트는 YouTrack에 있습니다. 나에게 할당된 버그와 작업이 설명, 사용자 지정 필드, 스크린샷과 함께 그곳에 있습니다. 필요한 것은 각각에 에이전트 하나가, 내 머신에서, 작업에 맞는 CLI로 일하는 것입니다.

AgentsRoom은 이 이슈들을 설명, 채워진 사용자 지정 필드, 첨부 파일과 함께 프로젝트의 백로그로 가져옵니다. 각 이슈는 티켓이 되고, 이를 Claude Code, Codex, GitHub Copilot CLI, Cursor 또는 다른 에이전트 CLI에 맡깁니다. 티켓 하나에 에이전트 하나입니다. 가져오기는 읽기만 합니다: YouTrack에는 아무것도 다시 쓰지 않습니다.

AgentsRoom 다운로드무료어떻게 동작하는지 보기

YouTrack에서 에이전트로

YouTrack 프로젝트

WEB

APP

#Unresolved for: me

백로그 · TODO

WEB-412Claude Code

WEB-415Codex

APP-88Cursor

읽기 전용: 아무것도 다시 쓰지 않음

YouTrack 프로젝트 두 개, 검색 하나, 티켓마다 에이전트 하나: 가져오기는 YouTrack을 읽기만 하고 절대 쓰지 않습니다.

많은 팀이 YouTrack에서 일을 계획합니다: 애자일 보드, 스프린트, 오늘 아침 들어온 버그. 그리고 그 일은 점점 더 Claude Code, Codex 같은 에이전트 CLI에서 이루어집니다. 그 사이의 흔한 방법은 복사해 붙여넣기입니다: 제목을 프롬프트에 넣고, 이어서 설명을 넣고, 그 과정에서 스크린샷을 잃어버립니다.

YouTrack 가져오기가 그 단계를 대신합니다. Cloud든 자체 호스팅이든 영구 토큰으로 YouTrack을 연결하고, 프로젝트를 고르거나 어떤 YouTrack 검색이든 입력하고, 이슈를 미리 본 뒤 가져옵니다. 이슈는 프로젝트 백로그의 TODO 열에 일반 티켓으로 들어오며, 설명, 채워진 사용자 지정 필드, 첨부 파일이 함께 있습니다. 그다음에는 다른 티켓과 똑같이 각 티켓에서 에이전트를 시작합니다.

양방향 동기화가 아닙니다. AgentsRoom은 YouTrack에 읽기 요청만 보냅니다: 상태 변경도, 댓글도, 필드 업데이트도 없습니다. 에이전트가 이슈에 댓글을 달거나 해결하게 하고 싶다면, 그것은 YouTrack 자체의 MCP 서버가 하는 일이고, 아래에서 설명하듯 두 가지는 함께 동작합니다.

YouTrack 가져오기가 하는 일

Jira, Linear, GitHub Issues, GitLab Issues, Azure DevOps, Notion에 더해 백로그의 소스가 하나 더 늘었습니다.

프로젝트 또는 어떤 YouTrack 검색이든

목록에서 프로젝트 하나를 고르면(수십 개일 때는 검색란도 있습니다) 검색이 자동으로 작성됩니다: project: ABC #Unresolved. 또는 애자일 보드나 스프린트 필터를 포함해 YouTrack에서 쓰는 검색이라면 무엇이든 입력하고, for: me를 추가해 내 이슈만 남기세요.

이슈 하나를 ID로

방금 받은 버그 하나만 필요한가요? TODO 열의 가져오기 버튼에 ABC-123 또는 이슈 링크를 붙여넣으세요. 그 이슈만 열 맨 위에 들어오고, 저장된 가져오기는 건드리지 않습니다.

설명과 사용자 지정 필드 포함

가져오기는 이슈의 Markdown 설명을 그대로 두고, 팀이 채운 사용자 지정 필드를 최대 여덟 개까지 담은 짧은 컨텍스트 블록을 더합니다: 우선순위, 상태, 담당자, 하위 시스템, 추정치 또는 직접 만든 필드. 에이전트는 팀이 쓴 그대로의 이슈를 읽습니다.

에이전트가 열 수 있는 첨부 파일

이슈에 첨부된 파일은 YouTrack 로그인 뒤에 있으므로, 링크만으로는 에이전트에게 쓸모가 없습니다. 가져오기는 연결한 인스턴스에서만 이 파일들을 내 컴퓨터로 내려받아 티켓에 첨부합니다. 이슈 하나에 최대 10개, 각각 8 MB까지입니다.

말이 되는 유형과 상태

Type 필드가 티켓 유형을 정합니다: Bug, Cosmetics, Exception, Usability Problem은 버그가 되고, Performance Problem은 성능 티켓이, Feature와 Meta Issue는 기능이 되며, 유형은 태그로 남습니다. 완료 여부는 YouTrack의 해결됨 플래그로 판단하므로, 프로젝트의 어떤 해결 상태에 있는 이슈든 상태 이름과 상관없이 완료 상태로 들어옵니다.

읽기 전용, 토큰은 내 머신에

가져오기는 읽기 요청만 보냅니다. 영구 토큰은 인스턴스 주소와 함께 내 컴퓨터에 암호화되어 저장되고, 우리 서버에는 절대 도착하지 않습니다.

동작 방식

네 단계입니다. 처음 두 단계는 머신마다 한 번만 합니다.

1
영구 토큰 만들기
YouTrack에서 프로필을 열고 Account Security로 들어가, YouTrack 범위로 영구 토큰을 만드세요. 토큰은 perm:으로 시작합니다.
2
YouTrack 연결하기
프로젝트의 백로그에서 티켓 가져오기를 클릭하고 YouTrack을 고르세요. YouTrack을 열 때 쓰는 주소(yourteam.youtrack.cloud 또는 자체 서버. 이슈나 보드 링크를 붙여넣어도 됨)와 토큰을 입력합니다.
3
고르고 미리 보기
프로젝트를 고르거나 검색을 입력한 뒤 미리 보기를 클릭하세요. ID나 제목으로 목록을 검색하고, 원하는 이슈에 체크한 뒤 가져옵니다. 한 번에 최대 500개까지입니다.
4
티켓마다 에이전트에게 맡기기
이제 이슈는 TODO의 티켓이 되었고, 각각 YouTrack으로 돌아가는 링크가 있습니다. 에이전트와 모델을 할당하고, 별도 브랜치에서 작업하게 하려면 이 작업을 위해 별도 워크트리에서 코딩에 체크한 뒤, 티켓을 '개발'로 드래그하세요. 나중에 다시 가져오기로 보드를 다시 맞출 수 있습니다.

JetBrains와 에이전트 CLI가 이미 자체적으로 하는 일

YouTrack에는 자체 MCP 서버가 있으며, JetBrains가 2025년 10월에 발표했습니다. 인스턴스 주소 뒤에 /mcp를 붙인 곳(YouTrack Cloud에서는 https://yourteam.youtrack.cloud/mcp)에서 응답하고, 영구 토큰 또는 OAuth를 받습니다. Claude Code용으로 JetBrains 문서는 claude mcp add --header "Authorization: Bearer <token>" --transport http youtrack 뒤에 그 주소를 붙이는 방법을 안내합니다. HTTP로 MCP를 지원하는 에이전트 CLI라면 같은 방식으로 연결할 수 있습니다.

이 서버의 도구는 이슈와 문서를 검색하고, 만들고 수정하며, 댓글과 첨부 파일을 추가하고, 태그와 링크를 관리하고, 작업 시간을 기록합니다. 권한은 토큰 뒤에 있는 계정의 권한을 따릅니다. JetBrains는 데이터를 바꾸는 도구 호출을 모두 검토하라고 권하며, 주소에 readOnlyTools=true를 추가하면 읽는 도구만 남습니다.

AgentsRoom 가져오기는 다른 필요에 답합니다: 나머지 티켓 옆에 이슈를 보드로 놓고, 이슈마다 에이전트 하나를 내 머신에서, 내가 고른 CLI로 돌리는 것입니다. 어떤 에이전트에게도 YouTrack 쓰기 권한을 주지 않습니다. 둘은 서로 배타적이지 않습니다: 작업을 계획하고 실행하려면 이슈를 가져오고, 에이전트가 직접 자기 이슈에 댓글을 달거나 해결해야 할 때는 YouTrack의 MCP 서버를 주세요.

알아 둘 점

컴퓨터 한 대에 YouTrack 인스턴스 하나입니다(Cloud 또는 자체 호스팅). 두 번째 인스턴스에서 가져오려면 첫 번째 대신 그 인스턴스를 연결하세요.
한 방향뿐입니다: 티켓이 여기서 완료되어도 YouTrack으로는 아무것도 돌아가지 않습니다. 이슈는 직접 해결하거나, 에이전트에게 YouTrack의 MCP 서버를 주세요.
토큰은 연결한 컴퓨터에 남습니다. 다른 머신에서는 그곳에서 가져오기를 다시 실행하기 전에 YouTrack을 다시 연결합니다.
가져오기 한 번에 이슈 최대 500개, 이슈 하나에 8 MB짜리 첨부 파일 최대 10개까지입니다.
댓글, 이슈 간 링크, 기록은 가져오지 않습니다: 티켓에는 제목, 설명, 사용자 지정 필드 블록, 유형 태그, 파일이 담깁니다.
YouTrack 연결과 검색 작성은 데스크톱에서 합니다. 휴대폰에서는 가져오기를 다시 실행하거나 ID로 이슈 하나를 가져올 수 있으며, 둘 다 내 컴퓨터에서 실행되므로 컴퓨터가 켜져 있어야 합니다.

자주 묻는 질문

다른 질문하기

YouTrack MCP 서버와 같은 건가요?

아닙니다. YouTrack MCP 서버는 에이전트 하나에게 세션 안에서 YouTrack을 읽고 수정하는 도구를 줍니다. AgentsRoom 가져오기는 에이전트가 시작하기 전에 이슈를 프로젝트의 백로그로 가져오므로, 이슈를 계획하고, 각각 다른 에이전트에게 맡기고, 보드에서 추적할 수 있습니다. 둘 다 쓸 수 있습니다: 작업을 정리하는 데는 가져오기를, 자기 이슈에 댓글을 달거나 해결해야 하는 에이전트에게는 MCP 서버를.

Claude Code가 YouTrack을 쓸 수 있나요?

네, 두 가지 방법이 있습니다. 세션 안에서는 JetBrains 문서에 나온 대로 claude mcp add --header "Authorization: Bearer <token>" --transport http youtrack 뒤에 인스턴스 주소와 /mcp를 붙여 YouTrack MCP 서버를 추가하세요. 그러면 에이전트가 직접 이슈를 검색하고, 읽고, 업데이트할 수 있습니다. 세션 전에는 이슈를 AgentsRoom으로 가져와 하나씩 Claude Code 에이전트에게 맡기세요. 설명, 사용자 지정 필드, 파일이 작업과 함께 에이전트에게 전달됩니다.

에이전트가 끝나면 AgentsRoom이 이슈를 업데이트하나요?

아닙니다. 가져오기는 읽기 요청만 보냅니다: 상태 변경도, 댓글도, 필드 업데이트도 없습니다. 티켓이 여기서 완료되면, YouTrack의 이슈는 직접 해결하거나 YouTrack MCP 서버를 통해 에이전트가 하게 하세요.

내 이슈만, 또는 현재 스프린트만 가져올 수 있나요?

네, 검색으로 가능합니다: for: me를 추가하면 나에게 할당된 이슈만 남고, YouTrack에서처럼 보드나 스프린트 필터를 쓸 수 있습니다. 검색은 프로젝트와 함께 저장되므로, 나중에 다시 가져오기로 다시 실행할 수 있습니다.

방금 할당받은 이슈 하나만 가져올 수 있나요?

네. TODO 열의 가져오기 버튼을 쓰고 그 ID(ABC-123)나 링크를 붙여넣으세요. 저장된 가져오기를 바꾸지 않고 TODO 맨 위에 들어오며, 나중에 티켓에서 따로 새로 고칠 수 있습니다.

내 YouTrack 토큰이 내 컴퓨터를 벗어나나요?

아닙니다. 토큰은 인스턴스 주소와 함께 연결한 컴퓨터에 암호화되어 저장되고, 우리 서버에는 절대 도착하지 않습니다. 첨부 파일은 연결한 인스턴스에서만 내려받으므로, 토큰이 다른 호스트로 보내지는 일은 없습니다.

자체 호스팅 YouTrack에서도 되나요?

네. youtrack.cloud 주소 대신 내 서버의 주소를 입력하고, 그 서버에서 만든 영구 토큰을 쓰세요. YouTrack Cloud 주소도 되며, 예전 myjetbrains.com/youtrack 주소도 포함됩니다.

가져온 이슈에서는 어떤 에이전트 CLI가 작업할 수 있나요?

AgentsRoom이 지원하는 에이전트 CLI 19개(Claude, Codex, GitHub Copilot CLI, Cursor 및 그 외 15개) 모두입니다. 가져온 이슈는 일반 티켓입니다: 할당한 에이전트와 모델로, 공유 체크아웃이나 자체 git 워크트리에서 실행됩니다.

이런 것도 함께 보세요

티켓 가져오기

Jira, Linear, GitHub Issues, GitLab Issues, Azure DevOps, YouTrack, Notion 티켓을 하나의 백로그로 모으고, 하나씩 내 머신에서 Claude Code, Codex, Cursor 또는 모든 에이전트 CLI에 맡기세요. 읽기 전용.