Edits

Author: msewaweru

concepts/mcp-server/use-azure-ai-foundry.md

@@ -6,88 +6,84 @@ ms.author: eunicewaweru
 ms.reviewer: FaithOmbongi
 ms.subservice: ent-mcp-server
 ms.topic: how-to
-ms.date: 03/03/2026
+ms.date: 04/08/2026
+ms.custom: msecd-doc-authoring-106
 
 #customer intent: As a developer or IT administrator, I want to integrate Microsoft MCP Server for Enterprise into my Azure AI Foundry agent so that I can query Microsoft Entra data using natural language.
 ---
 
 # Use Microsoft MCP Server for Enterprise in Azure AI Foundry (preview)
 
-Microsoft MCP Server for Enterprise can be integrated with Azure AI Foundry as a tool, enabling your AI agents to query Microsoft Entra data using natural language. This article explains how to configure and use the MCP Server in your Azure AI Foundry project.
+Microsoft MCP Server for Enterprise integrates with Azure AI Foundry as a tool, enabling your AI agents to query Microsoft Entra data using natural language. This article walks you through creating an app registration, connecting the MCP Server as a tool, and querying your organization's data from your Azure AI Foundry project.
+
+## Prerequisites
 
 > [!IMPORTANT]
-> Microsoft MCP Server for Enterprise is currently in Preview.
-> This information relates to a prerelease product that may be substantially modified before it's released. Microsoft makes no warranties, expressed or implied, with respect to the information provided here.
+> Microsoft MCP Server for Enterprise is currently in preview. This information relates to a prerelease product that might be substantially modified before it's released. Microsoft makes no warranties, expressed or implied, with respect to the information provided here.
 >
 > Microsoft MCP Server for Enterprise is offered under the [Microsoft APIs Terms of Use](/legal/microsoft-apis/terms-of-use).
 
-## Prerequisites
-
-Before you begin, ensure you have:
-
-- An Azure AI Foundry project and agent
-- Completed the [quick start steps](get-started.md) to provision the Microsoft MCP Server for Enterprise
-- **Application Administrator** or **Cloud Application Administrator** role in your Microsoft Entra tenant to create and configure app registrations and grant admin consent for API permissions
-- **Contributor** or higher permissions on the Azure AI Foundry project resource to connect tools
+- An Azure AI Foundry project and agent.
+- Completion of [Get started with the Microsoft MCP Server for Enterprise](get-started.md) to provision the MCP Server.
+- At least **Application Administrator** or **Cloud Application Administrator** role in your Microsoft Entra tenant to create and configure app registrations and grant admin consent for API permissions.
+- At least [**Contributor**](/azure/role-based-access-control/built-in-roles/general#contributor) permissions scoped to the Azure AI Foundry project resource to connect tools.
 
 ## Create and configure an app registration
 
-To enable authentication between Azure AI Foundry and Microsoft MCP Server for Enterprise, you need to create a Microsoft Entra app registration and configure the necessary API permissions.
-
-1. Follow the [app registration guide](../app-registration.md) to create a Microsoft Entra app and obtain the client ID.
+To enable authentication between Azure AI Foundry and Microsoft MCP Server for Enterprise, create a Microsoft Entra app registration and grant the necessary API permissions.
 
-1. In your app registration, navigate to **Manage** > **API Permissions**.
+1. Follow the [app registration guide](../app-registration.md) to create a Microsoft Entra app and get the client ID.
 
-1. Select **Add a permission**, then search for **Microsoft MCP Server for Enterprise**.
+1. In your app registration, go to **Manage** > **API Permissions**.
 
-1. Select the permissions required for your scenarios.
+1. Select **Add a permission**, and then search for **Microsoft MCP Server for Enterprise**.
 
-1. Select **Grant admin consent for [your tenant]** to authorize the permissions.
+1. Select the permissions required for your scenarios, and then select **Grant admin consent for [your tenant]** to authorize the permissions.
 
 ## Connect the MCP Server as a tool in Azure AI Foundry
 
-After creating and configuring your app registration, connect the Microsoft MCP Server for Enterprise as a tool in your Azure AI Foundry project.
+After you configure your app registration, connect the Microsoft MCP Server for Enterprise as a tool in your Azure AI Foundry project.
 
-1. In the [Azure AI Foundry portal](https://ai.azure.com/), ensure you're using the "New Foundry" UI and navigate to your project.
+1. In the [Azure AI Foundry portal](https://ai.azure.com/), make sure you're using the **New Foundry** UI and navigate to your project.
 
-1. In the sidebar menu, select **Tools**, then search for **Microsoft MCP Server for Enterprise** in the **Catalog**.
+1. In the sidebar menu, select **Tools**, and then select **Connect a tool**.
 
-1. Select **Connect** to begin the configuration.
+1. Under **Catalog**, search for **Microsoft MCP Server for Enterprise**, and then select **Create**.
 
 1. Provide the following configuration:
-   - **Name**: Enter a unique identifier for the tool
-   - **Client ID**: Enter the app registration client ID from the previous section
-   - **Token URL, Auth URL, and Refresh URL**: Replace `organizations` with your tenant ID if your Azure AI Foundry project and app registration are in different tenants; otherwise, leave as `organizations`
+   - **Name**: Enter a unique identifier for the tool.
+   - **Client ID**: Enter the app registration client ID from the previous section.
+   - **Token URL, Auth URL, and Refresh URL**: Replace `organizations` with your tenant ID if your Azure AI Foundry project and app registration are in different tenants. Otherwise, leave `organizations` as the default value.
 
-1. Select **Connect** and copy the **Redirect URL** provided.
+1. Select **Connect**, and then copy the **Redirect URL** provided.
 
-1. Return to your Microsoft Entra app registration, navigate to **Authentication**, add the Redirect URL, and save your changes.
+1. Return to your Microsoft Entra app registration, go to **Authentication**, add the Redirect URL, and save your changes.
 
 ## Query Microsoft Entra data
 
-After connecting the Microsoft MCP Server for Enterprise tool to your Azure AI Foundry agent, you can query your organization's data using natural language.
+After you connect the Microsoft MCP Server for Enterprise tool, add it to your agent and start querying your organization's data using natural language.
 
 ### Sign in and authorize access
 
-When you first invoke the tool, you need to sign in and authorize access.
+When you first use the tool, sign in and authorize access.
 
 1. Select **Open consent** when prompted to sign in.
 
 1. Follow the authentication prompts to grant access.
 
-1. If sign-in fails, an error code appears in the `/closeme` window. Decode this base64-encoded value to view detailed error information.
+1. If sign-in fails, an error code appears in the `/closeme` window. Decode this base64-encoded value to view the detailed error information.
 
 1. Approve each MCP tool call as prompted during query execution.
 
 ### Example queries
 
-You can ask questions such as:
+After you sign in, you can ask questions such as:
 
 - "How many users are in my tenant?"
 - "Which users haven't signed in for the last 30 days?"
-- "Show me all guest users with admin roles"
+- "Show me all guest users with admin roles."
 
-## Next steps
+## Related content
 
 - [Overview of Microsoft MCP Server for Enterprise](overview.md)
 - [Sample prompts for Microsoft MCP Server for Enterprise](mcp-server-sample-prompts.md)