Introdução ao Servidor MCP do Azure usando o Visual Studio Code

O Servidor MCP do Azure usa o PROTOCOLO MCP (Model Context Protocol) para padronizar as integrações entre aplicativos de IA e ferramentas externas e fontes de dados, permitindo que os sistemas de IA executem operações com reconhecimento de contexto dos recursos do Azure.

Neste artigo, você aprenderá a concluir as seguintes tarefas:

• Instalar e autenticar no Servidor MCP do Azure
• Conectar-se ao Servidor MCP do Azure usando o modo de agente do GitHub Copilot no Visual Studio Code
• Executar prompts para testar as operações do Servidor MCP do Azure e interagir com os recursos do Azure

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa
• Código do Visual Studio
• GitHub Copilot Extensão do Visual Studio Code

Instalar o servidor MCP do Azure

Selecione uma das seguintes opções para instalar o Servidor MCP do Azure no Visual Studio Code:

Instalação da extensão

1. Para instalar a Extensão do Servidor MCP do Azure para Visual Studio Code, selecione o seguinte link:

   

   Dica

   Para uma experiência ideal do Servidor MCP do Azure, instale o GitHub Copilot para Azure, que inclui e usa a extensão do Servidor MCP do Azure. O GitHub Copilot para Azure simplifica seu fluxo de trabalho de desenvolvimento e melhora sua produtividade na plataforma do Azure.

2. Depois de instalar a extensão, abra o GitHub Copilot e selecione o Modo do Agente. Para saber mais sobre o Modo do Agente, visite a Documentação do Visual Studio Code.

3. Atualize a lista de ferramentas para ver o Servidor MCP do Azure como uma opção disponível:

   

Autenticar no Azure

O Servidor MCP do Azure fornece uma experiência de autenticação perfeita usando contas do Azure e a ID do Microsoft Entra. Para usar o Servidor MCP do Azure, primeiro você deve se autenticar no Azure usando ferramentas de desenvolvimento locais, como a CLI do Azure, a CLI do Desenvolvedor do Azure, o Visual Studio ou o Visual Studio Code. O Servidor MCP do Azure descobre automaticamente suas credenciais dessas ferramentas e as usa para se autenticar nos serviços do Azure.

1. Por exemplo, para entrar usando a CLI do Azure:

   az login
   

2. Verifique seu status de autenticação executando o seguinte comando para ver com qual conta e assinatura você está conectado no momento:

   az account show
   

3. Verifique se sua conta de usuário tem as atribuições de função apropriadas para os serviços do Azure com os quais você deseja interagir. Os recursos do Azure que você pretende acessar com o Servidor MCP do Azure já devem existir em sua assinatura do Azure. Por exemplo, as atribuições de função comuns incluem:

   • Colaborador de Dados do Blob Storage – Ler e gravar dados de blob em contas de armazenamento.
   • Colaborador da Conta de Armazenamento – Gerenciar configurações de conta de armazenamento.
   • Colaborador – Gerenciamento geral de recursos em sua assinatura.
   • Leitor – Acesso somente leitura aos recursos do Azure.

   Para obter mais informações sobre atribuições de função e autenticação de desenvolvimento local, consulte Autenticar aplicativos .NET nos serviços do Azure durante o desenvolvimento local.

Instalação do diretório

Você também pode instalar manualmente o Servidor MCP do Azure para um diretório específico:

1. Abra um diretório vazio ou um diretório de projeto existente no Visual Studio Code.

2. Na raiz da pasta, crie uma .vscode pasta se ainda não houver uma.

3. Dentro da .vscode pasta, crie um novo arquivo chamado mcp.json adicionar o seguinte JSON:

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

4. Salve suas alterações em mcp.json.

5. Abra o GitHub Copilot e selecione o Modo do Agente.

6. Selecione o ícone de ferramentas para exibir as ferramentas disponíveis. Pesquise o Servidor MCP do Azure para filtrar os resultados.

   

   Para saber mais sobre o Modo do Agente, visite a Documentação do Visual Studio Code.

Usar prompts para testar o Servidor MCP do Azure

1. Abra o GitHub Copilot e selecione o Modo do Agente.

2. Insira um prompt que faz com que o agente use ferramentas do Servidor MCP do Azure, como Listar meus grupos de recursos do Azure.

3. Para autenticar o Servidor MCP do Azure, o Copilot solicita que você entre no Azure usando o navegador.

   Observação

   O Copilot não solicitará que você entre no Azure se já estiver autenticado por meio de outras ferramentas locais, como a CLI do Azure.

4. O Copilot solicita permissão para executar a operação necessária do Servidor MCP do Azure para seu prompt. Selecione Continuar ou use a seta para selecionar um comportamento mais específico:

   • A sessão atual sempre executa a operação na sessão atual do GitHub Copilot Agent Mode.
   • O workspace atual sempre executa o comando do workspace atual do Visual Studio Code.
   • Sempre permitir que a operação sempre seja executada para qualquer sessão do Modo do Agente copilot do GitHub ou qualquer workspace do Visual Studio Code.

   

   A saída do prompt anterior deve ser semelhante ao seguinte texto:

   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. Explore e teste as operações do MCP do Azure usando outros prompts relevantes, como:

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

Próximas etapas

Saiba mais sobre as ferramentas do Servidor MCP do Azure