Edit

Get started with the Azure MCP Server in Google Antigravity

The Azure MCP Server uses the Model Context Protocol (MCP) to standardize integrations between AI apps and external tools and data sources, allowing for AI systems to perform operations that are context-aware of your Azure resources.

In this article, you learn how to complete the following tasks:

  • Install and authenticate to the Azure MCP Server
  • Connect to Azure MCP Server by using Google Antigravity's agent-first development environment
  • Run prompts to test Azure MCP Server operations and interact with Azure resources

Prerequisites

Install the Azure MCP Server

To install and configure the Azure MCP Server in Google Antigravity:

  1. In the editor's agent side panel, select ... > MCP Servers > Manage MCP Servers.

    A screenshot showing how to add an MCP Server in the Antigravity agent panel.

  2. On Manage MCPs, select View raw config to open the mcp_config.json file for editing.

    Antigravity reads MCP server configuration from one of the following locations:

    • ~/.gemini/config/mcp_config.json to configure the server globally for all workspaces.
    • .agents/mcp_config.json to configure the server for the current workspace only.

  3. Add the following configuration to the mcpServers object in the mcp_config.json file:

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

    For more information, see the Google Antigravity MCP documentation.

Authenticate to Azure

Azure MCP Server provides a seamless authentication experience using Azure accounts and Microsoft Entra ID. To use Azure MCP Server, first authenticate to Azure by using local development tools such as the Azure CLI, Azure Developer CLI, Visual Studio, or Visual Studio Code. Azure MCP Server automatically discovers your credentials from these tools and uses them to authenticate to Azure services.

  1. For example, to sign in using the Azure CLI:

    az login

  2. Verify your authentication status by running the following command to see which account and subscription you're currently signed in with:

    az account show

  3. Ensure your user account has the appropriate role assignments for the Azure services you want to interact with. The Azure resources you intend to access by using Azure MCP Server must already exist within your Azure subscription. For example, common role assignments include:

    • Blob Storage Data Contributor - Read and write blob data in storage accounts.
    • Storage Account Contributor - Manage storage account configurations.
    • Contributor - General resource management across your subscription.
    • Reader - Read-only access to Azure resources.

    For more information about role assignments and local development authentication, see Authenticate .NET apps to Azure services during local development.

Use prompts to test the Azure MCP Server

  1. Open the agent side panel in Google Antigravity.

  2. Enter a prompt that uses Azure MCP Server capabilities, such as:

    List my Azure storage accounts

  3. If you're prompted to authenticate to Azure, run the suggested auth tool to sign in through the browser.

    Note

    Antigravity doesn't prompt you to sign in to Azure if you're already authenticated through other local tooling such as the Azure CLI.

  4. Antigravity prompts you for permission to run one or more Azure MCP Server tools to retrieve the storage accounts, such as storage account list. Select your desired allow action to continue.

    The output resembles the following text:

    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 more Azure MCP operations by using other relevant prompts, such as:

    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

Next steps

Learn more about Azure MCP Server tools

  • Last updated on