Introdução ao servidor MCP Azure no Google Antigravity

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
  • Conecte-se ao Servidor MCP do Azure usando o ambiente de desenvolvimento agent-first do Google Antigravity
  • Executar 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

Para instalar e configurar o servidor MCP Azure no Google Antigravity:

  1. No painel lateral do agente do editor, selecione ...>Servidores> MCPGerenciar servidores MCP.

    Uma captura de tela mostrando como adicionar um servidor MCP no painel do agente antigravidade.

  2. Em Gerenciar MCPs, selecione Exibir configuração bruta para abrir o mcp_config.json arquivo para edição.

    Antigravity lê a configuração do servidor MCP em um dos seguintes locais:

    • ~/.gemini/config/mcp_config.json para configurar o servidor globalmente para todos os workspaces.
    • .agents/mcp_config.json para configurar o servidor somente para o espaço de trabalho atual.

  3. Adicione a seguinte configuração ao mcpServers objeto no mcp_config.json arquivo:

    {
    "mcpServers": {
        "azure-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@azure/mcp@latest",
                "server",
                "start"
            ]
        }
    }
}

    Para obter mais informações, consulte a documentação do GOOGLE Antigravity MCP.

Autenticar no Azure

O servidor MCP do Azure fornece uma experiência de autenticação integrada usando contas Azure e Microsoft Entra ID. Para usar Azure SERVIDOR MCP, primeiro autentique-se para Azure usando ferramentas de desenvolvimento locais, como a CLI do Azure, a CLI do Desenvolvedor Azure, Visual Studio ou Visual Studio Code. O Azure MCP Server descobre automaticamente suas credenciais dessas ferramentas e as usa para se autenticar em 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 Azure que você pretende acessar usando Azure servidor MCP já devem existir em sua assinatura de Azure. Por exemplo, as atribuições de função comuns incluem:

    • Colaborador de Dados do Armazenamento de Blobs – 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.
    • Reader – acesso somente leitura aos recursos de Azure.

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

Usar comandos para testar o servidor Azure MCP

  1. Abra o painel lateral do agente no Google Antigravity.

  2. Insira um prompt que use os recursos do Servidor MCP do Azure, como:

    List my Azure storage accounts

  3. Se for solicitado que você se autentique no Azure, execute a ferramenta de autenticação sugerida para entrar pelo navegador.

    Note

    O Antigravity não solicitará que você faça login no Azure se já estiver autenticado usando outras ferramentas locais, como a CLI do Azure.

  4. O Antigravity solicita sua permissão para executar uma ou mais ferramentas do Azure MCP Server para obter as contas de armazenamento, como storage account list. Selecione a ação de permissão desejada para continuar.

    A saída se assemelha ao seguinte texto:

    The following storage accounts are available in your subscription:

1. **sttesting001** (Resource group: `rg-testing`, Location: `centralus`)
2. **stazddeploy** (Resource group: `rg-azd`, Location: `eastus2`)
3. **stmsdocssample** (Resource group: `msdocs-sample`, Location: `southcentralus`)
4. **staitesting** (Resource group: `ai-testing`, Location: `eastus2`)

Let me know if you need further details or actions related to any of these storage accounts!

  5. Explore mais operações do Azure MCP usando outros prompts relevantes, como:

    List all of the storage accounts in my subscription
Get the available tables in my storage accounts
Show me the configuration of my App Service instances

Próximas Etapas 

Aprenda mais sobre as ferramentas do Servidor MCP do Azure

  • Última atualização em