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
Copy file name to clipboardExpand all lines: concepts/mcp-server/use-microsoft-foundry.md
+20-16Lines changed: 20 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
-
title: Use Microsoft MCP Server for Enterprise in Azure AI Foundry
3
-
description: "Learn how to connect Microsoft MCP Server for Enterprise as a tool in your Azure AI Foundry agent to query enterprise identity data using natural language."
2
+
title: Use Microsoft MCP Server for Enterprise in Microsoft Foundry
3
+
description: "Learn how to connect Microsoft MCP Server for Enterprise as a tool in your Microsoft Foundry project to query Microsoft Entra data using natural language."
4
4
author: msewaweru
5
5
ms.author: eunicewaweru
6
6
ms.reviewer: FaithOmbongi
@@ -9,12 +9,12 @@ ms.topic: how-to
9
9
ms.date: 04/15/2026
10
10
ms.custom: msecd-doc-authoring-106
11
11
12
-
#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.
12
+
#customer intent: As a developer or an IT administrator, I want to integrate Microsoft MCP Server for Enterprise into my Microsoft Foundry agent so that I can query Microsoft Entra data using natural language.
13
13
---
14
14
15
-
# Use Microsoft MCP Server for Enterprise in Azure AI Foundry (preview)
15
+
# Use Microsoft MCP Server for Enterprise in Microsoft Foundry
16
16
17
-
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. Connect the MCP Server as a tool in your project and query your organization's data using natural language.
17
+
The [Microsoft MCP Server for Enterprise](overview.md) enables AI agents to query data in your Microsoft Entra tenant by using natural language. This article shows you how to connect the MCP Server as a tool in your Microsoft Foundry project and start querying your organization's data.
18
18
19
19
## Prerequisites
20
20
@@ -25,14 +25,15 @@ Microsoft MCP Server for Enterprise integrates with Azure AI Foundry as a tool,
25
25
-**Client secret** — Go to **Certificates & secrets** > **Client secrets** and create a new secret. Copy the secret **value** for use during setup.
26
26
- Assign the `MCP.*` API permissions to your app registration and grant admin consent. For more information, see [MCP Server for Enterprise documentation](https://aka.ms/MCPServerForEnterprise).
27
27
- At least [**Cloud Application Administrator**](/entra/identity/role-based-access-control/permissions-reference#cloud-application-administrator) role to create the app registration and grant admin consent.
28
-
- An Azure AI Foundry project with at least one agent configured.
29
-
- At least [**Azure AI Developer**](/azure/role-based-access-control/built-in-roles/ai-machine-learning#azure-ai-developer) role scoped to the Azure AI Foundry project resource to connect tools and use agents.
28
+
- Appropriate Microsoft Entra directory roles for the Microsoft Graph operations your agent performs. The MCP Server executes Graph API calls on behalf of the signed-in user.
29
+
- A Microsoft Foundry project with at least one agent configured.
30
+
- At least [**Azure AI Developer**](/azure/role-based-access-control/built-in-roles/ai-machine-learning#azure-ai-developer) role scoped to the Microsoft Foundry project resource to connect tools and use agents.
30
31
31
-
## Connect the MCP Server as a tool in Azure AI Foundry
32
+
## Connect the MCP Server as a tool in Microsoft Foundry
32
33
33
34
Use the custom OAuth provider option to connect your app registration to the Microsoft MCP Server for Enterprise endpoint.
34
35
35
-
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.
36
+
1. In the [Microsoft Foundry portal](https://ai.azure.com/), make sure you're using the **New Foundry** UI and navigate to your project.
36
37
37
38
1. In the sidebar menu, select **Tools**, and then select **Connect a tool**.
38
39
@@ -41,10 +42,13 @@ Use the custom OAuth provider option to connect your app registration to the Mic
41
42
1. For **OAuth Provider**, select **Custom** to use your own OAuth app registration for token exchange.
42
43
43
44
1. Provide the following configuration:
44
-
-**Name**: Enter a unique identifier for the tool connection.
45
-
-**Client ID**: Enter the application (client) ID from your app registration.
46
-
-**Client Secret**: Enter the client secret value from your app registration.
47
-
-**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.
45
+
46
+
| Field | Value |
47
+
|---|---|
48
+
|**Name**| Enter a unique identifier for the tool connection. |
49
+
|**Client ID**| The application (client) ID from your app registration. |
50
+
|**Client Secret**| The client secret value from your app registration. |
51
+
|**Token URL**, **Auth URL**, and **Refresh URL**| These fields are prepopulated. Replace `organizations` with your tenant ID if your Microsoft Foundry project and app registration are in different tenants. Otherwise, leave `organizations` as the default value. |
48
52
49
53
1. Select **Connect**, and then copy the **Redirect URL** provided.
50
54
@@ -54,7 +58,7 @@ Use the custom OAuth provider option to connect your app registration to the Mic
54
58
55
59
After you connect the Microsoft MCP Server for Enterprise tool, add it to an agent and start querying your organization's data using natural language.
56
60
57
-
1. In the Azure AI Foundry sidebar, go to **Agents** and select an existing agent or create a new one.
61
+
1. In the Microsoft Foundry sidebar, go to **Agents** and select an existing agent or create a new one.
58
62
59
63
1. In the agent configuration, add the Microsoft MCP Server for Enterprise tool you connected in the previous section.
60
64
@@ -64,7 +68,7 @@ When you first use the tool, the agent prompts you to sign in and authorize acce
64
68
65
69
1. Select **Open consent** when prompted to sign in.
66
70
67
-
1. Follow the authentication prompts to grant access. After you consent, you don't need to sign in again for future queries in the same project.
71
+
1. Follow the authentication prompts to grant access. You typically don't need to sign in again until the connection expires or is disconnected.
68
72
69
73
1. Approve each MCP tool call as prompted during query execution.
70
74
@@ -80,4 +84,4 @@ After you sign in, you can ask questions such as:
80
84
81
85
-[Overview of Microsoft MCP Server for Enterprise](overview.md)
82
86
-[Sample prompts for Microsoft MCP Server for Enterprise](mcp-server-sample-prompts.md)
83
-
-[Set up authentication for MCP tools in Azure AI Foundry](/azure/foundry/agents/how-to/mcp-authentication)
87
+
-[Set up authentication for MCP tools in Microsoft Foundry](/azure/foundry/agents/how-to/mcp-authentication)
0 commit comments