前言¶
直接查金蝶云星空(K/3 Cloud)的单据表,字段名、枚举值、单据状态、关联单据的关系都要翻数据字典;改用开放 API,又要处理鉴权、分页和状态流转。下面介绍的这个 Skill 想解决的,是把这类需求变成一句自然语言描述,由它调用已连接的 MCP 服务器完成查询和操作。
这是什么¶
一句话定位:一个面向金蝶云星空的 Skill,通过已连接的 kingdee-mcp,用自然语言查询与操作 ERP 数据。
发布者:社区作者 @user_4643e8be,发布在 SkillHub,来源为 community。
需要先明确的一点:它依赖的 kingdee-mcp 是第三方开源项目,不是金蝶官方出品。
触发条件(来自官方简介):用户提到「金蝶」「查金蝶」「金蝶销售订单/库存/物料」等 ERP 查询或操作需求时触发。
核心功能¶
以下能力来自官方简介,未逐个接口验证。
- 销售订单、采购订单的查询
- 即时库存查询
- 物料档案查询
- 客户、供应商查询
- 单据提交、审核、下推
- 生产、成本、资产等业务查询
其中「提交 / 审核 / 下推」属于写操作,不只是查询。
安装与启用¶
本节无法给出可复现的安装步骤。已抓取资料中只确认了两点:
- 需要 API Key,对应标签
requires_api_key=true - 前提是 kingdee-mcp 已连接
资料中没有给出安装命令、配置文件路径,也没有 Cursor / Codex CLI / Claude Code 的差异化说明。请到官方页面确认后再启用。
典型用法¶
以下是依据官方简介整理的示例,不是实际运行结果。
- 查销售订单:「帮我查一下以 FKDA 开头的销售订单」
- 查即时库存:「物料编码 X 当前的即时库存是多少」
- 查档案:「列出客户/供应商档案里名称包含某关键词的记录」
- 单据操作:「把销售订单 SO-2024-0001 提交审核」
- 下推:「把采购订单下推生成对应的应付单」
查询类需求一般一次即可返回;提交、审核、下推建议先确认单据当前状态,再执行操作。
适用场景与注意¶
适合:已经在使用金蝶云星空、希望通过自然语言完成单据查询和状态操作的开发者或实施人员。
注意:
- kingdee-mcp 是第三方开源实现,接口覆盖范围和稳定性取决于该项目本身,不是金蝶官方保证的能力。
- 需要有效的 API Key,且 MCP 服务器处于已连接状态。
- 提交、审核、下推会改变单据状态,建议先在测试账套验证,再用于生产数据。
- 简介列出的生产、成本、资产等能力,具体到哪些单据可用,需以实际连接后的 MCP 工具列表为准。
结语¶
它的价值在于把 ERP 查询与操作从「查表或写接口」降到「描述需求」。如果你的需求集中在销售、采购、库存、物料、客户供应商这几类单据,可以先试查询类;写操作类建议在测试环境验证后再用。
官方地址:https://api.skillhub.cn/user_4643e8be/kingdee-query