Refine MCP documentation for clarity and consistency in quickstart guides

ggailey777 · ggailey777 · commit 155118c357c8 · 2026-02-23T00:02:35.000-08:00
diff --git a/articles/azure-functions/scenario-custom-remote-mcp-server.md b/articles/azure-functions/scenario-custom-remote-mcp-server.md
@@ -15,16 +15,15 @@ zone_pivot_groups: programming-languages-set-functions
 
 # Quickstart: Build a custom remote MCP server using Azure Functions
 
-In this quickstart, you create a custom remote Model Context Protocol (MCP) server from a template project using the Azure Developer CLI (`azd`). The MCP server uses the Azure Functions MCP server extension to provide tools for AI models, agents, and assistants. After running the project locally and verifying your code using GitHub Copilot, you deploy it to a new serverless function app in Azure Functions that follows current best practices for secure and scalable deployments.
+In this quickstart, you create a custom remote Model Context Protocol (MCP) server from a template project by using the Azure Developer CLI (`azd`). This MCP server uses the Azure Functions MCP server extension to provide tools for AI models, agents, and assistants. You can also use the MCP server extension to [create MCP Apps endpoints](./scenario-mcp-apps.md).
 
->[!TIP]  
->Functions also enables you to deploy an existing MCP server code project to a Flex Consumption plan app without having to make changes to your code project. For more information, see [Quickstart: Host existing MCP servers on Azure Functions](scenario-host-mcp-server-sdks.md). 
+After running the project locally and verifying your code by using GitHub Copilot, you deploy it to a new serverless function app in Azure Functions that follows current best practices for secure and scalable deployments. 
 
 Because the new app runs on the Flex Consumption plan, which follows a _pay-for-what-you-use_ billing model, completing this quickstart incurs a small cost of a few USD cents or less in your Azure account.
 
 ::: zone pivot="programming-language-javascript,programming-language-powershell"  
 > [!IMPORTANT]  
-> While [creating custom MCP servers](./functions-bindings-mcp.md) is supported for all Functions languages, this quickstart scenario currently only has examples for C#, Python, and TypeScript. To complete this quickstart, select one of these supported languages at the top of the article. 
+> While [creating custom MCP servers](./functions-bindings-mcp.md) is supported for all Functions languages, this quickstart scenario currently only has examples for C#, Java, Python, and TypeScript. To complete this quickstart, select one of these supported languages at the top of the article. 
 ::: zone-end  
 ::: zone pivot="programming-language-typescript"
 This article supports version 4 of the Node.js programming model for Azure Functions.
@@ -40,7 +39,7 @@ This article supports version 2 of the Python programming model for Azure Functi
 ::: zone-end  
 ::: zone pivot="programming-language-java"  
 + [Java 17 Developer Kit](/azure/developer/java/fundamentals/java-support-on-azure)
