Quickstart: Integrar Azure MCP Server com a CLI do GitHub Copilot

Neste quickstart, aprende a ligar o Azure Model Context Protocol (MCP) Server à CLI do GitHub Copilot. Ao usar esta integração, o GitHub Copilot pode interagir diretamente com os seus recursos do Azure a partir do seu terminal.

Pré-requisitos

Iniciar sessão no Azure MCP Server para desenvolvimento local

O Azure MCP Server autentica-se para o Microsoft Entra ID usando a biblioteca Azure Identity para .NET. O servidor suporta dois modos de autenticação:

  • Modo Broker: Utiliza a autenticação nativa do seu sistema operativo (como o Gestor de Contas Web do Windows) com InteractiveBrowserCredential.
  • Modo cadeia de credenciais: Tenta múltiplos métodos de autenticação em sequência: variáveis de ambiente, Visual Studio Code, Visual Studio, CLI do Azure, Azure PowerShell, Azure Developer CLI e autenticação interativa do navegador.

Inicie sessão usando qualquer um destes métodos:

  1. Abre a paleta de comandos (Ctrl+Shift+P ou Cmd+Shift+P no Mac).
  2. Execute o Azure: Inicie sessão e siga as indicações.

Após iniciar sessão, o Azure MCP Server pode autenticar e executar operações nos serviços Azure com base nas suas permissões.

Adicionar Servidor Azure MCP

A CLI do GitHub Copilot suporta servidores MCP através da família de /mcp comandos.

  1. Abre o teu terminal.

  2. Inicie a CLI do GitHub Copilot em 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)
    Comando npx -y @azure/mcp@latest server start
    Variáveis de ambiente (deixe em branco — usa autenticação CLI do Azure)
    Tools *

    Observação

    Se preferir usar .NET, defina o comando para dotnet dnx Azure.Mcp server start.

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

  6. Quando terminares, carrega em Esc para fechar a configuração do servidor.

Verificar a ligação

Confirme que configurou corretamente o Azure MCP Server e que a CLI do GitHub Copilot o reconhece:

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

    /mcp show

  2. Reveja o resultado. Deverás ver azure-mcp listado na configuração:

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

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

Utilize o Azure MCP Server

Depois de ligares o servidor, podes usar linguagem natural para interagir com os teus recursos do Azure.

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

    > List my Azure resource groups.

  2. O GitHub Copilot identifica a intenção e usa as azure-mcp ferramentas para obter a informação. Imprime uma resposta listando os 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 servidores MCP

Gere os seus servidores MCP configurados usando os seguintes comandos:

  • Servidores de lista:/mcp show
  • Remover um servidor:/mcp remove azure-mcp
  • Obtenha ajuda:/mcp help

Próximos passos

  • Last updated on