Visual Studio Code를 사용하여 Azure MCP 서버 시작

Azure MCP 서버는 MCP(모델 컨텍스트 프로토콜)를 사용하여 AI 앱과 외부 도구 및 데이터 원본 간의 통합을 표준화하여 AI 시스템이 Azure 리소스에 대한 컨텍스트 인식 작업을 수행할 수 있도록 합니다.

이 문서에서는 다음 작업을 완료하는 방법을 알아봅니다.

• Azure MCP Server 설치 및 인증
• Visual Studio Code에서 GitHub Copilot 에이전트 모드를 사용하여 Azure MCP 서버에 연결
• 프롬프트를 실행하여 Azure MCP 서버 작업을 테스트하고 Azure 리소스와 상호 작용

필수 조건

• 활성 구독이 있는 Azure 계정
• Visual Studio Code
• GitHub Copilot Visual Studio Code 확장

Azure MCP 서버 설치

Visual Studio Code에서 Azure MCP Server를 설치하려면 다음 옵션 중 하나를 선택합니다.

확장 설치

1. Visual Studio Code용 Azure MCP 서버 확장을 설치하려면 다음 링크를 선택합니다.

   

   팁 (조언)

   최적의 Azure MCP 서버 환경을 위해 Azure MCP Server 확장을 포함하고 사용하는 Azure용 GitHub Copilot를 설치합니다. Azure용 GitHub Copilot는 개발 워크플로를 간소화하고 Azure 플랫폼에서 생산성을 향상시킵니다.

2. 확장을 설치한 후 GitHub Copilot를 열고 에이전트 모드를 선택합니다. 에이전트 모드에 대한 자세한 내용은 Visual Studio Code 설명서를 참조하세요.

3. 도구 목록을 새로 고쳐 Azure MCP Server를 사용 가능한 옵션으로 확인합니다.

   

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 서비스에 인증합니다.

1. 예를 들어 Azure CLI를 사용하여 로그인하려면 다음을 수행합니다.

   az login
   

2. 다음 명령을 실행하여 현재 로그인한 계정 및 구독을 확인하여 인증 상태를 확인합니다.

   az account show
   

3. 사용자 계정에 상호 작용하려는 Azure 서비스에 대한 적절한 역할 할당이 있는지 확인합니다. Azure MCP Server를 사용하여 액세스하려는 Azure 리소스는 Azure 구독 내에 이미 있어야 합니다. 예를 들어 일반적인 역할 할당은 다음과 같습니다.

   • Blob Storage 데이터 기여자 - 스토리지 계정에서 Blob 데이터를 읽고 씁니다.
   • 스토리지 계정 기여자 - 스토리지 계정 구성을 관리합니다.
   • 기여자 - 구독 서비스 전체에서 일반 리소스 관리.
   • 읽기 권한자 - Azure 리소스에 대한 읽기 전용 액세스입니다.

   역할 할당 및 로컬 개발 인증에 대한 자세한 내용은 로컬 개발 중에 Azure 서비스에 .NET 앱 인증을 참조하세요.

디렉터리 설치

특정 디렉터리에 대해 Azure MCP Server를 수동으로 설치할 수도 있습니다.

1. Visual Studio Code에서 빈 디렉터리 또는 기존 프로젝트 디렉터리를 엽니다.

2. 폴더의 루트에 아직 없는 경우 폴더를 .vscode 만듭니다.

3. 폴더 내에 .vscode 다음 JSON을 추가하는 새 mcp.json 파일을 만듭니다.

   {
     "servers": {
       "Azure MCP Server": {
         "command": "npx",
         "args": [
           "-y",
           "@azure/mcp@latest",
           "server",
           "start"
         ]
       }
     }
   }
   

4. 변경 내용을 .에 mcp.json저장합니다.

5. GitHub Copilot를 열고 에이전트 모드를 선택합니다.

6. 도구 아이콘을 선택하여 사용 가능한 도구를 봅니다. Azure MCP Server를 검색하여 결과를 필터링합니다.

   

   에이전트 모드에 대한 자세한 내용은 Visual Studio Code 설명서를 참조하세요.

프롬프트를 사용하여 Azure MCP 서버 테스트

1. GitHub Copilot를 열고 에이전트 모드를 선택합니다.

2. 에이전트가 Azure 리소스 그룹 나열과 같은 Azure MCP Server 도구를 사용하도록 하는 프롬프트를 입력합니다.

3. Azure MCP Server를 인증하기 위해 Copilot는 브라우저를 사용하여 Azure에 로그인하라는 메시지를 표시합니다.

   비고

   이미 Azure CLI와 같은 다른 로컬 도구를 통해 인증된 경우 Copilot는 Azure에 로그인하라는 메시지를 표시하지 않습니다.

4. Copilot는 프롬프트에 필요한 Azure MCP 서버 작업을 실행할 수 있는 권한을 요청합니다. 계속을 선택하거나 화살표를 사용하여 보다 구체적인 동작을 선택합니다.

   • 현재 세션 은 항상 현재 GitHub Copilot 에이전트 모드 세션에서 작업을 실행합니다.
   • 현재 작업 영역은 항상 현재 Visual Studio Code 작업 영역에 대한 명령을 실행합니다.
   • 항상 모든 GitHub Copilot 에이전트 모드 세션 또는 Visual Studio Code 작업 영역에 대해 작업을 실행하도록 항상 허용합니다.

   

   이전 프롬프트의 출력은 다음 텍스트와 유사합니다.

   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`)
   14. **ai-testing** (Location: `eastus2`)
   
   Let me know if you need further details or actions related to any of these resource groups!
   

5. 다음과 같은 다른 관련 프롬프트를 사용하여 Azure MCP 작업을 탐색하고 테스트합니다.

   List all of the storage accounts in my subscription
   Get the available tables in my storage accounts
   

다음 단계

Azure MCP Server 도구에 대해 자세히 알아보기