You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
17
+
The Azure MCP Server enables AI-powered development tools to interact with Azure cloud services through the Model Context Protocol (MCP). It provides a unified way to manage Azure resources, deploy applications, and query cloud services directly from your development environment.
17
18
18
-
::: zone pivot="mcp-github-copilot"
19
+
Azure MCP Server is designed to work across multiple tools, languages, frameworks, and use cases. You can use it to manage Azure resources through natural language conversations, build automation scripts, or integrate Azure operations into your applications.
You can also connect to Azure MCP Server using programming languages and frameworks. This documentation currently provides guidance and examples for Python and .NET.
[Get started with Azure MCP Server and Python](get-started/languages/python.md) to enhance your apps and workflows:
33
36
34
-
::: zone-end
37
+
- Use Python MCP client libraries to connect directly to Azure MCP Server.
38
+
- Build automation scripts that manage Azure resources.
39
+
- Integrate into web frameworks like Django, Flask, or FastAPI.
40
+
- Incorporate Azure operations into data science workflows with Jupyter notebooks.
35
41
36
-
##Next steps
42
+
### .NET
37
43
38
-
> [!div class="nextstepaction"]
39
-
> [Learn more about Azure MCP Server tools](tools/index.md)
44
+
[Get started with Azure MCP Server and .NET](get-started/languages/dotnet.md) to enhance your apps and workflows:
45
+
46
+
- Create console applications and command-line tools for Azure management.
47
+
- Build ASP.NET Core web applications with integrated Azure capabilities.
48
+
- Develop Azure Functions that leverage Azure MCP Server for resource management.
49
+
- Create Windows desktop applications with Azure integration.
50
+
51
+
The Azure MCP Server provides flexibility to work with Azure in the way that best fits your development style and requirements, whether through interactive AI-powered editors or programmatic integration in your applications.
In this article, you learn how to complete the following tasks:
17
+
18
+
- Install and authenticate to the Azure MCP Server
19
+
- Connect to Azure MCP Server using Cursor's AI-powered development environment
20
+
- Run prompts to test Azure MCP Server operations and interact with Azure resources
21
+
22
+
## Prerequisites
23
+
24
+
- An [Azure account](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio) with an active subscription
25
+
-[Cursor](https://cursor.sh/) - The AI-powered code editor
To install and configure Azure MCP Server in Cursor:
32
+
33
+
1. Navigate to **File > Preferences > Cursor Settings**
34
+
1. Select **Tools & Integrations** from the left navigation.
35
+
1. In the **MCP Tools** section of the page, select **New MCP Server** to open the `mcp.json` file for editing.
36
+
37
+
:::image type="content" source="../../media/cursor-configure-mcp-server.png" alt-text="A screenshot showing how to configure an MCP Server in Cursor.":::
38
+
39
+
1. Add the following configuration to the `mcpServers` JSON object:
40
+
41
+
```json
42
+
"Azure MCP Server": {
43
+
"command": "npx",
44
+
"args": [
45
+
"-y",
46
+
"@azure/mcp@latest",
47
+
"server",
48
+
"start"
49
+
]
50
+
}
51
+
```
52
+
53
+
## Use prompts to test the Azure MCP Server
54
+
55
+
1. Open Cursor's AI chat interface by pressing `Ctrl+L` or clicking the chat icon in the sidebar.
56
+
2. Enter a prompt that utilizes Azure MCP Server capabilities, such as:
57
+
58
+
```text
59
+
List my Azure storage accounts
60
+
```
61
+
62
+
3. If you're prompted to authenticate to Azure, run the suggested auth tool to sign-in through the browser.
63
+
64
+
> [!NOTE]
65
+
> Cursor doesn't prompt you to sign in to Azure if you're already authenticated via other local tooling such as the Azure CLI.
66
+
67
+
4. Cursor prompts you to run a tool to retrieve the storage accounts, such as `storage account list`. Select **Run tool** to continue.
68
+
69
+
The output should resemble the following text:
70
+
71
+
```output
72
+
The following resource groups are available for your subscription:
Select one of the following options to install the Azure MCP Server in Visual Studio Code:
18
33
19
-
## [Global install](#tab/one-click)
20
-
21
-
1. To install the Azure MCP Server for Visual Studio Code in your user settings, select the following link:
34
+
## [Extension install](#tab/one-click)
22
35
23
-
[](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D)
36
+
1. To install the [Azure MCP Server Extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-mcp-server), select the following link:
24
37
25
-
A list of installation options opens inside Visual Studio Code. Select **Install Server** to add the server configuration to your user settings.
38
+
[](vscode:extension/ms-azuretools.vscode-azure-mcp-server)
> For an optimal Azure MCP Server experience, [install GitHub Copilot for Azure](/azure/developer/github-copilot-azure/get-started), which includes and uses the Azure MCP Server extension. GitHub Copilot for Azure streamlines your development workflow and enhances your productivity on the Azure platform.
28
42
29
-
1.Open GitHub Copilot and select Agent Mode. To learn more about Agent Mode, visit the [Visual Studio Code Documentation](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode).
43
+
1.After you install the extension, open GitHub Copilot and select Agent Mode. To learn more about Agent Mode, visit the [Visual Studio Code Documentation](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode).
30
44
1. Refresh the tools list to see Azure MCP Server as an available option:
31
45
32
-
:::image type="content" source="../media/github-copilot-integration.png" alt-text="A screenshot showing Azure MCP Server as GitHub Copilot tool.":::
46
+
:::image type="content" source="../../media/github-copilot-integration.png" alt-text="A screenshot showing Azure MCP Server as GitHub Copilot tool.":::
33
47
34
48
## [Directory install](#tab/manual)
35
49
@@ -59,7 +73,7 @@ You can also manually install Azure MCP Server for a specific directory:
59
73
1. Open GitHub Copilot and select Agent Mode.
60
74
1. Select the tools icon to view the available tools. Search for *Azure MCP Server* to filter the results.
61
75
62
-
:::image type="content" source="../media/github-copilot-integration.png" alt-text="A screenshot showing Azure MCP Server as GitHub Copilot tool.":::
76
+
:::image type="content" source="../../media/github-copilot-integration.png" alt-text="A screenshot showing Azure MCP Server as GitHub Copilot tool.":::
63
77
64
78
To learn more about Agent Mode, visit the [Visual Studio Code Documentation](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode).
65
79
@@ -79,7 +93,7 @@ You can also manually install Azure MCP Server for a specific directory:
79
93
- **Current workspace** always runs the command for current Visual Studio Code workspace.
80
94
- **Always allow** sets the operation to always run for any GitHub Copilot Agent Mode session or any Visual Studio Code workspace.
81
95
82
-
:::image type="content" source="../media/run-command-prompt.png" alt-text="A screenshot showing the options available to run Azure MCP Server operations.":::
96
+
:::image type="content" source="../../media/run-command-prompt.png" alt-text="A screenshot showing the options available to run Azure MCP Server operations.":::
83
97
84
98
The output for the previous prompt should resemble the following text:
85
99
@@ -101,3 +115,8 @@ You can also manually install Azure MCP Server for a specific directory:
101
115
List all of the storage accounts in my subscription
102
116
Get the available tables in my storage accounts
103
117
```
118
+
119
+
## Next steps
120
+
121
+
> [!div class="nextstepaction"]
122
+
> [Learn more about Azure MCP Server tools](../../tools/index.md)
0 commit comments