From 8a94d3a1f7652e7544a14769d33560eee391cab8 Mon Sep 17 00:00:00 2001 From: JulianTillmann <35929603+JulianTillmann@users.noreply.github.com> Date: Fri, 14 Nov 2025 16:34:57 +0100 Subject: [PATCH 1/2] Revise setup instructions for Business Central MCP Updated the README to clarify setup instructions for Business Central MCP Server and added details for configuring Business Central and VS Code. --- samples/BcMCPProxy/README.md | 46 +++++++++++++++++++++++++++++++++--- 1 file changed, 43 insertions(+), 3 deletions(-) diff --git a/samples/BcMCPProxy/README.md b/samples/BcMCPProxy/README.md index 7511fc70..ac714c41 100644 --- a/samples/BcMCPProxy/README.md +++ b/samples/BcMCPProxy/README.md @@ -36,7 +36,17 @@ The BC MCP Proxy acts as a bridge between MCP-compatible clients (like Claude De - `Financials.ReadWrite.All` (Delegated) - `user_impersonation` (Delegated) -### 2. Set-up Claude with Business Central MCP Server +### 2. Set-up Business Central Environment + +1. Set-Up "Model Context Protocol (MCP) Server Configurations" (Page-Id 8350) + +Create a new MCP configuration with the API pages as tools as needed. + +2. Enable "Feature: Enable MCP Server access" in Feature Management (Page-Id 2610) + +Enable Feature for all users, if not enabled. + +### 3.a) Set-up Claude with Business Central MCP Server 1. **Download and Install Claude Desktop** - Download Claude for desktop from the official website @@ -78,7 +88,7 @@ The BC MCP Proxy acts as a bridge between MCP-compatible clients (like Claude De - ``: The Application (client) ID from your Azure app registration - ``: Name of your Business Central environment - ``: Business Central company name - - ``: Name of the Business Central configuration + - ``: Name of the Business Central "Model Context Protocol (MCP) Server Configurations" configuration as defined in Step 2 4. **Restart Claude Desktop** @@ -86,6 +96,36 @@ The BC MCP Proxy acts as a bridge between MCP-compatible clients (like Claude De ![Claude BC MCP Tools](./docs/images/claude-bc-tools.png) +### 3.b) Set-up VS code with Business Central MCP Server + +Edit or Create mcp configuration file at "$env:APPDATA\Code\User\mcp.json" + ```json +"BC_MCP": { + "type": "stdio", + "args": [ + "--TenantId", + "", + "--ClientId", + "", + "--Environment", + "", + "--Company", + "", + "--ConfigurationName", + "" + ], + "command": "C:\\Path\\To\\BcMCPProxy.exe", + } +``` + + **Parameter Details:** + - ``: Your Azure tenant ID + - ``: The Application (client) ID from your Azure app registration + - ``: Name of your Business Central environment + - ``: Business Central company name + - ``: Name of the Business Central "Model Context Protocol (MCP) Server Configurations" configuration as defined in Step 2 + + ## Usage Once configured, you can interact with Business Central through natural language in Claude Desktop. The MCP server will handle authentication and API calls to your Business Central environment. @@ -137,4 +177,4 @@ This is an experimental tool provided as-is for development and testing purposes ## License -This project is subject to the Microsoft sample code license terms. \ No newline at end of file +This project is subject to the Microsoft sample code license terms. From 917d80c68cac80c7017e6b8d3a3b540a35ceee24 Mon Sep 17 00:00:00 2001 From: JulianTillmann <35929603+JulianTillmann@users.noreply.github.com> Date: Fri, 14 Nov 2025 16:39:32 +0100 Subject: [PATCH 2/2] Enhance formatting in README.md for clarity Formatted the README.md for better readability by using bold for section titles and improving list indentation. --- samples/BcMCPProxy/README.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/samples/BcMCPProxy/README.md b/samples/BcMCPProxy/README.md index ac714c41..d966db7d 100644 --- a/samples/BcMCPProxy/README.md +++ b/samples/BcMCPProxy/README.md @@ -38,13 +38,13 @@ The BC MCP Proxy acts as a bridge between MCP-compatible clients (like Claude De ### 2. Set-up Business Central Environment -1. Set-Up "Model Context Protocol (MCP) Server Configurations" (Page-Id 8350) +1. **Set-Up "Model Context Protocol (MCP) Server Configurations" (Page-Id 8350)** -Create a new MCP configuration with the API pages as tools as needed. + - Create a new MCP configuration with the API pages as tools as needed. -2. Enable "Feature: Enable MCP Server access" in Feature Management (Page-Id 2610) +2. **Enable "Feature: Enable MCP Server access" in Feature Management (Page-Id 2610)** -Enable Feature for all users, if not enabled. + - Enable Feature for all users, if not enabled. ### 3.a) Set-up Claude with Business Central MCP Server @@ -125,6 +125,7 @@ Edit or Create mcp configuration file at "$env:APPDATA\Code\User\mcp.json" - ``: Business Central company name - ``: Name of the Business Central "Model Context Protocol (MCP) Server Configurations" configuration as defined in Step 2 +Reload Window or Restart VS-Code ## Usage