Kingdee K3Cloud MCP
MCP-сервер для ERP Kingdee K3Cloud: 15 инструментов запросов, выгрузки и документов с режимом только для чтения.
- 106 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- В режиме записи агент может сохранять, проводить и удалять документы ERP от имени интеграционного пользователя.
- Ключ приложения открывает доступ к данным склада, продаж и закупок.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/kingdee-k3cloud-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- В режиме записи агент может сохранять, проводить и удалять документы ERP от имени интеграционного пользователя.
- Ключ приложения открывает доступ к данным склада, продаж и закупок.
This is third-party code. Review the repository files before installing.
What it does
Сервер подключает ассистента к ERP Kingdee K3Cloud через официальный Python SDK и веб-API. Все 15 инструментов принимают параметр `form_id`, поэтому одни и те же вызовы работают с материалами, клиентами, заказами продаж и закупок и другими формами. Запросы возвращают данные массивом или JSON, а высокоуровневые инструменты сами листают страницы: `query_bill_all` собирает результат целиком, `query_bill_to_file` пишет ndjson или csv на диск, `query_bill_range` делит период на месяцы, недели или дни. В режиме чтения и записи есть инструменты сохранения, отправки, проведения и отмены проведения, удаления, выполнения операций и проталкивания документа дальше по цепочке, например из заказа продаж в уведомление об отгрузке. Инструмент `query_metadata` показывает реальные поля формы, и это помогает на инсталляциях с доработками. Сервер работает по stdio, SSE и streamable-http.
Who it is for. Администраторам и разработчикам, которые поддерживают ERP Kingdee K3Cloud и хотят отвечать на вопросы по складу и документам через ассистента.
Good fit when
- Менеджер спрашивает, сколько материала лежит на каждом складе, и не хочет открывать веб-интерфейс.
- Из ERP надо выгрузить все исходящие накладные за март в csv.
- Агент должен читать данные ERP с жесткой границей только для чтения.
- Нужно создать и провести документ по шаблону через ассистента с проверкой человеком.
Not a fit when
- Работа идет с другой ERP: инструменты построены под API Kingdee K3Cloud.
- Нет прав на создание ключей в разделе сторонних систем администраторской консоли.
- Агент без надзора должен менять и удалять документы в боевой базе.
Example request
Покажи проведенные заказы продаж за прошлую неделю, отсортируй по сумме и выгрузи все накладные за март в csv.MCP
- Transport
- stdio, sse, http
- Authentication
- API key
Environment variables
KD_SERVER_URLrequired- Адрес сервера Kingdee, заканчивается на /k3cloud/.
KD_ACCT_IDrequired- Идентификатор учетной базы.
KD_USERNAMErequired- Имя интеграционного пользователя.
KD_APP_IDrequired- Идентификатор приложения из раздела авторизации сторонних систем.
KD_APP_SECrequired, secret- Секрет приложения.
KD_EXPORT_DIR- Каталог для выгрузок, по умолчанию временный.
Limitations
Для запуска нужны пять переменных окружения: адрес сервера, идентификатор учетной базы, имя интеграционного пользователя, идентификатор и секрет приложения. Приложение регистрируют в разделе авторизации сторонних систем консоли Kingdee и на сайте Open. Для интеграции лучше создать отдельного пользователя, а не использовать администратора. Без параметра `--mode readonly` агент получает инструменты записи и удаления, и все действия выполняются от этого пользователя. Документация проекта на китайском с английской версией в `README.en.md`. Нужен Python 3.10 или новее.
How to disable. Удалите запись `kingdee-k3cloud` из `.mcp.json` или настроек клиента и отзовите ключ приложения в разделе авторизации сторонних систем Kingdee.
FAQ
Как подключить сервер к Claude Code?
Создайте в папке проекта `.mcp.json` с командой `uvx kingdee-k3cloud-mcp` и переменными `KD_SERVER_URL`, `KD_ACCT_ID`, `KD_USERNAME`, `KD_APP_ID` и `KD_APP_SEC`.
Как запретить агенту менять данные?
Добавьте аргумент `--mode readonly` или переменную `MCP_MODE=readonly`. Остаются восемь инструментов запросов, инструменты записи отключены.
Как выгрузить десятки тысяч строк?
Используйте `query_bill_to_file`: он листает страницы сам и пишет ndjson или csv в каталог `KD_EXPORT_DIR`. Для периода на несколько лет подойдет `query_bill_range`.
Что делать, если ERP отвечает про потерянную сессию?
Сервер проверяет ключи при старте и возвращает понятную подсказку по настройке авторизации. Сверьте пять переменных и права интеграционного пользователя.
Нужен ли отдельный скилл?
Нет, сервер работает сам. Скилл `kingdee-k3cloud-skill` лишь добавляет знание форм и типовых запросов и сокращает число проб.
Discussion
No questions or reviews yet.
Related
MCP serversMCP server for 1C:Enterprise data over OData: receivables, sales, stock and cash, plus document creation and posting behind a separate flag
The official Xero MCP server: an agent reads invoices, contacts, journals and reports and creates invoices, payments and timesheets
An MCP server for SEC EDGAR: US company filings, forms 10-K, 10-Q and 8-K, XBRL-parsed financials and insider trades
MCP server for the MoySklad JSON API 1.2: stock, orders, profit reports and document creation behind two safety gates
The official MCP server for Japan's freee platform plus a recipe skill: accounting, payroll, invoices and e-signature contracts through an AI agent
A Python MCP server for SEC EDGAR: 10-K and 8-K filings, XBRL financials, insider trades and fund portfolios, no API key.
README in short
Проект выходит как пакет в PyPI и запускается через pip или uvx. В README описан порядок получения пяти ключей в консоли Kingdee, конфигурации для десятка клиентов и сравнение с другими решениями для этой ERP.