前言¶
在金蝶雲星空(K3 Cloud)環境裏,查單、跟庫存、處理採購銷售單據,往往要在客戶端或 Web 裏按菜單逐級點。若你已經在用支持 MCP 的 Agent 工作臺(例如 WorkBuddy),更自然的訴求是:讓助手按對話意圖去查數據、辦單據,而不是每次自己複述表單路徑和字段名。
下面介紹 SkillHub 上的社區 Skill「金蝶雲星空 MCP 連接器」。它的定位不是替代金蝶客戶端,而是把已有的第三方開源 kingdee-mcp MCP Server 接到 WorkBuddy,並協助完成連接與配置,使你可以用自然語言查詢或操作 ERP 相關單據。
這是什麼¶
金蝶雲星空 MCP 連接器(座標 @user_4643e8be/kingdee-mcp-connector,當前版本 1.0.2,來源 community,分類 ai-agent)是面向 WorkBuddy 的連接器類 Skill。
根據 SkillHub 簡介,該 Skill 由社區發佈者 user_4643e8be 維護,底層依賴第三方開源項目 kingdee-mcp,並非金蝶官方出品。接入並配置好金蝶雲星空 MCP Server 之後,可通過自然語言查詢或操作金蝶 ERP 單據,覆蓋採購、銷售、庫存、生產、成本、固定資產等業務域(具體能力以實際連接的 MCP Server 爲準)。
SkillHub 頁面標籤包含 requires_api_key=true,表示啓用過程中涉及需妥善保管的憑據或密鑰類配置,安裝後應嚴格按技能包內說明填寫,避免明文泄露。
核心功能¶
結合官方簡介,可覈實的能力邊界如下:
- 連接與配置:引導你在 WorkBuddy 側連接、配置金蝶雲星空 MCP Server(基於 kingdee-mcp),而不是從零編寫 MCP 清單。
- 自然語言查詢與操作:在 MCP 已連通的前提下,用對話方式處理 ERP 單據與相關數據,簡介中明確提到的域包括採購、銷售、庫存、生產、成本、固定資產等。
Skill 本身不替代金蝶 WebAPI 權限體系;能否讀、能否寫,仍取決於你賬套賬號與 MCP Server 暴露的工具能力。
安裝與啓用¶
安裝方式以 SkillHub 頁面給出的指引爲準:先閱讀通用安裝文檔,再安裝本 Skill 座標。
方式一:交給 AI 按官方提示安裝
將 SkillHub 頁面上的安裝提示發給當前 Agent,大意如下(路徑與目錄以 skillhub.md 爲準):
請根據 https://skillhub.cn/install/skillhub.md,安裝 `@user_4643e8be/kingdee-mcp-connector`。
方式二:使用 SkillHub CLI
若本機已有 skillhub 命令,可按安裝文檔將 Skill 裝到當前 Agent 的 skills 目錄。文檔強調必須使用 --dir 指向會被識別的目錄,否則默認落到 ./skills/ 可能無效。
檢查 CLI:
command -v skillhub && skillhub --version
未安裝時,安裝文檔提供的完整安裝示例爲:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill(將 <skills 目錄> 換成你當前環境的路徑;WorkBuddy 常見爲 ~/.workbuddy/skills/):
skillhub install @user_4643e8be/kingdee-mcp-connector --dir <skills 目錄>
其他客戶端在 skillhub.md 中列出的 skills 路徑包括 Claude Code(~/.claude/skills/)、Cursor(~/.cursor/skills/)、Codex(~/.codex/skills/ 或項目下 .agents/skills/)等。本 Skill 簡介明確面向 WorkBuddy 連接器場景,若你並非在 WorkBuddy 中使用,請先確認技能包說明是否支持你的客戶端。
經過上面的步驟安裝完成後,按技能包內的 SKILL.md 完成金蝶 MCP Server 的連接與配置(含 requires_api_key 相關項),再在 WorkBuddy 中確認 MCP 服務已連接,方可進行對話式查詢或操作。
典型用法¶
官方頁面未附帶逐條複製的對話腳本,用法可從簡介歸納:
- 在 WorkBuddy 中啓用本 Skill,並按文檔完成 kingdee-mcp 與賬套環境的連接配置。
- 在對話中用自然語言描述業務意圖,例如圍繞採購、銷售、庫存、生產、成本或固定資產相關的查詢或單據操作(表述需與 MCP 實際工具能力一致)。
- 對涉及新建、提交、審覈等寫操作,建議先讓 Agent 列出將要調用的動作與對象,確認後再執行,以降低誤操作風險。
具體觸發詞、配置字段名與 MCP 工具列表以安裝後技能目錄中的 SKILL.md 及 kingdee-mcp 項目文檔爲準;本文不展開未在 SkillHub 頁面覈實的配置項。
適用場景與注意¶
適合誰
- 已部署金蝶雲星空,並願意通過第三方開源 kingdee-mcp 暴露 MCP 接口的團隊。
- 主要在 WorkBuddy 中與 Agent 協作,希望減少在 ERP 界面間切換的頻率。
需要注意
- 非官方:與金蝶軟件無官方隸屬關係,對外說明、合規與授權需自行評估。
- 憑據安全:
requires_api_key=true提醒存在敏感配置;生產環境應使用權限受控的集成賬號,並避免把密碼寫入可被同步或提交的明文文件。 - 能力邊界:簡介列舉的是業務域方向,不等同於「所有表單均已封裝」;以 MCP Server 版本與工具清單爲準。
- 社區指標:SkillHub 抓取數據顯示評分爲 100000,下載 5443 次(統計隨平臺更新變化)。
結尾¶
若你的目標是在 WorkBuddy 裏把金蝶雲星空接到 MCP、並用自然語言處理常見 ERP 單據,金蝶雲星空 MCP 連接器提供的是「連接器 + 配置指引」這一層 Skill 封裝。安裝與詳情見 SkillHub:
- 頁面:https://www.skillhub.cn/skills/user_4643e8be/kingdee-mcp-connector
- API 入口:https://api.skillhub.cn/user_4643e8be/kingdee-mcp-connector