让 AI 直接操作
金蝶云星空
金蝶云星空 ERP 的 MCP Server，支持 Claude Desktop、Cursor、Windsurf、OpenClaw 等所有 MCP 兼容客户端。通过 OpenClaw 还可以在 微信、WhatsApp、Telegram 中直接操作金蝶。
pip install kingdee-mcp
为什么选择 Kingdee MCP
简单、高效、安全地让 AI 助手接入你的金蝶系统
异步高性能
基于 async/await 异步架构，支持并发请求，自动 Session 缓存和重试机制。
13+ 实用工具
涵盖采购、销售、库存、基础资料等核心业务模块，开箱即用。
安全认证
采用金蝶官方 WebAPI 认证，支持 AppSecret 方式登录，凭证本地存储。
自动重试
Session 过期自动重新登录，连接失败自动重试，稳定可靠。
类型安全
基于 Pydantic 的数据验证，所有输入参数都有类型检查和自动补全。
易于扩展
基于 FastMCP 框架，轻松添加自定义工具和业务逻辑。
支持的工具列表
共 13 个工具，覆盖核心业务场景
快速安装
只需几步，即可让 AI 连接你的金蝶系统
安装 MCP Server
确保已安装 Python 3.10+，通过 pip 安装。
pip install kingdee-mcp金蝶后台授权
在金蝶云星空中创建集成用户并生成应用凭证。
进入 系统管理 → 第三方系统登录授权 → 新增，新建一个集成用户（不要用 Administrator），然后生成应用ID和应用密钥。
配置 MCP 客户端
在你的 MCP 客户端配置文件中添加以下内容。
{
"mcpServers": {
"kingdee": {
"command": "uvx",
"args": ["kingdee-mcp"],
"env": {
"KINGDEE_SERVER_URL": "http://your-server/k3cloud/",
"KINGDEE_ACCT_ID": "your_acct_id",
"KINGDEE_USERNAME": "API集成",
"KINGDEE_APP_ID": "your_app_id",
"KINGDEE_APP_SEC": "your_app_secret"
}
}
}
}
配置文件位置：
Claude Desktop (Win): %APPDATA%\Claude\claude_desktop_config.json
Claude Desktop (Mac): ~/Library/Application Support/Claude/claude_desktop_config.json
Cursor: Settings → MCP → Add Server
Claude Code CLI: ~/.claude/settings.json
重启客户端
完成配置后，重启你的 MCP 客户端即可开始使用。
安全提示
请确保 .env 文件不会被提交到代码仓库。建议将其加入 .gitignore。
使用示例
配置完成后，直接用自然语言与 AI 交互
kingdee_query_purchase_orders(
top: 20,
filter_string: "FDocumentStatus = 'C'",
order_by: "FDate DESC"
)kingdee_query_inventory(
filter_string: "FMaterialNumber = 'MAT001'"
)kingdee_query_sale_orders(
filter_string: "FSupplierNumber = 'C001'"
)kingdee_save_bill(
form_id: "PUR_PurchaseOrder",
data: {
FSupplierId: { FNumber: "S001" },
FMaterialId: { FNumber: "MAT001" },
FQty: 100,
FTaxPrice: 10.5
}
)kingdee_audit_bills(
form_id: "STK_Instock",
bill_ids: ["12345", "12346"]
)kingdee_unaudit_bills(
form_id: "SAL_SaleOrder",
bill_ids: ["SO2024001"]
)常见问题
遇到问题？这里可能有答案
FDocumentStatus = 'C' 表示已审核状态。