Edit

Share via

Get started with the Azure MCP Server in Cursor

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 using Cursor's AI-powered development environment
  • Run prompts to test Azure MCP Server operations and interact with Azure resources

Prerequisites

Note

The Azure resources you intend to access with Azure MCP Server must already exist within your Azure subscription. Additionally, your user account must have the necessary RBAC roles and permissions assigned for those resources.

Install the Azure MCP Server

To install and configure Azure MCP Server in Cursor:

  1. Navigate to File > Preferences > Cursor Settings

  2. Select Tools & Integrations from the left navigation.

  3. In the MCP Tools section of the page, select New MCP Server to open the mcp.json file for editing.

    A screenshot showing how to configure an MCP Server in Cursor.

  4. Add the following configuration to the mcpServers JSON object:

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

Use prompts to test the Azure MCP Server

  1. Open Cursor's AI chat interface by pressing Ctrl+L or clicking the chat icon in the sidebar.

  2. Enter a prompt that utilizes 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

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

  4. Cursor prompts you to run a tool to retrieve the storage accounts, such as storage account list. Select Run tool to continue.

    The output should resemble the following text:

    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 more Azure MCP operations 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