knowall-ai/mcp-business-central

开发工具官方

本页由 AI 翻译，技术细节请以原文为准。查看原文

10 stars 3 forks 质量 68 趋势 16

Repository Install

Model Context Protocol (MCP) server for Microsoft Dynamics 365 Business Central.

概览

Model Context Protocol (MCP) server for Microsoft Dynamics 365 Business Central. Provides AI assistants with direct access to Business Central data through properly formatted API v2.0 calls. - ✅ : Uses proper /companies(id)/resource format (no ODataV4 segment) - ✅ : Run with npx - no pre-installation required - ✅ : Leverages existing Azure CLI authentication - ✅ : Service-to-service authentication for AI agents - ✅ : No prefixes, just get_schema, list_items, etc. - ✅ : Create, read, update, and delete Business Central records No installation needed! Configure in Claude Desktop or Claude Code: : Use cmd with /c as shown above for proper npx execution. 1. : Find in Azure Portal → Azure Active Directory → Overview 2. : Usually Production or Sandbox 3. : The display name shown in Business Central : Use azure_cli authentication - it's simpler to set up and more reliable.

README

以下为原文 README 节选，完整内容请查看原文。

Microsoft Business Central MCP Server

Model Context Protocol (MCP) server for Microsoft Dynamics 365 Business Central. Provides AI assistants with direct access to Business Central data through properly formatted API v2.0 calls.

Features

✅ Correct API URLs: Uses proper /companies(id)/resource format (no ODataV4 segment)
✅ Zero Installation: Run with npx - no pre-installation required
✅ Azure CLI Auth: Leverages existing Azure CLI authentication
✅ Client Credentials Auth: Service-to-service authentication for AI agents
✅ Clean Tool Names: No prefixes, just get_schema, list_items, etc.
✅ Full CRUD: Create, read, update, and delete Business Central records

Installation

Using npx (Recommended)

No installation needed! Configure in Claude Desktop or Claude Code:

{
  "mcpServers": {
    "business-central": {
      "type": "stdio",
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@knowall-ai/mcp-business-central"],
      "env": {
        "BC_URL_SERVER": "https://api.businesscentral.dynamics.com/v2.0/{tenant-id}/{environment}/api/v2.0",
        "BC_COMPANY": "Your Company Name",
        "BC_AUTH_TYPE": "azure_cli"
      }
    }
  }
}

Note for Windows: Use cmd with /c as shown above for proper npx execution.

Using Smithery

Install via Smithery:

npx -y @smithery/cli install @knowall-ai/mcp-business-central --client claude

Local Development

git clone https://github.com/knowall-ai/mcp-business-central.git
cd mcp-business-central
npm install
npm run build
node build/index.js

Configuration

Environment Variables

Variable	Required	Description	Example
`BC_URL_SERVER`	Yes	Business Central API base URL	`https://api.businesscentral.dynamics.com/v2.0/{tenant}/Production/api/v2.0`
`BC_COMPANY`	Yes	Company display name	`KnowAll Ltd`
`BC_AUTH_TYPE`	No	Authentication type (default: `azure_cli`)	`azure_cli` or `client_credentials`
`BC_TENANT_ID`	For client_credentials	Azure AD tenant ID	`00000000-0000-0000-0000-000000000000`
`BC_CLIENT_ID`	For client_credentials	App registration client ID	`00000000-0000-0000-0000-000000000000`
`BC_CLIENT_SECRET`	For client_credentials	App registration client secret	`your-secret-value`

Getting Your Configuration Values

在 GitHub 查看完整 README

安装

npx -y @knowall-ai/mcp-business-central

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "business-central": {
      "type": "stdio",
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@knowall-ai/mcp-business-central"],
      "env": {
        "BC_URL_SERVER": "https://api.businesscentral.dynamics.com/v2.0/{tenant-id}/{environment}/api/v2.0",
        "BC_COMPANY": "Your Company Name",
        "BC_AUTH_TYPE": "azure_cli"
      }
    }
  }
}