WorkBuddy连接用友NCC：三步打通，从零到对话查询ERP

在企业数字化转型进程中，财务对账往往是最耗时的痛点之一。以某消费品集团为例，财务团队每月需要在用友NCC系统导出科目余额数据，结合其他系统的手工Excel数据拼接后才能完成月结入账。这种重复性的数据搬运工作不仅效率低下，还容易出错。能否让AI助手直接“开口问”ERP要数据，将原本半天的工作压缩到十秒钟？答案是肯定的，且实现路径比想象中简单得多。

打通认证链路：三步完成OpenAPI对接

很多技术团队在尝试对接NCC时，第一反应是去GitHub搜索现成的MCP Server。结果往往令人失望——开源社区中零星的几个项目覆盖范围有限，有的只支持查询数据字典，有的只覆盖HR模块，真正能用于生产环境的成熟方案少之又少。这容易让人得出「NCC没有开放接口」的结论。但事实恰恰相反：用友官方开放平台早已提供了完整的OpenAPI，只是尚未被封装成MCP Server的形式。这本质上是两件事：接口存在，但接口形式需要适配。

安全架构：三层防护体系

NCC的OpenAPI对接分为三个关键步骤。第一步是注册应用：管理员登录OPM（开放平台管理控制台），创建第三方应用并配置IP白名单，系统会生成AppKey和AppSecret作为应用凭证。第二步是获取认证令牌或直接使用签名模式——前者通过调用令牌接口获取access_token，后者则使用AppKey+AppSecret+时间戳的SHA256签名免Token直调业务接口。后者特别适合AI助手的只读查询场景，省去了Token刷新维护的复杂性。第三步是调用业务接口，遵循RESTful规范的路径格式如nccloud/api/{模块}/{业务组件}/{资源}/{动词}，例如查询现存量对应的路径为nccloud/api/ic/onhand/onhandQuery。三步完成后，AI助手即可实现与NCC的数据对话。

实施路径：从最小闭环到全面覆盖

NCC的OpenAPI覆盖了至少12个核心业务域，包括库存、采购、合同、销售、总账、资金、应收、应付、固定资产、报销和生产制造等模块。以销售模块为例，新增销售订单的路径是nccloud/api/so/saleorder/save，采购订单支持query、save、approve等标准操作。这意味着NCC的API设计是一套高度标准化的框架，按照「模块-组件-资源-动词」的规范，每个业务单据类型都可能对应一个可推断的接口路径。即便保守估计每个模块5个标准接口，全量也远超60个。此外，NCC还支持单据变更实时回调，覆盖新增、修改、审核、作废等事件通知。

实践建议：从最小可用模块起步

技术实现层面还有几个避坑点值得关注：签名生成时务必确保服务器与客户端时间同步、字符编码统一使用UTF-8、密钥版本正确匹配。对于签名失败的问题，排查顺序通常是时间同步→编码格式→密钥一致性。如果选择Token模式，则需要在MCP Server层封装自动刷新逻辑——提前30分钟主动续期、增加并发锁避免多线程重复请求、捕获401异常做兜底重试。这些细节虽小，但直接影响系统的稳定性和用户体验。

如有侵权，请联系删除。