원격 Azure DevOps MCP 서버 설정(미리 보기)

Azure DevOps Services

원격 Azure DevOps MCP 서버는 로컬 설치가 필요하지 않은 Azure DevOps MCP Server 호스트된 버전입니다. 머신에서 서버를 실행하는 대신 스트리밍 가능한 HTTP 전송을 사용하여 AI 도우미를 Azure DevOps 호스팅 엔드포인트에 직접 연결합니다.

원격 서버는 로컬 설치 복잡성을 제거하면서 작업 항목, 끌어오기 요청, 파이프라인 등에 대한 액세스를 포함하여 로컬 서버와 동일한 기능을 제공합니다.

원격 및 로컬 MCP 서버

사전 요구 사항

mcp.json 구성

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http"
    }
  },
  "inputs": []
}

URL에서 조직 이름을 생략할 수도 있습니다. 그러나 조직 이름을 생략하는 경우 각 도구 호출에서 컨텍스트로 제공해야 합니다.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/",
      "type": "http"
    }
  },
  "inputs": []
}

도구 집합

MCP 서버에서 사용할 수 있는 도구를 제한하도록 도구 집합을 지정합니다. X-MCP-Tools와 결합하면 안 됩니다.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "repos,wiki,wit"
      }
    }
  },
  "inputs": []
}

읽기 전용 도구

헤더를 X-MCP-Readonly 사용하여 서버를 읽기 전용 작업으로 제한합니다. 이 제한은 Azure DevOps 리소스에 대한 수정을 방지하려는 경우에 유용합니다.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Readonly": "true"
      }
    }
  },
  "inputs": []
}

툴세트를 결합하고 읽기 전용 필터링 적용

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "repos,wiki,wit",
        "X-MCP-Readonly": "true"
      }
    }
  },
  "inputs": []
}

개별 도구

헤더를 X-MCP-Tools 사용하여 특정 도구만 사용하도록 설정합니다. X-MCP-Toolsets와 결합하면 안 됩니다.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "core_list_projects, wit_my_work_items, wit_get_work_items_batch_by_ids"
      }
    }
  },
  "inputs": []
}

내부자

기존 도구와 업데이트를 실험하고 도입할 때 헤더를 사용하여 X-MCP-Insiders 이러한 변경 내용에 조기에 액세스할 수 있습니다.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Insiders": "true"
      }
    }
  },
  "inputs": []
}

사용 가능한 도구

핵심 도구

핵심 도구는 항상 사용할 수 있습니다.

일하다

작업 도구는 action 매개 변수를 사용하여 디스패처 그룹으로 통합됩니다.

Repos

리포지토리 도구는 action 매개변수를 사용해 그룹화된 디스패처로 통합됩니다.

재치

작업 항목 도구가 action 매개 변수를 사용하여 그룹화된 디스패처로 통합됩니다.

파이프라인

파이프라인 도구는 action 매개변수를 사용하여 그룹화된 디스패처로 통합됩니다.

Wiki

위키 읽기 작업은 단일 wiki 도구로 통합됩니다. 매개 변수를 action 사용하여 작업을 선택합니다.

테스트 계획

테스트 계획 도구는 action 매개변수를 사용해 그룹화된 디스패처로 통합됩니다.

지원되는 환경

원격 Azure DevOps MCP Server를 사용하려면 사용자 계정 및 Azure DevOps 조직이 Microsoft Entra ID 연결해야 합니다.

모든 MCP 클라이언트는 기본적으로 Microsoft Entra 인증을 지원하지 않습니다. 일부 환경에서는 클라이언트 애플리케이션을 등록하기 위한 추가 단계가 필요합니다.

현재 지원되는 환경은 다음과 같습니다.

• Visual Studio Code
• Visual Studio

Visual Studio Code

Visual Studio Code 원격 MCP 서버를 구성하려면 다음을 수행합니다.

1. .vscode/mcp.json 이전에 표시된 mcp.json 구성을 사용하여 리포지토리에 파일을 추가합니다.
2. 파일을 저장합니다.
3. VS Code에서 GitHub Copilot 엽니다.
4. 메시지가 표시되면 Microsoft Entra 계정을 사용하여 인증하고 계정을 선택합니다.

인증이 완료되면 사용 가능한 도구 목록이 나타납니다.

Visual Studio(2022년 이상)

MCP 설정에 서버 URL을 추가하여 Visual Studio 원격 MCP 서버를 구성합니다. 자세한 내용은 Visual Studio 참조하세요.

연결 확인

설정 후 AI 도우미에게 Azure DevOps 데이터에 대한 질문을 하여 원격 MCP 서버가 작동하는지 확인합니다.

예시들:

• "Azure DevOps 조직의 프로젝트를 나열합니다."
• "할당된 작업 항목을 표시합니다."
• "내 검토가 필요한 끌어오기 요청은 무엇인가요?"

AI 도우미가 Azure DevOps 조직의 결과를 반환하면 원격 MCP 서버가 올바르게 구성됩니다.

Troubleshooting

지원을 위해 로컬 MCP 서버 리포지토리에서 문제를 만들 수 있습니다. 원격 문제 템플릿을 사용해야 합니다.

자주 묻는 질문(FAQ)

GitHub Copilot CLI, Claude Desktop, Claude Code, CodeX 또는 Cursor와 같은 다른 클라이언트는 어떻습니까?

CodeX, Claude Desktop, Claude Code 및 ChatGPT와 같은 다른 클라이언트 도구는 MCP 서버에서 사용하기 전에 Microsoft Entra OAuth 클라이언트 ID를 동적으로 등록해야 합니다. 이 기능을 사용하도록 설정하기 위해 Microsoft Entra 팀과 긴밀히 협력하고 있습니다. 지금은 Visual Studio 및 Visual Studio Code만 지원됩니다.

MCP Server를 Azure DevOps 사용할 수 있는 서비스는 무엇인가요?

Azure AI Foundry, Microsoft 365 Copilot 및 Copilot Studio 포함한 다른 서비스에 대한 지원은 아직 제공되지 않지만 곧 추가될 예정입니다.

Azure DevOps MCP 서버가 AgentId를 지원하나요?

AgentId 지원은 곧 제공될 예정입니다.

관련 콘텐츠

• Azure DevOps MCP Server 개요
• Azure DevOps MCP Server GitHub 리포지토리