knowall-ai/mcp-business-central

Developer tools Официальный

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

10 stars 3 forks Качество 68 Тренд 26

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

Открыть полный README на GitHub

Установка

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

Новичок в MCP? Начните с руководства на 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"
      }
    }
  }
}