Merge pull request #8055 from MicrosoftDocs/main

Auto Publish – main to live - 2025-10-28 17:00 UTC

Author: learn-build-service-prod[bot]

.openpublishing.redirection.json

@@ -1903,6 +1903,10 @@
       "source_path": "articles/azure-mcp-server/tools/cosmos-db.md",
       "redirect_url": "/azure/developer/azure-mcp-server/tools/azure-cosmos-db"
     },
+    {
+      "source_path": "articles/azure-mcp-server/tools/azure-developer-cli.md",
+      "redirect_url": "/azure/developer/azure-mcp-server/tools/azure-cli"
+    },
     {
       "source_path": "articles/github-copilot-azure/quickstart-build-deploy-applications.md",
       "redirect_url": "/azure/developer/github-copilot-azure/quickstart-deploy-app-agent-mode"

articles/azure-mcp-server/TOC.yml

@@ -80,7 +80,7 @@ items:
         - name: Azure Deploy
           href: tools/azure-deploy.md
         - name: Azure Developer CLI
-          href: tools/azure-developer-cli.md
+          href: tools/azure-cli.md
         - name: Azure Event Grid
           href: tools/azure-event-grid.md
         - name: Azure Event Hubs

articles/azure-mcp-server/get-started.md

@@ -3,7 +3,7 @@ title: Get started with the Azure MCP Server
 description: Overview of the options for using the Azure MCP Server with tools and languages
 author: alexwolfmsft
 ms.author: alexwolf
-ms.date: 10/20/2025
+ms.date: 10/27/2025
 ms.topic: get-started
 content_well_notification: 
   - AI-contribution
@@ -15,17 +15,19 @@ ms.custom: build-2025
 
 The [Azure MCP Server](overview.md) 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.
 
-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.
+Connect to Azure MCP Server using various tools, languages, and frameworks. Use it to manage Azure resources through natural language conversations, build automation scripts, or integrate Azure operations into your applications.
 
-You can also explore and contribute to the [Azure MCP Server on GitHub](https://github.com/microsoft/mcp/tree/main/servers/Azure.Mcp.Server).
+Explore and contribute to the [Azure MCP Server on GitHub](https://github.com/microsoft/mcp/tree/main/servers/Azure.Mcp.Server).
 
 ## Install with a package manager
 
 If you prefer to install Azure MCP Server directly using a package manager instead of through an IDE, you can install it using npm, pip, or other package managers. For detailed installation instructions, see [Install with a package manager](https://github.com/microsoft/mcp/blob/main/servers/Azure.Mcp.Server/README.md#package-manager).
 
-## Use a code editor
+## Connect using code editors and tools
 
-Azure MCP Server works with AI-powered code editors that support the Model Context Protocol. Learn how to get started with the following code editors:
+Azure MCP Server works with AI-powered code editors and tools that support the Model Context Protocol. Learn how to get started:
+
+### Code editors
 
 - [**Cline**](get-started/tools/cline.md)
 - [**Cursor**](get-started/tools/cursor.md)
@@ -34,13 +36,17 @@ Azure MCP Server works with AI-powered code editors that support the Model Conte
 - [**Visual Studio Code**](get-started/tools/visual-studio-code.md)
 - [**Windsurf**](get-started/tools/windsurf.md)
 
-## Use languages & frameworks
+### Other tools and services
+
+- [GitHub Copilot coding agent](/azure/developer/azure-mcp-server/how-to/github-copilot-coding-agent)
+
+## Connect using languages & frameworks
 
-You can also connect to Azure MCP Server using programming languages and frameworks. This documentation currently provides guidance and examples for Python and .NET.
+Connect to Azure MCP Server using programming languages and frameworks. This documentation currently provides guidance and examples for Python and .NET.
 
 ### Python
 
-[Get started with Azure MCP Server and Python](get-started/languages/python.md) to enhance your apps and workflows:
+[Get started with Azure MCP Server and Python](get-started/languages/python.md) to enhance your apps and workflows.
 
 - Use Python MCP client libraries to connect directly to Azure MCP Server.
 - Build automation scripts that manage Azure resources.
@@ -49,7 +55,7 @@ You can also connect to Azure MCP Server using programming languages and framewo
 
 ### .NET
 
-[Get started with Azure MCP Server and .NET](get-started/languages/dotnet.md) to enhance your apps and workflows:
+[Get started with Azure MCP Server and .NET](get-started/languages/dotnet.md) to enhance your apps and workflows.
 
 - Create console applications and command-line tools for Azure management.
 - Build ASP.NET Core web applications with integrated Azure capabilities.

articles/azure-mcp-server/includes/security-local-development.md

@@ -0,0 +1,8 @@
+---
+author: diberry
+ms.service: azure
+ms.topic: include
+ms.author: diberry
+ms.date: 08/27/2025
+---
+The MCP server uses your Azure user credentials or managed identity to ensure authorized access. Access is secured through Azure Role-Based Access Control (RBAC), providing fine-grained permissions for approved users. The local MCP server is intended strictly for developer use within your organization. Don't use these tools for external applications or scenarios outside the approved development environment.

articles/azure-mcp-server/includes/tools/supported-azure-services.md

@@ -31,7 +31,7 @@ Azure MCP Server provides the following tools for Azure services and Azure-relat
 | [Azure Database for MySQL](../../tools/azure-mysql.md) | Manage Azure Database for MySQL servers, databases, and tables. |
 | [Azure Database for PostgreSQL](../../tools/azure-database-postgresql.md) | Manage Azure Database for PostgreSQL servers, databases, and tables. |
 | [Azure Deploy](../../tools/azure-deploy.md) | Deploy and manage Azure resources using templates and scripts. |
-| [Azure Developer CLI](../../tools/azure-developer-cli.md) | Execute Azure Developer CLI commands for application development and deployment. |
+| [Azure Developer CLI](../../tools/azure-cli.md) | Get installation instructions for Azure Developer CLI (azd), learn usage for deployment scenarios, and access azd MCP tools when azd is installed locally |
 | [Azure Event Grid](../../tools/azure-event-grid.md) | Manage Azure Event Grid resources, including topics and subscriptions. |
 | [Azure Event Hubs](../../tools/azure-event-hubs.md) | Manage Azure Event Hubs namespaces and event hubs. |
 | [Azure Functions](../../tools/azure-functions.md) | List Azure Functions. |

articles/azure-mcp-server/index.yml

@@ -20,7 +20,7 @@ landingContent:
       - linkListType: how-to-guide
         links:
           - text: Install in an IDE
-            url: get-started.md#use-a-code-editor
+            url: get-started.md#connect-using-code-editors-and-tools
           - text: Install with a package manager
             url: get-started.md#install-with-a-package-manager
           - text: Connect GitHub Copilot coding agent to the Azure MCP Server
@@ -76,7 +76,7 @@ landingContent:
           - text: Azure Cosmos DB
             url: tools/azure-cosmos-db.md
           - text: Azure Developer CLI
-            url: tools/azure-developer-cli.md
+            url: tools/azure-cli.md
           - text: Azure Key Vault
             url: tools/azure-key-vault.md
           - text: Azure Monitor

articles/azure-mcp-server/overview.md

@@ -35,6 +35,9 @@ The most common scenario for using the Azure MCP Server is to connect to it from
 
 In more advanced scenarios, some developers may create their own MCP servers to offer custom tools, resources, and prompts for specific tasks that involve Azure resources. If you're building an MCP server that needs to connect with Azure, you can use the Azure MCP Server tools from your MCP server.
 
+
+[!INCLUDE [security-developer-environment](./includes/security-local-development.md)]
+
 ## Related content
 
 - [Get started using the Azure MCP Server](get-started.md)

articles/azure-mcp-server/tools/azure-cli.md

@@ -4,7 +4,7 @@ description: Learn how to use Azure CLI tools with the Azure MCP Server to gener
 keywords: azure mcp server, azmcp, azure cli extension
 author: diberry
 ms.author: diberry
-ms.date: 10/15/2025
+ms.date: 10/27/2025
 content_well_notification: 
   - AI-contribution
 ai-usage: ai-assisted
@@ -36,12 +36,13 @@ The Azure MCP Server generates Azure CLI commands to accomplish specific goals.
 
 ## Get CLI installation instructions
 
-The Azure MCP Server provides installation instructions for CLI tools including Azure CLI (az), Azure Developer CLI (azd), and Azure Functions Core Tools CLI (func). It incorporates knowledge of the CLI tool beyond what the LLM knows. Use this tool to get installation instructions if you attempt to use the CLI tool but it's not installed.
+The Azure MCP Server provides installation instructions for CLI tools including Azure CLI (`az`), Azure Developer CLI (`azd`), and Azure Functions Core Tools CLI (`func`). It incorporates knowledge of the CLI tool beyond what the LLM knows. Use this tool to get installation instructions if you attempt to use the CLI tool but it's not installed.
 
 **Example prompts** include:
 
 - **Azure CLI installation**: "How do I install the `az` CLI?"
 - **Azure Developer CLI installation**: "Show me how to install `azd`"
+- **Azure Functions Core tools**: "What is Azure Functions Core tools and how to install it"
 
 | Parameter | Required or optional | Description |
 |-----------|-------------|-------------|
@@ -52,3 +53,4 @@ The Azure MCP Server provides installation instructions for CLI tools including
 - [What are the Azure MCP Server tools?](index.md)
 - [Get started using Azure MCP Server](../get-started.md)
 - [Azure CLI reference documentation](/cli/azure/reference-index)
+- [Azure Developer CLI reference documentation](/azure/developer/azure-developer-cli)

articles/azure-mcp-server/tools/azure-developer-cli.md

@@ -13,14 +13,19 @@ ms.custom: build-2025
 ---
 # What are the Azure MCP Server tools?
 
-The Azure Model Context Protocol (MCP) Server exposes many tools you can use from an existing [client](../get-started.md?tabs=one-click%2Cazure-cli&pivots=mcp-github-copilot) to interact with Azure services through natural language prompts. For example, you can use the Azure MCP Server to interact with Azure resources conversationally from GitHub Copilot agent mode in Visual Studio Code or other AI agents with commands like these:
+The Azure Model Context Protocol (MCP) Server exposes many tools you can use from an existing [client](../get-started.md#use-a-code-editor) to interact with Azure services through natural language prompts. For example, you can use the Azure MCP Server to interact with Azure resources conversationally from GitHub Copilot agent mode in Visual Studio Code or other AI agents with commands like these:
 
 - "Show me all my resource groups"
 - "List blobs in my storage container named 'documents'"
 - "What's the value of the 'ConnectionString' key in my app configuration?"
 - "Query my log analytics workspace for errors in the last hour"
 - "Show me all my Cosmos DB databases"
 
+## Developer credentials and security
+
+[!INCLUDE [security-developer-environment](../includes/security-local-development.md)]
+
+
 [!INCLUDE [server start options](../includes/tools/server-start-options.md)]
 
 [!INCLUDE [global-params](../includes/tools/global-parameters-list.md)]