Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 44 additions & 3 deletions samples/BcMCPProxy/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -78,14 +88,45 @@ The BC MCP Proxy acts as a bridge between MCP-compatible clients (like Claude De
- `<Your-Client-ID>`: The Application (client) ID from your Azure app registration
- `<BC-Environment-Name>`: Name of your Business Central environment
- `<Company-Name>`: Business Central company name
- `<Configuration-Name>`: Name of the Business Central configuration
- `<Configuration-Name>`: Name of the Business Central "Model Context Protocol (MCP) Server Configurations" configuration as defined in Step 2

4. **Restart Claude Desktop**

After saving the configuration, restart Claude Desktop. You should see the BC MCP tools available:

![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",
"<Your-Tenant-ID>",
"--ClientId",
"<Your-Client-ID>",
"--Environment",
"<BC-Environment-Name>",
"--Company",
"<Company-Name>",
"--ConfigurationName",
"<Configuration-Name>"
],
"command": "C:\\Path\\To\\BcMCPProxy.exe",
}
```

**Parameter Details:**
- `<Your-Tenant-ID>`: Your Azure tenant ID
- `<Your-Client-ID>`: The Application (client) ID from your Azure app registration
- `<BC-Environment-Name>`: Name of your Business Central environment
- `<Company-Name>`: Business Central company name
- `<Configuration-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.
Expand Down Expand Up @@ -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.
This project is subject to the Microsoft sample code license terms.