如何通过 MCP 将 Dynamics 365 Business Central 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Microsoft Dynamics 365 Business Central、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Dynamics 365 Business Central + Gemini

让你的 AI 在 Business Central 中工作：查找客户、供应商和物料，读取销售报价、销售订单和销售发票、采购发票、总账、科目表和维度，并创建客户以及报价和订单草稿。通过标准 API v2.0 支持 Business Central online，使用你的 Microsoft 账户登录。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID, BC_ENVIRONMENT

步骤 1 — 获取凭证

1. 打开 Microsoft Entra 管理中心（https://entra.microsoft.com）→ Applications → App registrations → New registration，也可以复用你为 Outlook、OneDrive 或 SharePoint 连接器创建的应用。通常选择 Accounts in this organizational directory only。
2. 添加平台为 Web 的重定向 URI：https://cloud.anythingmcp.com/api/mcp-oauth/callback（如果你自行托管 AnythingMCP：<your AnythingMCP URL>/api/mcp-oauth/callback）。它必须完全一致，否则 Microsoft 会返回 AADSTS50011。
3. 在 API permissions → Add a permission → Dynamics 365 Business Central → Delegated permissions 下勾选 Financials.ReadWrite.All（以及 user_impersonation）。如果你的组织不允许用户自行同意，请点击 Grant admin consent。
4. 在 Certificates & secrets → New client secret 下复制密钥的 Value。它只显示一次；你需要的不是 Secret ID。
5. 填写 MICROSOFT_CLIENT_ID（即 Application (client) ID）、MICROSOFT_CLIENT_SECRET、MICROSOFT_TENANT_ID 和 BC_ENVIRONMENT，然后安装连接器。
6. 点击 Authorize with Provider，用一个 Business Central 用户登录。访问令牌会自动续期。
7. 运行 bc_list_companies。其他所有工具都在某一个公司内工作，并需要该公司的 id。

租户和环境：MICROSOFT_TENANT_ID 是你的 Directory (tenant) ID，或 contoso.onmicrosoft.com 这样的域名。common 和 organizations 在这里不可用，因为租户是 Business Central 地址的一部分。BC_ENVIRONMENT 是环境名称，须与 Business Central 管理中心中显示的完全一致：大多数正式租户为 Production，测试环境为 Sandbox 或你自己起的名称。bc_list_environments 会列出这些名称。请先在沙盒中试用连接器：在生产环境中，它创建的客户和单据都是真实的。

与用户相同的权限：每次调用都以登录用户的身份运行，使用该用户的 Business Central 许可证和权限集。AI 能看到和修改的，正是该用户被允许的内容。

读取和写入的内容：客户、供应商、物料、销售报价、销售订单和销售发票、采购发票、总账分录、科目表、维度和员工，此外还可以通过 bc_query 访问标准 API v2.0 的任何其他资源，例如联系人、采购订单、贷项通知单、应收和应付账龄或试算平衡表。它可以创建客户以及带明细行的销售报价和销售订单，并更新客户。单据始终保持为未结草稿：不会下达、发货、开票或过账。创建单据前，AI 会先和你确认客户、物料、数量和价格。

安装时默认关闭：bc_delete_customer、bc_make_order_from_quote、bc_delete_sales_quote 和 bc_delete_sales_order。删除记录或把报价转为订单都无法撤销，因此只有在需要时才逐个打开这些工具。

限制：Business Central 允许每个用户每 5 分钟约 6,000 次 API 调用；超出后，它会要求连接器等待。

常见错误：401 表示授权已被撤销或客户端密钥已过期：如有需要填入新密钥，然后重新授权。403：用户缺少许可证或权限集，或缺少管理员同意。404 NoEnvironment：BC_ENVIRONMENT 或 MICROSOFT_TENANT_ID 有误。412：记录在读取后被他人修改过，因此 AI 会重新读取。

仅支持 Business Central online：不涵盖本地部署，较旧的 NAV 部署有专门的 Dynamics NAV 连接器。扩展发布的自定义 API 无法访问。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 Dynamics 365 Business Central 的工具。

可用工具

示例提示

• “哪些客户有逾期发票？每个客户的总额是多少？”
• “显示本月尚未全部发货的销售订单。”
• “为 Adatum Corporation 创建一份销售报价，包含 10 个物料 1896-S，保存前先给我看看。”
• “我们 9 月在收入科目上过账了什么？请按部门列出。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT