Azure MCP 서버는 MCP(모델 컨텍스트 프로토콜)를 사용하여 AI 앱과 외부 도구 및 데이터 원본 간의 통합을 표준화하여 AI 시스템이 Azure 리소스에 대한 컨텍스트 인식 작업을 수행할 수 있도록 합니다.
이 문서에서는 다음 작업을 완료하는 방법을 알아봅니다.
- Azure MCP Server를 설치하고 인증합니다.
- Visual Studio에서 GitHub Copilot 에이전트 모드를 사용하여 Azure MCP Server에 연결합니다.
- 프롬프트를 실행하여 Azure MCP Server 작업을 테스트하고 Azure 리소스와 상호 작용합니다.
필수 조건
- 활성 구독이 있는 Azure 계정
- Visual Studio
- .NET 10 또는 Node.js LTS가 설치됨
Azure MCP 서버 설치
Visual Studio는 명명된 mcp.json 파일을 사용하여 다른 개발 환경에서 설정한 구성을 포함하여 MCP 서버 구성을 확인합니다. MCP 서버 구성은 다음 순서대로 다음 디렉터리에서 읽습니다.
-
%USERPROFILE%\.mcp.json: 특정 사용자에 대한 전역 MCP 서버 구성으로 사용됩니다. 모든 Visual Studio 솔루션에 대해 로드되도록 여기에 MCP 서버를 추가합니다. -
<SOLUTIONDIR>\.vs\mcp.json: Visual Studio에 한정되며 지정된 솔루션에 대해 특정 사용자에 대해 지정된 MCP 서버만 로드합니다. -
<SOLUTIONDIR>\.mcp.json: 리포지토리에 대한 소스 제어에서 추적할 수 있는 솔루션 수준 MCP 구성입니다. -
<SOLUTIONDIR>\.vscode\mcp.json: 리포지토리/솔루션으로 범위가 지정되며 일반적으로 소스 제어에 포함되지 않습니다. -
<SOLUTIONDIR>\.cursor\mcp.json: 리포지토리/솔루션으로 범위가 지정되며 일반적으로 소스 제어에 포함되지 않습니다.
비고
이러한 위치 중 일부는 .mcp.json 필요하지만 다른 위치는 mcp.json필요합니다.
Azure MCP Server는 NuGet 패키지 또는 NPM 패키지로 사용할 수 있습니다. 다음 옵션은 Visual Studio에서 Azure MCP Server에 연결하는 가장 일반적인 두 가지 방법을 보여 줍니다.
비고
또는 Azure용 GitHub Copilot 확장을 사용하여 Azure MCP를 설치할 수 있습니다.
특정 디렉터리에 대해 Azure MCP Server를 설치하려면 다음 단계를 완료합니다.
솔루션의 루트에 새 파일을 만듭니다
.mcp.json. Visual Studio를 사용하여 JSON 스키마가 자동으로 적용되도록 이 파일을 편집합니다.파일 내에서
.mcp.json원하는 패키지에 대해 다음 JSON을 추가합니다.NuGet:
{ "servers": { "Azure MCP Server": { "command": "dnx", "args": [ "Azure.Mcp", "--source", "https://api.nuget.org/v3/index.json", "--yes", "--", "azmcp", "server", "start" ], "type": "stdio" } } }NPM:
{ "servers": { "Azure MCP Server": { "command": "npx", "args": [ "-y", "@azure/mcp@latest", "server", "start" ] } } }변경 내용을 저장합니다.
GitHub Copilot를 열고 에이전트 모드를 선택합니다.
도구 아이콘을 선택하여 사용 가능한 도구를 봅니다. Azure MCP Server를 검색하여 결과를 필터링합니다.
Visual Studio 2026에는 Azure 및 AI 개발 워크로드가 포함된 Azure MCP Server 도구가 포함되어 있습니다. 사용할 수 있도록 하려면 다음을 수행합니다.
Visual Studio 설치 관리자 도구를 엽니다.
수정을 선택하여 사용 가능한 워크로드를 봅니다.
워크로드 탭에서 Azure 및 AI 개발을 선택합니다.
설치 세부 정보 패널에서 다음 구성 요소를 포함하는 GitHub Copilot가 선택되어 있는지 확인합니다.
- GitHub Copilot
- Azure용 GitHub Copilot
- Azure MCP 서버
다운로드하는 동안 설치를 선택하여 설치 프로세스를 완료합니다.
Azure에 대한 인증
Azure MCP Server는 Azure 계정 및 Microsoft Entra ID를 사용하여 원활한 인증 환경을 제공합니다. Azure MCP Server를 사용하려면 먼저 Azure CLI, Azure Developer CLI, Visual Studio 또는 Visual Studio Code와 같은 로컬 개발 도구를 사용하여 Azure에 인증해야 합니다. Azure MCP Server는 이러한 도구에서 자격 증명을 자동으로 검색하고 이를 사용하여 Azure 서비스에 인증합니다.
예를 들어 Azure CLI를 사용하여 로그인하려면 다음을 수행합니다.
az login다음 명령을 실행하여 현재 로그인한 계정 및 구독을 확인하여 인증 상태를 확인합니다.
az account show사용자 계정에 상호 작용하려는 Azure 서비스에 대한 적절한 역할 할당이 있는지 확인합니다. Azure MCP Server를 사용하여 액세스하려는 Azure 리소스는 Azure 구독 내에 이미 있어야 합니다. 예를 들어 일반적인 역할 할당은 다음과 같습니다.
- Blob Storage 데이터 기여자 - 스토리지 계정에서 Blob 데이터를 읽고 씁니다.
- 스토리지 계정 기여자 - 스토리지 계정 구성을 관리합니다.
- 기여자 - 구독 서비스 전체에서 일반 리소스 관리.
- 읽기 권한자 - Azure 리소스에 대한 읽기 전용 액세스입니다.
역할 할당 및 로컬 개발 인증에 대한 자세한 내용은 로컬 개발 중에 Azure 서비스에 .NET 앱 인증을 참조하세요.
프롬프트를 사용하여 Azure MCP 서버 테스트
GitHub Copilot를 열고 에이전트 모드를 선택합니다.
에이전트가 Azure 리소스 그룹 나열과 같은 Azure MCP Server 도구를 사용하도록 하는 프롬프트를 입력합니다.
Azure MCP Server를 인증하기 위해 Copilot는 브라우저를 사용하여 Azure에 로그인하라는 메시지를 표시합니다.
비고
이미 Azure CLI와 같은 다른 로컬 도구를 통해 인증된 경우 Copilot는 Azure에 로그인하라는 메시지를 표시하지 않습니다.
Copilot는 프롬프트에 필요한 Azure MCP 서버 작업을 실행할 수 있는 권한을 요청합니다. 이번에는 허용을 선택하거나 화살표를 사용하여 보다 구체적인 동작을 선택합니다.
- 항상 모든 GitHub Copilot 에이전트 모드 세션 또는 Visual Studio Code 작업 영역에 대해 작업을 실행하도록 항상 허용합니다.
- 이 세션에서 허용 은 항상 현재 GitHub Copilot 에이전트 모드 세션에서 작업을 실행합니다.
이전 프롬프트의 출력은 다음 텍스트와 유사합니다.
The following resource groups are available for your subscription: 1. **DefaultResourceGroup-EUS** (Location: `eastus`) 2. **rg-testing** (Location: `centralus`) 3. **rg-azd** (Location: `eastus2`) 4. **msdocs-sample** (Location: `southcentralus`) 5. **ai-testing** (Location: `eastus2`) Let me know if you need further details or actions related to any of these resource groups!다음과 같은 다른 관련 프롬프트를 사용하여 Azure MCP 작업을 탐색하고 테스트합니다.
List all of the storage accounts in my subscription Get the available tables in my storage accounts