Kingdee K3Cloud ERP — Claude Code MCP server: setup guide
Kingdee K3Cloud (Cloud Galaxy) ERP is an MCP server for Claude Code, with 101 tools for procurement, sales, inventory, and manufacturing workflows.
MIT ★ 146 updated 2026-10-25
claude mcp add kingdee-mcp -e KINGDEE_SERVER_URL=<KINGDEE_SERVER_URL> -e KINGDEE_ACCT_ID=<KINGDEE_ACCT_ID> -e KINGDEE_USERNAME=<KINGDEE_USERNAME> -e KINGDEE_PASSWORD=<KINGDEE_PASSWORD> -- uvx kingdee-mcpWhat Kingdee K3Cloud (Cloud Galaxy) ERP does
This server bridges assistants with the Kingdee K3Cloud (Cloud Galaxy) WebAPI. It implements 101 operational tools divided into 17 business areas. Assistants can create or audit business vouchers, look up stock balances, manage manufacturing batches, and push related documents through the pipeline. Four tools allow inspecting database tables and column definitions.
The service uses FastMCP alongside Pydantic data schemas. Network calls run asynchronously, and expired sessions trigger an automatic re-login. Beyond standard input-output mode, the server supports SSE and Streamable HTTP endpoints, with multi-stage Docker deployment available.
Authentication requires genuine user credentials via ValidateUser rather than AppID tokens, preserving strict data permission controls. The optional SQL Server inspection features will fail unless the host machine has Microsoft's msodbcsql18 driver installed.
What it helps with
- query approved procurement records and production schedules
- batch approve or roll back warehouse inventory receipts
- inspect ERP database tables and verify field definitions
- draft and validate sales orders via the official WebAPI
Example prompts for the agent
- List all approved purchase orders created this month
- Create a draft sales order using these product line items
- Inspect the column metadata for the production orders table
How to install Kingdee K3Cloud (Cloud Galaxy) ERP
Platform CLI
claude mcp add kingdee-mcp -e KINGDEE_SERVER_URL=<KINGDEE_SERVER_URL> -e KINGDEE_ACCT_ID=<KINGDEE_ACCT_ID> -e KINGDEE_USERNAME=<KINGDEE_USERNAME> -e KINGDEE_PASSWORD=<KINGDEE_PASSWORD> -- uvx kingdee-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from kingdee-mcp <command>
Platform CLI
codex mcp add kingdee-k3cloud-cloud-galaxy-erp --env KINGDEE_SERVER_URL=<KINGDEE_SERVER_URL> --env KINGDEE_ACCT_ID=<KINGDEE_ACCT_ID> --env KINGDEE_USERNAME=<KINGDEE_USERNAME> --env KINGDEE_PASSWORD=<KINGDEE_PASSWORD> -- uvx kingdee-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from kingdee-mcp <command>
Config file
{
"mcpServers": {
"kingdee-k3cloud-cloud-galaxy-erp": {
"command": "uvx",
"args": [
"kingdee-mcp"
],
"env": {
"KINGDEE_SERVER_URL": "<KINGDEE_SERVER_URL>",
"KINGDEE_ACCT_ID": "<KINGDEE_ACCT_ID>",
"KINGDEE_USERNAME": "<KINGDEE_USERNAME>",
"KINGDEE_PASSWORD": "<KINGDEE_PASSWORD>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from kingdee-mcp <command>
Config file
{
"servers": {
"kingdee-k3cloud-cloud-galaxy-erp": {
"type": "stdio",
"command": "uvx",
"args": [
"kingdee-mcp"
],
"env": {
"KINGDEE_SERVER_URL": "<KINGDEE_SERVER_URL>",
"KINGDEE_ACCT_ID": "<KINGDEE_ACCT_ID>",
"KINGDEE_USERNAME": "<KINGDEE_USERNAME>",
"KINGDEE_PASSWORD": "<KINGDEE_PASSWORD>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from kingdee-mcp <command>
Platform CLI
gemini mcp add -e KINGDEE_SERVER_URL=<KINGDEE_SERVER_URL> -e KINGDEE_ACCT_ID=<KINGDEE_ACCT_ID> -e KINGDEE_USERNAME=<KINGDEE_USERNAME> -e KINGDEE_PASSWORD=<KINGDEE_PASSWORD> kingdee-k3cloud-cloud-galaxy-erp uvx kingdee-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from kingdee-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Kingdee K3Cloud (Cloud Galaxy) ERP
How to install Kingdee K3Cloud (Cloud Galaxy) ERP in Claude Code?
Run `claude mcp add kingdee-mcp -e KINGDEE_SERVER_URL=<KINGDEE_SERVER_URL> -e KINGDEE_ACCT_ID=<KINGDEE_ACCT_ID> -e KINGDEE_USERNAME=<KINGDEE_USERNAME> -e KINGDEE_PASSWORD=<KINGDEE_PASSWORD> -- uvx kingdee-mcp`, substituting your server address, company account ID, and credentials.
How does the server authenticate with the ERP?
It signs in through standard ValidateUser calls with a dedicated username and password. This approach preserves user-level data permissions during WebAPI queries instead of using application tokens.
What is required to run the SQL Server exploration tools?
You need to configure the MCP_SQLSERVER_* environment variables and ensure Microsoft's msodbcsql18 ODBC library is installed on the host operating system.