-    + If you use another [supported version of Java](supported-languages.md?pivots=programming-language-java#languages-by-runtime-version), you must update the project's pom.xml file. 
+    + If you use another [supported version of Java](supported-languages.md?pivots=programming-language-java#languages-by-runtime-version), update the project's `pom.xml` file. 
     + Set the `JAVA_HOME` environment variable to the install location of the correct version of the Java Development Kit (JDK).
 + [Apache Maven 3.8.x](https://maven.apache.org)  
 ::: zone-end  
@@ -123,7 +122,7 @@ Use the `azd init` command to create a local Azure Functions code project from a
 ## Run your MCP server locally 
 ::: zone-end  
 ::: zone pivot="programming-language-csharp"  
-In a terminal window, navigate to the `FunctionsMcpTool` project folder:
+In a terminal window, go to the `FunctionsMcpTool` project folder:
 
 ```console
 cd src/FunctionsMcpTool
@@ -133,9 +132,9 @@ cd src/FunctionsMcpTool
 
 [!INCLUDE [run-locally](../../includes/functions-mcp-run-locally.md)] 
 
-## Verify using GitHub Copilot
+## Verify by using GitHub Copilot
 
-The project template includes a `.vscode/mcp.json` file that already defines a `local-mcp-function` server pointing to your local MCP endpoint. Use this configuration to verify your code with GitHub Copilot in Visual Studio Code:
+The project template includes a `.vscode/mcp.json` file that already defines a `local-mcp-function` server pointing to your local MCP endpoint. Use this configuration to verify your code by using GitHub Copilot in Visual Studio Code:
 
 1. Open the `.vscode/mcp.json` file and select the **Start** button above the `local-mcp-function` configuration.
 
diff --git a/articles/azure-functions/scenario-mcp-apps.md b/articles/azure-functions/scenario-mcp-apps.md
@@ -8,23 +8,22 @@ ai-usage: ai-assisted
 ms.collection: 
   - ce-skilling-ai-copilot
 zone_pivot_groups: programming-languages-set-functions
-#Customer intent: As a developer, I want to create an MCP Apps  that returns interactive UI from my MCP tools, so AI clients can render rich visual experiences using Azure Functions.
+#Customer intent: As a developer, I want to create an MCP Apps server that returns interactive UI from my MCP tools, so AI clients can render rich visual experiences using Azure Functions.
 ---
 
 # Quickstart: Build an MCP Apps using Azure Functions
 
-In this quickstart, you create an [MCP App](https://blog.modelcontextprotocol.io/posts/2026-01-26-mcp-apps/) from a template project by using the Azure Developer CLI (`azd`). [MCP Apps](https://blog.modelcontextprotocol.io/posts/2026-01-26-mcp-apps/) is an extension of the Model Context Protocol (MCP) specification that lets tools return rich, interactive user interfaces (HTML/JavaScript in sandboxed iframes) instead of plain text. 
+In this quickstart, you create a Model Context Protocol (MCP) server from a template project by using the Azure Developer CLI (`azd`). This MCP server uses the Azure Functions MCP extension to return MCP Apps resources. 
 
-This quickstart will use the Azure Functions MCP extension to build an MCP App using the MCP tool and resource trigger. After running the project locally and verifying your code by using GitHub Copilot, you deploy it to a new serverless function app in Azure Functions that follows current best practices for secure and scalable deployments.
+[MCP Apps](https://blog.modelcontextprotocol.io/posts/2026-01-26-mcp-apps/) is an extension of the Model Context Protocol (MCP) specification that lets tools return rich, interactive user interfaces. You can also use the MCP server extension to [create text-based tool endpoints](./scenario-custom-remote-mcp-server.md). 
 
->[!TIP]  
->MCP tools built with the Azure Functions MCP extension don't have to return results in interactive UIs. If your server only needs text-based tools, see [Quickstart: Build a custom remote MCP server using Azure Functions](scenario-custom-remote-mcp-server.md).
+After running the project locally and verifying your code by using GitHub Copilot, you deploy it to a new serverless function app in Azure Functions that follows current best practices for secure and scalable deployments.
 
 Because the new app runs on the Flex Consumption plan, which follows a _pay-for-what-you-use_ billing model, completing this quickstart incurs a small cost of a few USD cents or less in your Azure account.
 
 ::: zone pivot="programming-language-javascript,programming-language-java"  
 > [!IMPORTANT]  
-> While [creating custom MCP servers](./functions-bindings-mcp.md) is supported for Java and JavaScript, this MCP Apps quickstart currently only has examples for C#, Python, and TypeScript. To complete this quickstart, select one of these supported languages at the top of the article. 
+> While [creating MCP Apps](./functions-bindings-mcp.md) is supported for Java and JavaScript, this quickstart currently only has examples for C#, Python, and TypeScript. To complete this quickstart, select one of these supported languages at the top of the article. 
 ::: zone-end  
 
 [!INCLUDE [functions-mcp-extension-powershell-note](../../includes/functions-mcp-extension-powershell-note.md)]  
@@ -86,14 +85,14 @@ Use the Azure Developer CLI to create an Azure Functions code project from a tem
 
 5. When prompted, enter `mcpweather-ts` as the environment name.
 
-    The command pulls the project files from the [template repository](https://github.com/Azure-Samples/remote-mcp-functions-typescript) and initializes the project in the current folder. In `azd`, the environment maintains a unique deployment context for your app, and you can define more than one. It's also used in names of the resources you create in Azure.   
+    The command pulls the project files from the [template repository](https://github.com/Azure-Samples/remote-mcp-functions-typescript) and initializes the project in the current folder. In `azd`, the environment maintains a unique deployment context for your app, and you can define more than one. It's also used in the names of the resources you create in Azure.   
 ::: zone-end
 ::: zone pivot="programming-language-python"  
 4. Search for and select **Remote MCP Functions with Python**.
 
 1. When prompted, enter `mcpweather-python` as the environment name.
 
-    The command pulls the project files from the [template repository](https://github.com/Azure-Samples/remote-mcp-functions-python) and initializes the project in the current folder. In `azd`, the environment maintains a unique deployment context for your app, and you can define more than one. It's also used in names of the resources you create in Azure. 
+    The command pulls the project files from the [template repository](https://github.com/Azure-Samples/remote-mcp-functions-python) and initializes the project in the current folder. In `azd`, the environment maintains a unique deployment context for your app, and you can define more than one. It's also used in the names of the resources you create in Azure. 
 ::: zone-end
 ::: zone pivot="programming-language-csharp,programming-language-python,programming-language-typescript" 
 ## Start the storage emulator
@@ -127,7 +126,7 @@ The MCP Apps weather tool includes a frontend application that you must build be
     cd ..
     ```
 
-1. In the `src` directory, create a virtual environment in which the app runs:
+1. In the `src` directory, create a virtual environment for running the app:
 
     ### [Bash](#tab/bash)
 
@@ -161,15 +160,15 @@ The MCP Apps weather tool includes a frontend application that you must build be
 ::: zone-end
 
 ::: zone pivot="programming-language-csharp"
-When Visual Studio Code asks you to pick a default project because there are two apps in the .NET template, pick **src/McpWeatherApp**. 
+When Visual Studio Code asks you to pick a default project because there are two apps in the .NET template, select **src/McpWeatherApp**. 
 ::: zone-end
 
 ::: zone pivot="programming-language-csharp,programming-language-python,programming-language-typescript" 
 [!INCLUDE [run-locally](../../includes/functions-mcp-run-locally.md)]
 
 ## Verify by using GitHub Copilot
 
-The project template includes a `.vscode/mcp.json` file that already defines a `local-mcp-function` server pointing to your local MCP endpoint. Use this configuration to verify your code with GitHub Copilot in Visual Studio Code:
+The project template includes a `.vscode/mcp.json` file that defines a `local-mcp-function` server pointing to your local MCP endpoint. Use this configuration to verify your code by using GitHub Copilot in Visual Studio Code:
 
 1. Open the `.vscode/mcp.json` file and select the **Start** button above the `local-mcp-function` configuration.
 
diff --git a/includes/functions-mcp-cleanup.md b/includes/functions-mcp-cleanup.md
@@ -10,7 +10,4 @@ When you're done working with your MCP server and related resources, use this co
 
 ```console
 azd down 
-```
-
-> [!NOTE]  
-> The `--no-prompt` option instructs `azd` to delete your resource group without confirmation from you. This command doesn't affect your local code project.
+```
