Compartilhar via

Guia Rápido: Integrar o Servidor MCP do Azure com a CLI do GitHub Copilot

Neste início rápido, você aprenderá a conectar o servidor MCP (Protocolo de Contexto de Modelo do Azure) à CLI do GitHub Copilot. Essa integração permite que o GitHub Copilot interaja com seus recursos do Azure diretamente do terminal.

Pré-requisitos

Entrar no Servidor MCP do Azure para desenvolvimento local

O Servidor MCP do Azure se autentica no Microsoft Entra ID usando a Azure Identity library for .NET. O servidor dá suporte a dois modos de autenticação:

  • Modo de agente: usa a autenticação nativa do sistema operacional (como o Gerenciador de Contas Web do Windows) com InteractiveBrowserCredential.
  • Modo de cadeia de credenciais: tenta vários métodos de autenticação em sequência: variáveis de ambiente, Visual Studio Code, Visual Studio, CLI do Azure, Azure PowerShell, CLI do Desenvolvedor do Azure e autenticação interativa do navegador.

Entre usando qualquer um destes métodos:

  1. Abra a Paleta de Comandos (Ctrl+Shift+P ou Cmd+Shift+P no Mac).
  2. Execute o comando Azure: Sign In e siga as instruções.

Depois de entrar, o Servidor MCP do Azure pode autenticar e executar operações nos serviços do Azure com base em suas permissões.

Adicionar servidor MCP do Azure

A CLI do GitHub Copilot dá suporte a servidores MCP por meio da /mcp família de comandos.

  1. Abra o terminal.

  2. Inicie a CLI do GitHub Copilot no modo interativo:

    copilot

  3. Na sessão interativa, execute o seguinte comando para abrir o formulário de configuração do servidor MCP:

    /mcp add

  4. Preencha os campos de configuração com os seguintes valores:

    Campo Valor
    Nome do Servidor azure-mcp
    Tipo de servidor 1 (Local)
    Command npx -y @azure/mcp@latest server start
    Variáveis de ambiente (deixe em branco – utiliza a autenticação da CLI do Azure)
    Ferramentas *

    Observação

    Se preferir usar o .NET, defina o Comando como dotnet dnx -p Azure.Mcp server start.

  5. Pressione Ctrl+S (ou Cmd+S no macOS) para salvar a configuração do servidor.

  6. Quando terminar, pressione esc para fechar a configuração do servidor.

Verificar conexão

Confirme se você configurou o Servidor MCP do Azure corretamente e se a CLI do GitHub Copilot o reconhece:

  1. Na sua sessão da CLI do Copilot, execute:

    /mcp show

  2. Revise a saída. Você deverá ver azure-mcp listado na configuração:

    ● MCP Server Configuration:
  • azure-mcp (local): Command: npx

Total servers: 1
Config file: ~/.copilot/mcp-config.json

Usar o Servidor MCP do Azure

Uma vez conectado, você pode usar a linguagem natural para interagir com seus recursos do Azure.

  1. Na sessão da CLI do GitHub Copilot, digite um prompt que exija contexto do Azure. Por exemplo:

    > List my Azure resource groups.

  2. O GitHub Copilot identifica a intenção e usa as azure-mcp ferramentas para buscar as informações. Ele imprime uma resposta listando seus grupos de recursos do Azure, semelhante a:

    I found the following resource groups in your subscription:

- **my-resource-group-1** (East US)
- **dev-environment** (West Europe)
- **production-app** (Central US)

Gerenciar os servidores MCP

Gerencie os servidores MCP configurados usando os seguintes comandos:

  • Listar servidores:/mcp show
  • Remova um servidor:/mcp remove azure-mcp
  • Obtenha ajuda:/mcp help

Próximas etapas

  • Last updated on