Kingdee K3Cloud ERP — MCP-сервер для Claude Code: как настроить
Kingdee K3Cloud (Cloud Galaxy) ERP — MCP-сервер для управления ERP через Claude Code: 101 инструмент для накладных, производства, закупок и складских остатков.
MIT ★ 146 обновлён 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-mcpЧто делает Kingdee K3Cloud (Cloud Galaxy) ERP
Интеграция связывает ассистента с WebAPI системы Kingdee K3Cloud (Cloud Galaxy). Набор из 101 инструмента охватывает 17 прикладных областей: оформление и проверку накладных, массовое согласование документов, отслеживание складских запасов и производственных заданий. Сервер также содержит утилиты для исследования таблиц и полей базы данных.
Под капотом работает FastMCP с валидацией через Pydantic. Вызовы выполняются асинхронно, а при разрыве сессии сервер автоматически переподключается к ERP. Поддерживаются запуск через stdio, удалённые протоколы SSE и Streamable HTTP, а также готовый Docker-образ.
Для авторизации нужен отдельный системный пользователь с паролем (ValidateUser), так как старый вход по AppID больше не поддерживается. Для работы SQL-инструментов инспекции базы потребуется установленный в системе драйвер msodbcsql18.
Какие задачи решает
- запрашивать статус согласованных заказов на закупку
- проводить пакетное утверждение или отмену складских накладных
- исследовать структуру таблиц и схему полей в базе данных ERP
- создавать и валидировать новые документы продаж через WebAPI
Примеры запросов агенту
- Найди все согласованные заказы на закупку за текущий месяц
- Сформируй черновик заказа на продажу по указанным позициям
- Покажи структуру полей таблицы производственных заказов
Как установить Kingdee K3Cloud (Cloud Galaxy) ERP
Командой платформы
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Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from kingdee-mcp <команда>
Командой платформы
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-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from kingdee-mcp <команда>
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from kingdee-mcp <команда>
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from kingdee-mcp <команда>
Командой платформы
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-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from kingdee-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Kingdee K3Cloud (Cloud Galaxy) ERP
Как установить Kingdee K3Cloud (Cloud Galaxy) ERP в Claude Code?
Выполните команду `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`, указав URL системы, ID учётной записи и пароль интеграционного пользователя.
Какая схема авторизации используется для связи с Kingdee?
Сервер подключается через метод ValidateUser по связке логина и пароля конкретного пользователя ERP. Это гарантирует сохранение настроенных ролевых прав и ограничений доступа к данным.
Что необходимо для запуска инструментов исследования SQL Server?
Помимо переменных окружения MCP_SQLSERVER_* с параметрами подключения, на хосте должен быть заранее установлен системный ODBC-драйвер msodbcsql18.