商业中央MCP代理

一个实验性工具,用于连接Claude Desktop或VS Code与Business Central Model Context Protocol (MCP)服务器,实现自然语言交互。

  • by Natxo-hash
  • C#
  • 本地部署
  • 更新于
在 GitHub 查看 Natxo-hash/MCPServerJavi

使用说明

商务中心MCP代理

⚠️ 实验工具-不用于生产

此工具用于 仅限于实验 并且是 不用于生产用途它允许您将Claude Desktop或VS Code连接到业务中心模型上下文协议(MCP)服务器。

概述

BC MCP Proxy充当MCP兼容客户端(如Claude Desktop)和Business Central之间的桥梁,实现与Business Central数据和操作的自然语言交互。

先决条件

  • Microsoft Dynamics 365商务中心环境
  • 具有适当权限的Azure租户
  • Claude桌面应用程序(用于Claude集成)

安装说明

1.设置Azure AD应用程序注册

  1. 打开 ms.portal.azui.com

  2. 引导到 微软Entra ID 并创建一个新的 应用程序注册

  3. 在 认证 在第节中,以以下格式添加桌面应用程序重定向URL:

    ms-appx-web://Microsoft.AAD.BrokerPlugin/<clientID>
    
  4. 添加以下API权限:

    所需权限:

    • Dynamics 365商务中心(2)
      • Financials.ReadWrite.All (委托)
      • user_impersonation (委托)

2.使用Business Central MCP服务器设置Claude

  1. 下载并安装Claude Desktop

    • 从官方网站下载桌面版Claude
    • 安装并登录您的Claude帐户
  2. 配置Claude桌面

    • 打开克劳德桌面
    • 引导到 设置 → 开发者
    • 点击 “编辑配置” 创建/编辑 claude_desktop_config.json
  3. 编辑配置文件

    将BC MCP服务器配置添加到您的 claude_desktop_config.json:

    {
      "mcpServers": {
        "BC_MCP": {
          "command": "C:\\Path\\To\\BcMCPProxy.exe",
          "args": [
            "--TenantId",
            "<Your-Tenant-ID>",
            "--ClientId", 
            "<Your-Client-ID>",
            "--Environment",
            "<BC-Environment-Name>",
            "--Company",
            "<Company-Name>",
            "--ConfigurationName",
            "<Configuration-Name>"
          ]
        }
      }
    }
    

    参数详细信息:

    • <Your-Tenant-ID>:您的Azure租户ID
    • <Your-Client-ID>:Azure应用注册中的应用程序(客户端)ID
    • <BC-Environment-Name>:您的Business Central环境的名称
    • <Company-Name>:商务中心公司名称
    • <Configuration-Name>:Business Central配置的名称
  4. 重新启动克劳德桌面

    保存配置后,重新启动Claude Desktop。您应该看到可用的BC MCP工具:

用法

配置后,您可以通过Claude Desktop中的自然语言与Business Central进行交互。MCP服务器将处理对Business Central环境的身份验证和API调用。

交互示例:

  • “显示最新的销售订单”
  • “创建新客户记录”
  • “目前的库存水平是多少?”

配置参数

参数 说明 必填
TenantId Azure租户标识符 是
ClientId Azure应用程序注册客户端ID 是
Environment Business Central环境名称 是
Company Business Central公司名称 是
ConfigurationName Business Central配置的名称 否

故障排除

常见问题

  1. 身份验证失败

    • 验证Azure应用注册中的重定向URL格式
    • 确保授予所有必需的API权限
    • 检查是否已提供管理员同意(如果需要)
  2. 连接问题

    • 验证Business Central环境名称是否正确
    • 确保公司名称完全匹配(区分大小写)
    • 检查与Business Central的网络连接
  3. Claude Desktop未检测到MCP服务器

    • 验证路径 BcMCPProxy.exe 是正确的
    • 检查是否提供了所有必需的参数
    • 配置更改后重新启动Claude Desktop

安全考虑

  • 此工具使用委托权限,需要用户身份验证
  • 凭据通过Azure的身份验证流程进行处理
  • 配置文件中没有存储密码或机密
  • 设置集成时,始终遵循组织的安全策略

支持

这是一个实验工具,按原样提供,用于开发和测试目的。有关Business Central的特定问题,请参阅Microsoft Dynamics 365 Business Central官方文档。

许可证

此项目受Microsoft示例代码许可条款的约束。#� �M�C�P�S�e�r�v�e�r�J�a�v�i� � �