diff --git a/samples/BcMCPProxy/README.md b/samples/BcMCPProxy/README.md index 7511fc70..d966db7d 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,37 @@ 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 + +Reload Window or Restart VS-Code + ## 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 +178,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.