Kingdee K3Cloud MCP
MCP-сервер для ERP Kingdee K3Cloud: 15 инструментов запросов, выгрузки и документов с режимом только для чтения.
- 106 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- В режиме записи агент может сохранять, проводить и удалять документы ERP от имени интеграционного пользователя.
- Ключ приложения открывает доступ к данным склада, продаж и закупок.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/kingdee-k3cloud-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- В режиме записи агент может сохранять, проводить и удалять документы ERP от имени интеграционного пользователя.
- Ключ приложения открывает доступ к данным склада, продаж и закупок.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает ассистента к 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.
Для кого. Администраторам и разработчикам, которые поддерживают ERP Kingdee K3Cloud и хотят отвечать на вопросы по складу и документам через ассистента.
Подходит, если
- Менеджер спрашивает, сколько материала лежит на каждом складе, и не хочет открывать веб-интерфейс.
- Из ERP надо выгрузить все исходящие накладные за март в csv.
- Агент должен читать данные ERP с жесткой границей только для чтения.
- Нужно создать и провести документ по шаблону через ассистента с проверкой человеком.
Не подходит, если
- Работа идет с другой ERP: инструменты построены под API Kingdee K3Cloud.
- Нет прав на создание ключей в разделе сторонних систем администраторской консоли.
- Агент без надзора должен менять и удалять документы в боевой базе.
Пример запроса к агенту
Покажи проведенные заказы продаж за прошлую неделю, отсортируй по сумме и выгрузи все накладные за март в csv.MCP
- Транспорт
- stdio, sse, http
- Авторизация
- API-ключ
Переменные окружения
KD_SERVER_URLобязательная- Адрес сервера Kingdee, заканчивается на /k3cloud/.
KD_ACCT_IDобязательная- Идентификатор учетной базы.
KD_USERNAMEобязательная- Имя интеграционного пользователя.
KD_APP_IDобязательная- Идентификатор приложения из раздела авторизации сторонних систем.
KD_APP_SECобязательная, секрет- Секрет приложения.
KD_EXPORT_DIR- Каталог для выгрузок, по умолчанию временный.
Ограничения
Для запуска нужны пять переменных окружения: адрес сервера, идентификатор учетной базы, имя интеграционного пользователя, идентификатор и секрет приложения. Приложение регистрируют в разделе авторизации сторонних систем консоли Kingdee и на сайте Open. Для интеграции лучше создать отдельного пользователя, а не использовать администратора. Без параметра `--mode readonly` агент получает инструменты записи и удаления, и все действия выполняются от этого пользователя. Документация проекта на китайском с английской версией в `README.en.md`. Нужен Python 3.10 или новее.
Как отключить. Удалите запись `kingdee-k3cloud` из `.mcp.json` или настроек клиента и отзовите ключ приложения в разделе авторизации сторонних систем Kingdee.
Частые вопросы
Как подключить сервер к 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` лишь добавляет знание форм и типовых запросов и сокращает число проб.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для данных 1С:Предприятия через OData: дебиторка, продажи, остатки и деньги, а по отдельному флагу создание и проведение документов
Официальный MCP-сервер Xero: агент смотрит счета, контакты, проводки и отчеты в бухгалтерии, а также создает счета, платежи и табели
MCP-сервер к базе SEC EDGAR: отчетность компаний США, финансовые формы 10-K, 10-Q, 8-K, данные из XBRL и сделки инсайдеров
MCP-сервер для JSON API 1.2 МойСклад: остатки, заказы, отчеты о прибыли и создание документов за двумя уровнями защиты
Официальный MCP-сервер японского сервиса freee и скилл с рецептами: бухгалтерия, кадры и зарплата, счета, трудозатраты, договоры с подписью через AI-агента
MCP-сервер к SEC EDGAR на Python: отчеты 10-K и 8-K, XBRL-финансы, сделки инсайдеров и портфели фондов без API-ключа.
Коротко о README
Проект выходит как пакет в PyPI и запускается через pip или uvx. В README описан порядок получения пяти ключей в консоли Kingdee, конфигурации для десятка клиентов и сравнение с другими решениями для этой ERP.