# Kingdee K3Cloud (Cloud Galaxy) ERP

Kingdee K3Cloud (Cloud Galaxy) ERP — MCP-сервер для управления ERP через Claude Code: 101 инструмент для накладных, производства, закупок и складских остатков.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 146 у репозитория
- Автор: WaHaiLong
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/WaHaiLong/KingdeeMCP
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/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`.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `KINGDEE_SERVER_URL`, `KINGDEE_ACCT_ID`, `KINGDEE_USERNAME`, `KINGDEE_PASSWORD` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 <команда>

## Когда брать
- запрашивать статус согласованных заказов на закупку
- проводить пакетное утверждение или отмену складских накладных
- исследовать структуру таблиц и схему полей в базе данных ERP
- создавать и валидировать новые документы продаж через WebAPI

## Примеры запросов агенту
- Найди все согласованные заказы на закупку за текущий месяц
- Сформируй черновик заказа на продажу по указанным позициям
- Покажи структуру полей таблицы производственных заказов

## Похожие
- [Olist Tiny ERP](https://affpapa.org/nevibecode/mcp/olist-tiny-erp.md) — MCP-сервер · 302 установки
- [Frihet ERP](https://affpapa.org/nevibecode/mcp/frihet-erp.md) — MCP-сервер · ★ 13 у репозитория
- [erp-integration-analysis](https://affpapa.org/nevibecode/skills/erp-integration-analysis.md) — скилл · 117 установок
- [ERP Facts](https://affpapa.org/nevibecode/mcp/erp-facts.md) — MCP-сервер
- [tres-erp-rule-suggestions](https://affpapa.org/nevibecode/skills/tres-erp-rule-suggestions.md) — скилл · ★ 4931 у репозитория

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
