bc365
通过两个命令将Claude Code连接到Microsoft Dynamics 365 Business Central。
npx @habitusnet/bc365 onboard
claude plugin install habitusnet/bc365-skills______________________________________________________________________
它的作用
bc365 onboard 让您登录Microsoft,发现您的BC环境和公司,并直接向Claude Code注册两个MCP服务器:
| MCP服务器 | 用途 |
|---|---|
bc-data | 通过OData读取和写入BC数据——客户、项目、订单、总账条目 |
bc-admin | 管理环境、应用程序、功能标志和用户会话 |
claude plugin install habitusnet/bc365-skills 添加了三个Claude技能,告诉Claude如何有效地使用这些服务器。
______________________________________________________________________
先决条件
- 克劳德代码 安装
- Node.js≥20
- 可以访问Business Central的Microsoft 365帐户
D365 BUS FULL ACCESSBC中设置的权限
______________________________________________________________________
安装
全局安装(推荐)
npm install -g @habitusnet/bc365
bc365 onboard一次性(无需安装)
npx @habitusnet/bc365 onboard______________________________________________________________________
入职
bc365 onboard- 打印设备代码URL——在浏览器中打开它,并使用您的Microsoft帐户登录
- CLI可以发现您的租户、环境和公司
- 检查您的BC权限集,并在缺少任何内容时发出警告
- 寄存器
bc-data和bc-admin克劳德代码
服务器注册于 局部作用域 默认情况下,存储在 .claude/settings.local.json,gignored,每个用户。使用 --scope 要更改此设置:
| 作用域 | 存储在 | 使用时 |
|---|---|---|
local *(默认)* | .claude/settings.local.json | 每个用户,gitignored--推荐 |
user | ~/.claude.json | 此用户的所有项目 |
project | .mcp.json | 共享团队配置,致力于git |
bc365 onboard # local scope (default)
bc365 onboard --scope project # writes .mcp.json for the whole team入职后,安装技能包:
claude plugin install habitusnet/bc365-skills______________________________________________________________________
克劳德技能
这 habitusnet/bc365-skills 插件教Claude如何使用MCP服务器:
| 技能 | 它涵盖了什么 |
|---|---|
bc-query | OData过滤器, $expand 用于行项目、分页、写入操作 |
bc-admin | 环境检查、应用程序更新工作流、功能标志、会话管理 |
bc-diagnose | HTTP/OData错误解释、权限集引用、诊断工作流 |
技能也捆绑在这个包中 skills/ 用于离线访问。
______________________________________________________________________
多租户使用(代理)
每 bc365 onboard run保存配置文件。在客户端之间切换而无需重新验证:
# Onboard client A (saves profile automatically)
bc365 onboard
# Later: switch to client B
bc365 switch client-b-profile
# List all saved profiles
bc365 profilesbc365 switch 接受相同 --scope 旗为 onboard.
______________________________________________________________________
所有命令
| 命令 | 描述 | ||
|---|---|---|---|
| `bc365 onboard [-s local\ | user\ | project]` | 发现租户/env/公司并注册MCP服务器 |
| `bc365 switch | |||
| [-s local\ | user\ | project]` | 从已保存的配置文件中重新注册服务器 |
bc365 profiles | 列出已保存的配置文件 | ||
bc365 check | 查看bc365包的最新npm版本 |
______________________________________________________________________
MCP服务器
这两台服务器都是供应商提供的镜像,具有每日上游同步和安全扫描功能:
| 服务器 | 上游 | npm命令 |
|---|---|---|
bc-admin | habitusnet/d365bc-admin-mcp | d365bc-admin-mcp |
bc-data | habitusnet/mcp-business-central | npx @habitusnet/mcp-business-central |
______________________________________________________________________
故障排除
身份验证错误(401) --奔跑 az login 刷新Azure CLI凭据,或重新运行 bc365 onboard.
缺少权限警告 --让您的BC管理员进行分配 D365 BUS FULL ACCESS 在设置中→ 用户→ 权限集。
claude: command not found --运行之前,必须在PATH中安装Claude Code bc365 onboard.
______________________________________________________________________
许可证
麻省理工学院
