Azure DevOps 작업 항목을,
직접 고른 에이전트가 처리합니다
스프린트는 Azure Boards에 있습니다. 나에게 할당된 사용자 스토리와 버그가 재현 단계, 인수 조건, 스크린샷과 함께 그곳에 있습니다. 필요한 것은 각각에 에이전트 하나가, 내 머신에서, 작업에 맞는 CLI로 일하는 것입니다.
AgentsRoom은 이 작업 항목들을 설명, 재현 단계, 인수 조건, 첨부 파일과 함께 프로젝트의 백로그로 가져옵니다. 각 작업 항목은 티켓이 되고, 이를 Claude Code, Codex, GitHub Copilot CLI, Cursor 또는 다른 에이전트 CLI에 맡깁니다. 티켓 하나에 에이전트 하나입니다. 가져오기는 읽기만 합니다: Azure DevOps에는 아무것도 다시 쓰지 않습니다.
Azure DevOps 프로젝트 두 개, WIQL 쿼리 하나, 티켓마다 에이전트 하나: 가져오기는 Azure DevOps를 읽기만 하고 절대 쓰지 않습니다.
Microsoft 스택을 쓰는 많은 팀이 Azure Boards에서 일을 계획합니다: 백로그, 스프린트, 오늘 아침 들어온 버그. 그리고 그 일은 점점 더 Claude Code, Codex 같은 에이전트 CLI에서 이루어집니다. 그 사이의 흔한 방법은 복사해 붙여넣기입니다: 제목을 프롬프트에 넣고, 이어서 재현 단계를 넣고, 그 과정에서 스크린샷을 잃어버립니다.
Azure DevOps 가져오기가 그 단계를 대신합니다. 개인 액세스 토큰으로 조직을 연결하고, 프로젝트를 고르거나 WIQL 쿼리를 쓰고, 작업 항목을 미리 본 뒤 가져옵니다. 작업 항목은 프로젝트 백로그의 TODO 열에 일반 티켓으로 들어오며, 설명, 재현 단계, 인수 조건은 Markdown으로 변환되고 첨부 파일은 내려받아져 있습니다. 그다음에는 다른 티켓과 똑같이 각 티켓에서 에이전트를 시작합니다.
양방향 동기화가 아닙니다. AgentsRoom은 Azure DevOps에 읽기 요청만 보냅니다: 상태 변경도, 댓글도, 필드 업데이트도 없습니다. 에이전트가 작업 항목에 댓글을 달거나 닫게 하고 싶다면, 그것은 Microsoft 자체의 Azure DevOps용 MCP 서버가 하는 일이고, 아래에서 설명하듯 두 가지는 함께 동작합니다.
Azure DevOps 가져오기가 하는 일
Jira, Linear, GitHub Issues, Notion에 더해 백로그의 소스가 하나 더 늘었습니다.
프로젝트 하나 또는 직접 쓴 WIQL
목록에서 프로젝트를 고르면(수십 개일 때는 검색란도 있습니다) 쿼리가 자동으로 작성됩니다: 그 프로젝트에서 아직 열려 있는 모든 항목을, 가장 최근에 바뀐 것부터. 아니면 WIQL을 직접 쓰세요: 영역 경로, 반복, 태그, 또는 내 작업 항목만 남기는 AND [System.AssignedTo] = @Me.
작업 항목 하나를 번호로
방금 받은 버그 하나만 필요한가요? TODO 열의 가져오기 버튼에 1234, #1234, AB#1234 또는 작업 항목 링크를 붙여넣으세요. 그 작업 항목만 열 맨 위에 들어오고, 저장된 가져오기는 건드리지 않습니다.
재현 단계와 인수 조건까지 포함
Azure DevOps는 명세를 여러 HTML 필드에 나눠 보관합니다. 가져오기는 설명, 재현 단계, 인수 조건을 Markdown으로 변환한 뒤, 짧은 컨텍스트 블록을 덧붙입니다: 유형, 상태, 영역, 반복, 우선순위, 스토리 포인트, 상위 항목. 에이전트는 팀이 쓴 그대로의 명세를 읽습니다.
에이전트가 열 수 있는 첨부 파일
작업 항목에 첨부된 파일과 본문에 붙여넣은 이미지는 Azure DevOps 로그인 뒤에 있으므로, 링크만으로는 에이전트에게 쓸모가 없습니다. 가져오기는 이 파일들을 내 컴퓨터로 내려받아 티켓에 첨부합니다. 작업 항목 하나에 최대 10개까지입니다.
말이 되는 유형과 상태
Bug, User Story, Product Backlog Item, Feature, Epic, Task: Basic, Agile, Scrum, CMMI 프로세스의 기본 제공 유형이 티켓 유형으로 매핑되고, 작업 항목 유형은 태그로 남습니다. 완료 여부는 상태의 이름이 아니라 상태의 범주로 판단하므로, 내 프로세스에서 닫힌 작업 항목은 상태 이름이 Closed든 Done이든 직접 정한 이름이든 완료 상태로 들어옵니다.
읽기 전용, 토큰은 내 머신에
토큰에는 읽기 범위 두 개만 있으면 됩니다. 토큰은 내 컴퓨터에 암호화되어 저장되고 우리 서버에는 절대 도착하지 않습니다. 다른 머신으로 프로젝트를 따라가는 것은 쿼리뿐이며, 그곳에서 토큰을 다시 붙여넣습니다.
동작 방식
네 단계입니다. 처음 두 단계는 머신마다 한 번만 합니다.
- 1
개인 액세스 토큰 만들기
Azure DevOps에서 User settings를 열고 Personal access tokens로 들어가, 조직용 토큰을 두 범위로 만드세요: Work Items (Read)와 Project and Team (Read). 쓰기 권한은 전혀 필요 없습니다.
- 2
조직 연결하기
프로젝트의 백로그에서 티켓 가져오기를 클릭하고 Azure DevOps를 고르세요. 조직 이름(dev.azure.com/ 뒤의 부분, 또는 전체 주소를 붙여넣어도 됨)과 토큰을 입력합니다.
- 3
고르고 미리 보기
프로젝트를 고르거나 WIQL 쿼리를 쓴 뒤 미리 보기를 클릭하세요. 번호나 제목으로 목록을 검색하고, 원하는 작업 항목에 체크한 뒤 가져옵니다. 한 번에 최대 500개까지입니다.
- 4
티켓마다 에이전트에게 맡기기
이제 작업 항목은 TODO의 티켓이 되었고, 각각 Azure DevOps로 돌아가는 링크가 있습니다. 에이전트와 모델을 할당하고, 별도 브랜치에서 작업하게 하려면 이 작업을 위해 별도 워크트리에서 코딩에 체크한 뒤, 티켓을 In Progress로 드래그하세요. 나중에 다시 가져오기로 보드를 다시 맞출 수 있습니다.
Microsoft와 에이전트 CLI가 이미 자체적으로 하는 일
Microsoft는 Azure DevOps용 MCP 서버를 공개하고 있습니다(GitHub의 microsoft/azure-devops-mcp). 로컬 서버의 경우, 문서에는 Claude Code용으로 claude mcp add --transport stdio azure-devops -- npx -y @azure-devops/mcp contoso, Codex용으로 codex mcp add azure-devops -- npx -y @azure-devops/mcp contoso가 나와 있으며, contoso 자리에는 조직 이름이 들어갑니다. 기본적으로 브라우저가 열려 Microsoft 계정으로 로그인합니다. 그러면 에이전트는 세션 안에서 작업 항목, 저장소, 파이프라인, 위키, 테스트 계획을 다루는 도구를 얻습니다.
Microsoft는 이 서버의 호스팅 버전도 운영하며, 2026년 8월 5일부터 정식 출시되었습니다. 발표에 따르면 Claude Code, Claude Desktop, ChatGPT, Cursor는 아직 여기에 연결할 수 없습니다. 이들에게 필요한 OAuth 등록을 Microsoft Entra가 지금은 제공하지 않기 때문이며, 그래서 이 사용자들은 로컬 서버를 계속 씁니다. Azure Boards는 작업 항목의 Copilot 버튼으로 작업 항목을 GitHub Copilot 코딩 에이전트에게 보낼 수도 있으며, 이 기능은 2025년 12월부터 정식 출시되었습니다: 코드는 GitHub 저장소에 있어야 하고, 에이전트는 내 컴퓨터의 세션이 아니라 GitHub의 초안 풀 리퀘스트로 답합니다.
AgentsRoom 가져오기는 다른 필요에 답합니다: 나머지 티켓 옆에 작업 항목을 보드로 놓고, 작업 항목마다 에이전트 하나를 내 머신에서, 내가 고른 CLI로 돌리는 것입니다. Azure DevOps 연동이 전혀 없는 CLI도 포함되며, 코드가 Azure Repos에 있든 GitHub에 있든 다른 곳에 있든 상관없습니다. 둘은 서로 배타적이지 않습니다: 작업을 계획하고 실행하려면 작업 항목을 가져오고, 에이전트가 직접 자기 작업 항목에 댓글을 달거나 닫아야 할 때는 Microsoft의 MCP 서버를 주세요.
알아 둘 점
- Azure DevOps Services(dev.azure.com)만 지원합니다. 자체 서버에 설치한 Azure DevOps Server는 지원하지 않습니다.
- 컴퓨터 한 대에 조직 하나입니다. 두 번째 조직에서 가져오려면 첫 번째 조직 대신 그 조직을 연결하세요.
- 한 방향뿐입니다: 티켓이 여기서 완료되어도 Azure DevOps로는 아무것도 돌아가지 않습니다. 작업 항목은 직접 닫거나, 에이전트에게 Microsoft의 MCP 서버를 주세요.
- 토큰은 연결한 컴퓨터에 남습니다. 다른 머신에서는 그곳에도 토큰을 붙여넣을 때까지 보드 버튼에 다시 연결이 표시되고, Azure DevOps 연결 안 됨 배지가 붙습니다.
- 가져오기 한 번에 작업 항목 최대 500개, 작업 항목 하나에 첨부 파일 최대 10개까지입니다.
- 댓글, 담당자, 상위 항목 외의 링크, 기록은 가져오지 않습니다: 티켓에는 제목, 설명, 재현 단계, 인수 조건, 컨텍스트 블록, 태그, 파일이 담깁니다.
- Azure DevOps 연결과 쿼리 작성은 데스크톱에서 합니다. 휴대폰에서는 가져오기를 다시 실행하거나 번호로 작업 항목 하나를 가져올 수 있으며, 둘 다 내 컴퓨터에서 실행되므로 컴퓨터가 켜져 있어야 합니다.
자주 묻는 질문
Microsoft의 Azure DevOps MCP 서버와 같은 건가요?
아닙니다. Microsoft의 MCP 서버는 MCP를 지원하는 CLI에서, 에이전트 하나에게 세션 안에서 Azure DevOps를 읽고 수정하는 도구를 줍니다. AgentsRoom 가져오기는 에이전트가 시작하기 전에 작업 항목을 프로젝트의 백로그로 가져오므로, 작업 항목을 계획하고, 각각 다른 에이전트에게 맡기고, 보드에서 추적할 수 있습니다. 둘 다 쓸 수 있습니다: 작업을 정리하는 데는 가져오기를, 자기 작업 항목에 댓글을 달거나 닫아야 하는 에이전트에게는 MCP 서버를.
Claude Code에서 Azure DevOps를 쓸 수 있나요?
네, 두 가지 방법이 있습니다. 세션 안에서는 claude mcp add --transport stdio azure-devops -- npx -y @azure-devops/mcp contoso(contoso 자리에 내 조직 이름)로 Microsoft의 로컬 MCP 서버를 추가하세요: 그러면 에이전트가 직접 작업 항목을 검색하고, 읽고, 수정할 수 있습니다. 2026년 8월 5일 발표에 따르면 Microsoft의 호스팅 MCP 서버는 아직 Claude Code를 받지 않습니다. 세션 전에는 작업 항목을 AgentsRoom으로 가져와 하나씩 Claude Code 에이전트에게 맡기세요: 설명, 재현 단계, 인수 조건, 파일이 작업과 함께 에이전트에게 전달됩니다.
에이전트가 끝나면 AgentsRoom이 작업 항목을 업데이트하나요?
아닙니다. 가져오기는 읽기 범위만 있는 토큰으로 읽기 요청만 보냅니다: 상태 변경도, 댓글도, 필드 업데이트도 없습니다. 티켓이 여기서 완료되면, Azure DevOps의 작업 항목은 직접 옮기거나 Microsoft의 MCP 서버를 통해 에이전트가 하게 하세요.
나에게 할당된 작업 항목만 가져올 수 있나요?
네, WIQL로 가능합니다: 프로젝트를 고른 뒤, 자동으로 작성된 쿼리에 AND [System.AssignedTo] = @Me를 덧붙이세요. 반복 경로, 영역 경로, 태그로 거를 수도 있습니다. 쿼리는 프로젝트와 함께 저장되므로, 나중에 다시 가져오기로 다시 실행할 수 있습니다.
방금 할당받은 작업 항목 하나만 가져올 수 있나요?
네. TODO 열의 가져오기 버튼을 쓰고 그 번호(1234, #1234 또는 AB#1234)나 링크를 붙여넣으세요. 저장된 가져오기를 바꾸지 않고 TODO 맨 위에 들어오며, 나중에 티켓에서 따로 새로 고칠 수 있습니다.
내 Azure DevOps 토큰이 내 컴퓨터를 벗어나나요?
아닙니다. 토큰은 조직 이름과 함께 연결한 컴퓨터에 암호화되어 저장되고, 우리 서버에는 절대 도착하지 않습니다. 첨부 파일은 연결한 조직에서만 내려받으므로, 토큰이 다른 호스트로 보내지는 일은 없습니다. 내 계정에 저장되는 것은 가져오기 쿼리뿐이라, 가져오기는 프로젝트를 따라 다른 머신으로 가고, 그곳에서 토큰을 다시 붙여넣습니다.
가져온 작업 항목에서는 어떤 에이전트 CLI가 작업할 수 있나요?
AgentsRoom이 지원하는 에이전트 CLI 17개(Claude, Codex, GitHub Copilot CLI, Cursor 및 그 외 13개) 모두입니다. 가져온 작업 항목은 일반 티켓입니다: 할당한 에이전트와 모델로, 공유 체크아웃이나 자체 git 워크트리에서 실행됩니다.
Azure DevOps Server나 Team Foundation Server에서도 동작하나요?
지금은 아닙니다. 가져오기는 dev.azure.com의 Azure DevOps Services와 통신합니다. 자체 서버에 설치한 Azure DevOps Server를 쓰는 팀도, 그 설치 환경을 지원하는 Azure DevOps MCP 서버를 에이전트에게 줄 수는 있습니다.
이런 것도 함께 보세요
티켓 가져오기
Jira, Linear, GitHub Issues, Azure DevOps, Notion 티켓을 하나의 백로그로 모으고, 하나씩 내 머신에서 Claude Code, Codex, Cursor 또는 모든 에이전트 CLI에 맡기세요. 읽기 전용.
Jira 가져오기
Jira Cloud 이슈를 AgentsRoom으로 가져와 하나씩 내 머신에서 Claude Code, Codex, Cursor 또는 모든 에이전트 CLI에 맡기세요. 프로젝트 또는 JQL, 첨부 파일 포함. 읽기 전용.
작업 관리
드래그 앤 드롭으로 AI 에이전트를 지휘하는 시각적 칸반 보드. TODO에 작업을 만들고 In Progress로 끌어다 놓으면 Claude 에이전트가 자동으로 생성되며, Pending과 Done 칼럼으로 진행 상황을 추적하세요. 병렬 AI 코딩을 위한 백로그 기반 개발.
Git worktree
AI 에이전트나 티켓마다 바로 빌드할 수 있는 전용 git worktree를 주세요(의존성 설치, .env 복사 완료). 그런 다음 창 하나에서 리뷰하고, 커밋하고, 병합하세요.
MCP 서버
MCP 서버를 한 번 선언하면 Claude Code, Codex, 모든 에이전트 CLI에 전달됩니다. 공식 MCP 레지스트리에서 고르고, 키는 시크릿 관리자에 보관하고, Notion이나 Linear 같은 OAuth 서버에는 '연결' 버튼 하나로 로그인하세요.
Azure DevOps 작업 항목을 에이전트에게 맡기세요
AgentsRoom을 다운로드하고, 저장소를 프로젝트로 연 뒤, 백로그에서 티켓 가져오기를 클릭하고 Azure DevOps를 고르세요.
컴패니언 앱: 이동 중에도 에이전트를 모니터링
Claude, Codex, Antigravity CLI 또는 다른 AI 공급자를 사용하세요.
버그와 요청을 공개 백로그로 바로 보내세요.