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

O Servidor MCP do Azure usa o Protocolo de Contexto de Modelo (MCP) para padronizar integrações entre aplicativos de IA e ferramentas externas e fontes de dados, permitindo que os sistemas de IA executem operações sensíveis ao contexto de seus 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 subscrição ativa
• de código do Visual Studio
• Copiloto do GitHub Extensão de código do Visual Studio

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 de extensão

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

   

   Sugestão

   Para obter uma experiência ideal do Servidor MCP do Azure, instale o GitHub Copilot for 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 aprimora sua produtividade na plataforma Azure.

2. Depois de instalar a extensão, abra o GitHub Copilot e selecione Modo de agente. Para saber mais sobre o modo de agente, visite a documentação de código do Visual Studio.

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 ID do Microsoft Entra. Para usar o Servidor MCP do Azure, você deve primeiro autenticar no Azure usando ferramentas de desenvolvimento local, 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 autenticar nos serviços do Azure.

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

   az login
   

2. Verifique o status da 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 Azure MCP Server já devem existir em sua assinatura do Azure. Por exemplo, as atribuições de função comuns incluem:

   • Blob Storage Data Contributor - Leia e escreva dados de blob em contas de armazenamento.
   • Colaborador da conta de armazenamento - Gerencie as configurações da conta de armazenamento.
   • Colaborador - Gestão geral de recursos em toda a sua subscrição.
   • Reader - 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 para 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 adicione 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 Modo de agente.

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

   

   Para saber mais sobre o modo de agente, visite a documentação de código do Visual Studio.

Usar prompts para testar o Servidor MCP do Azure

1. Abra o GitHub Copilot e selecione Modo de agente.

2. Insira um prompt que faça com que o agente use as 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 você já estiver autenticado por meio de outras ferramentas locais, como a CLI do Azure.

4. O Copiloto solicita permissão para executar a operação necessária do Azure MCP Server relacionada ao seu comando. 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 Modo de Agente Copiloto do GitHub.
   • O espaço de trabalho atual sempre executa o comando para o espaço de trabalho atual do Visual Studio Code.
   • Sempre permitir define a operação para sempre ser executada para qualquer sessão do Modo de Agente Copiloto do GitHub ou qualquer espaço de trabalho do Visual Studio Code.

   

   A saída para o 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 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óximos passos

Saiba mais sobre as ferramentas do Azure MCP Server