Merge pull request #2542 from MicrosoftDocs/main639021098604870557sync_temp

For protected branch, push strategy should use PR and merge to target branch method to work around git push error

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

docs/data-science/.openpublishing.redirection.data-science.json

@@ -136,11 +136,6 @@
         "redirect_url": "/fabric/data-science/ai-functions/pandas/translate",
         "redirect_document_id": true
       },
-      {
-        "source_path_from_root": "/docs/data-science/data-agent-mcp-server.md",
-        "redirect_url": "/fabric/data-science/concept-data-agent",
-        "redirect_document_id": false
-      },
       {
         "source_path_from_root": "/docs/data-science/data-agent-ai-search-index.md",
         "redirect_url": "/fabric/data-science/concept-data-agent",

docs/data-science/data-agent-mcp-server.md

@@ -0,0 +1,93 @@
+---
+title: Data agent as Model Context Protocol server (preview)
+description: Learn how to consume a data agent as MCP server.
+author: jonburchel
+ms.author: jburchel
+ms.reviewer: amjafari
+reviewer: amjafari
+ms.service: fabric
+ms.subservice: data-science
+ms.topic: how-to #Don't change
+ms.date: 12/18/2025
+ms.update-cycle: 180-days
+ms.collection: ce-skilling-ai-copilot
+#customer intent: As an Analyst, I want to consume a Fabric data agent as MCP server in VS Code.
+---
+
+# Consume Fabric data agent as a model context protocol server in Visual Studio Code
+
+The Model Context Protocol (MCP) server is an emerging standard in the AI landscape that allows AI systems to discover and interact with external tools in a structured way. It plays a critical role in enabling AI models to access and use external knowledge and capabilities. By using MCP servers, AI systems can extend beyond their own data and reasoning. MCP servers provide a way to expose tools and services to AI systems in a consistent, discoverable manner. They help organizations integrate their knowledge into AI workflows.
+
+> [!IMPORTANT]  
+> This feature is in [preview](../fundamentals/preview.md).
+
+[!INCLUDE [data-agent-prerequisites](./includes/data-agent-prerequisites.md)]
+
+## How it works
+
+Fabric data agents can also function as MCP servers. When used as an MCP server, a Fabric data agent exposes a single tool. This tool represents the data agent itself, so external AI systems can interact with it through the MCP protocol. Because of this, it's important to provide a detailed and accurate description when publishing a Fabric data agent. The description becomes the tool description for the MCP server. External AI systems use this description to determine when and how to invoke the data agent. A clear and comprehensive description ensures that the agent is correctly understood and can be effectively used in AI workflows.
+
+The Fabric data agent as an MCP server is valuable for people who build or test their own AI systems. It allows them to connect directly to the data agent and access organizational data that lives in Fabric OneLake without having to switch between different tools or platforms. This capability makes it easier to integrate organizational knowledge into AI experiments and development workflows, all within a single environment.
+
+   > [!NOTE]
+   > Currently, you can use the Fabric data agent MCP server only in **VS Code**. 
+
+:::image type="content" source="./media/data-agent-mcp-server/data-agent-mcp-server-not-published.png" alt-text="Screenshot showing the data agent MCP server before publishing." lightbox="./media/data-agent-mcp-server/data-agent-mcp-server-not-published.png":::
+
+To get started, after publishing the data agent, go to the **Settings** of the agent and open the **Model Context Protocol** tab. Here you see the following information:
+
+- **Data agent MCP server name**  
+- **MCP server URL**  
+- **Data agent MCP tool name**  
+- **MCP server tool description**  
+
+You can also download the **mcp.json** file from this tab. Use this file to configure the MCP server in VS Code.
+
+:::image type="content" source="./media/data-agent-mcp-server/data-agent-mcp-server-published.png" alt-text="Screenshot showing the data agent MCP server settings tab." lightbox="./media/data-agent-mcp-server/data-agent-mcp-server-published.png":::
+
+## Setting up the MCP server in VS Code
+
+1. Open **VS Code** and select a folder to work in.  
+1. Inside this folder, create a folder named **.vscode**.  
+1. Inside the inner folder, create a file called `mcp.json`.
+1. VS Code automatically displays a blue **Add Server** button at the bottom right of the window. 
+
+    :::image type="content" source="./media/data-agent-mcp-server/data-agent-mcp-json-vscode.png" alt-text="Screenshot showing the data agent MCP server json file." lightbox="./media/data-agent-mcp-server/data-agent-mcp-json-vscode.png":::
+
+1. Select **Add Server** and select **HTTP**. You're prompted to enter a URL. You can copy the **MCP server URL** from the Setting tab of the data agent as was shown earlier. 
+
+    :::image type="content" source="./media/data-agent-mcp-server/data-agent-mcp-server-select-http.png" alt-text="Screenshot showing the selection of HTTP." lightbox="./media/data-agent-mcp-server/data-agent-mcp-server-select-http.png":::
+
+    :::image type="content" source="./media/data-agent-mcp-server/data-agent-mcp-server-url.png" alt-text="Screenshot showing to enter the URL for MCP server." lightbox="./media/data-agent-mcp-server/data-agent-mcp-server-url.png":::
+
+1. Press **Enter** and provide a name for your MCP server. Use this name to display the data agent MCP server in your VS Code environment.  
+1. VS Code attempts to authenticate with the server. Select **Allow** and sign in with your credentials.  
+
+    :::image type="content" source="./media/data-agent-mcp-server/data-agent-mcp-json.png" alt-text="Screenshot showing to MCP file of the data agent." lightbox="./media/data-agent-mcp-server/data-agent-mcp-json.png":::
+
+## Enabling Agent Mode
+
+After adding the MCP server, enable **Agent Mode** in VS Code. Agent Mode lets VS Code act as an orchestrator interface, connecting your editor with MCP servers to interact with external tools like the Fabric data agent. To enable it:
+
+1. In VS Code, go to the **Command Palette** (Ctrl+Shift+P or Cmd+Shift+P).  
+1. Search for **Enable Agent Mode** and select it.  
+1. Confirm any prompts to activate the mode.  
+
+    :::image type="content" source="./media/data-agent-mcp-server/data-agent-vs-code-agent-mode.png" alt-text="Screenshot showing data agent in F studio code in agent mode." lightbox="./media/data-agent-mcp-server/data-agent-vs-code-agent-mode.png":::
+
+When Agent Mode is active, select an **orchestrator** to handle your queries. Available orchestrators in public preview include **GPT-5, GPT-4.1, Claude Sonnet 4.5, Gemini 2.5 pro**, and many more. The orchestrator manages the flow of information between your queries in VS Code and the Fabric data agent MCP server.
+
+## Using the Fabric Data Agent MCP Server
+
+When you enable Agent Mode and select the orchestrator:
+
+- You can start asking questions directly from VS Code.  
+- The orchestrator routes your queries to the Fabric data agent MCP server.  
+- The agent returns answers based on the knowledge it has access to, including organizational data stored in Fabric OneLake.  
+
+By functioning as an MCP server, the Fabric data agent allows users to integrate organizational knowledge into AI workflows, perform experiments, and develop AI solutions without leaving VS Code. This integration streamlines access to OneLake data and enhances productivity for developers and business users alike.
+
+## Related content
+
+- [Data agent concept](concept-data-agent.md)
+- [Data agent end-to-end tutorial](data-agent-end-to-end-tutorial.md)

docs/data-science/toc.yml

@@ -115,6 +115,8 @@ items:
           href: consume-data-agent-python.md
         - name: Consume a data agent from Microsoft 365 Copilot (preview)
           href: data-agent-microsoft-365-copilot.md  
+        - name: Consume a data agent as Model Context Protocol Server (preview)
+          href: data-agent-mcp-server.md       
     - name: Source Control, CI/CD, and ALM for Fabric data agent
       href: data-agent-source-control.md 
     - name: Fabric data agent end-to-end tutorial