Compartilhar via

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

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:

  • Instale e autentique-se no Servidor MCP do Azure.
  • Conecte-se ao Servidor MCP do Azure usando o modo de agente do GitHub Copilot no Visual Studio.
  • Execute prompts para testar as operações do Servidor MCP do Azure e interagir com os recursos do Azure.

Pré-requisitos

Instalar o servidor MCP do Azure

O Visual Studio usa um arquivo nomeado mcp.json para verificar se há configurações do SERVIDOR MCP, incluindo configurações configuradas por outros ambientes de desenvolvimento. As configurações do servidor MCP são lidas nos seguintes diretórios, na seguinte ordem:

  1. %USERPROFILE%\.mcp.json: serve como uma configuração de servidor MCP global para um usuário específico. Adicione um servidor MCP aqui para fazer com que ele seja carregado para todas as soluções do Visual Studio.
  2. <SOLUTIONDIR>\.vs\mcp.json: específico do Visual Studio e carrega apenas os servidores MCP especificados para um usuário específico para a solução especificada.
  3. <SOLUTIONDIR>\.mcp.json: uma configuração mcp no nível da solução que você pode acompanhar no controle do código-fonte para um repositório.
  4. <SOLUTIONDIR>\.vscode\mcp.json: escopo para o repositório/solução e normalmente não incluído no controle do código-fonte.
  5. <SOLUTIONDIR>\.cursor\mcp.json: escopo para o repositório/solução e normalmente não incluído no controle do código-fonte.

Observação

Alguns desses locais exigem .mcp.json enquanto outros exigem mcp.json.

O Servidor MCP do Azure está disponível como um pacote NuGet ou como um pacote NPM. As opções a seguir demonstram duas das abordagens mais comuns para se conectar ao Servidor MCP do Azure do Visual Studio.

Observação

Como alternativa, você pode usar a extensão GitHub Copilot para Azure para instalar o Azure MCP.

Conclua as seguintes etapas para instalar o Servidor MCP do Azure para um diretório específico:

  1. Crie um novo arquivo na raiz da sua solução chamada .mcp.json. Use o Visual Studio para editar esse arquivo para que seu esquema JSON seja aplicado automaticamente.

  2. Dentro do .mcp.json arquivo, adicione o seguinte JSON para seu pacote preferencial:

    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"
      ]
    }
  }
}

  3. Salve suas alterações.

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

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

Uma captura de tela mostrando como configurar o Servidor MCP do Azure no Visual Studio.

O Visual Studio 2026 inclui ferramentas do servidor MCP do Azure com a carga de trabalho de desenvolvimento de IA e do Azure. Para disponibilizá-los:

  1. Abra a ferramenta Instalador do Visual Studio.

  2. Selecione Modificar para exibir cargas de trabalho disponíveis.

  3. Na guia Cargas de Trabalho , selecione o desenvolvimento do Azure e da IA.

  4. No painel detalhes da instalação , verifique se o GitHub Copilot está selecionado, o que inclui os seguintes componentes:

    • GitHub Copilot
    • GitHub Copilot para Azure
    • Servidor MCP do Azure

  5. Selecione Instalar durante o download para concluir o processo de instalação.

Uma captura de tela mostrando como instalar o Copilot usando cargas de trabalho do Visual Studio.

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.

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 você 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 Permitir desta vez ou use a seta para selecionar um comportamento mais específico:

    • 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.
    • Permitir nesta sessão sempre executa a operação na sessão atual do GitHub Copilot Agent Mode.

    Uma captura de tela mostrando como executar as ferramentas do Servidor MCP do Azure no Visual Studio.

    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`)
5. **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

  • Last updated on