mcp-erpnext
MCP-сервер для ERPNext и Frappe: документы, склад и продажи из чата, плюс девять окон просмотра в клиенте
- 123 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Ключ и секрет API открывают агенту документы, счета и остатки в пределах прав пользователя ERPNext
- Инструменты создают, отправляют, отменяют и удаляют документы, поэтому ошибочная команда меняет учет
- Ключ и секрет лежат в переменных окружения конфигурации клиента MCP в открытом виде
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-erpnextОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Ключ и секрет API открывают агенту документы, счета и остатки в пределах прав пользователя ERPNext
- Инструменты создают, отправляют, отменяют и удаляют документы, поэтому ошибочная команда меняет учет
- Ключ и секрет лежат в переменных окружения конфигурации клиента MCP в открытом виде
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mcp-erpnext подключает ERPNext и Frappe к любому клиенту с поддержкой MCP: Claude Desktop, Claude Code или VS Code с Copilot. Агент читает и меняет документы через API по ключу и секрету пользователя, а результат показывает в интерактивных окнах прямо в клиенте. Окон девять: просмотр документа, таблица любого типа документов, счет с позициями, остатки склада, график, канбан для задач, сделок и обращений, карточка KPI, воронка продаж и просмотр записанных данных покупки. Инструменты разбиты по категориям, например продажи, склад и операции. Лишние категории или отдельные инструменты отключают флагами `--categories` и `--exclude-tools` либо переменными окружения. Сервер работает с собственным ERPNext и с облаком Frappe Cloud. По умолчанию он запускается через `npx` как локальный процесс, а общий HTTP-режим с OAuth описан в отдельных документах проекта.
Для кого. Командам, которые ведут учет в ERPNext и хотят смотреть отчеты и править документы разговором с агентом, не открывая веб-интерфейс.
Подходит, если
- Менеджеру надо быстро увидеть воронку продаж или остатки на складе, не заходя в ERPNext
- Счет, задачу или сделку проще создать фразой в чате, а результат сразу посмотреть в окне
- Пустой экземпляр ERPNext наполняют стартовыми данными по инструкции из документации проекта
- Рабочий сервер должен обслуживать нескольких пользователей по HTTP с входом через OAuth
Не подходит, если
- Агенту нельзя доверить запись: сервер умеет менять и удалять документы, и сузить его можно только исключением инструментов
- Учет ведется в другой системе, например в Odoo: для нее в каталоге есть отдельные серверы
- Клиент не поддерживает MCP Apps, и окна просмотра с частью действий в них недоступны
Пример запроса к агенту
Покажи воронку продаж за квартал, а потом открой три самых крупных счета и выведи позиции каждогоMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
ERPNEXT_URLобязательная- Адрес экземпляра ERPNext без закрывающей косой черты
ERPNEXT_API_KEYобязательная, секрет- Ключ API пользователя ERPNext
ERPNEXT_API_SECRETобязательная, секрет- Секрет API, парный к ключу
ERPNEXT_CATEGORIES- Список категорий инструментов, которые нужно загрузить
ERPNEXT_EXCLUDE_TOOLS- Инструменты, которые нужно исключить
Ограничения
Нужны адрес ERPNext, ключ API и секрет: их выпускают в настройках пользователя в разделе API Access. На пустом экземпляре бизнес-инструменты падают на проверке, пока нет справочных данных. Окна и часть действий зависят от возможностей клиента MCP, и версию 3.3 автор советует сначала испытать на том клиенте, которым вы пользуетесь, а уже потом менять рабочую установку. HTTP-режим версии 3.0 несовместим с HTTP-клиентами, написанными до 2026 года.
Как отключить. Удалите блок `erpnext` из конфигурации клиента MCP и перезапустите клиент. Ключ и секрет API можно отозвать в настройках пользователя ERPNext.
Частые вопросы
Как получить ключ и секрет для ERPNext?
В ERPNext откройте меню справа вверху, затем My Settings и раздел API Access, нажмите Generate Keys и скопируйте API Key и API Secret. Для облака Frappe адрес вида `https://mysite.frappe.cloud` указывают в `ERPNEXT_URL`.
Как оставить только нужные инструменты?
Флагом `--categories`, например `npx -y @casys/mcp-erpnext --categories=sales,inventory`. Для исключений есть `--exclude-tools` и переменные `ERPNEXT_CATEGORIES`, `ERPNEXT_EXCLUDE_CATEGORIES`, `ERPNEXT_EXCLUDE_TOOLS`; значения из командной строки перекрывают переменные.
Работает ли сервер с ERPNext Cloud?
Да. Ключ API работает так же, как на собственном сервере: в `ERPNEXT_URL` укажите адрес вида `https://mycompany.erpnext.com` или `https://mysite.frappe.cloud`.
Какие окна просмотра есть?
Девять: просмотр документа, таблица документов, счет, остатки склада, график, канбан, карточка KPI, воронка продаж и просмотр записанных данных покупки. Они открываются внутри клиента, который поддерживает MCP Apps.
Как запустить сервер для нескольких клиентов сразу?
В режиме HTTP: один постоянный процесс вместо отдельного на каждый клиент. Порядок запуска описан в `docs/http-deployment.md`, вход через OAuth настраивают по `docs/oauth-setup.md` из того же репозитория.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Odoo: агент читает, создает и обновляет записи ERP, ищет данные и вызывает бизнес-операции через права Odoo
Самостоятельный MCP-сервер для Odoo: чтение и защищенная запись данных ERP через агента, любая редакция и версия
Коннектор Odoo для агента: поиск, создание и правка записей любой модели ERP обычным языком, Odoo с 14 по 20 версии
MCP-сервер RetailCRM
RetailCRM MCP Server
MCP-сервер RetailCRM с готовым деплоем на Railway или Render: заказы, клиенты, товары, статистика и справочники
RetailCRM MCP
retailcrm-mcp
MCP-сервер RetailCRM: заказы, клиенты, товары, остатки, оплаты, задачи и аналитика магазина через API v5
Размещенные MCP-серверы Salesforce подключают Claude, Cursor и ChatGPT к данным организации с правами вошедшего пользователя.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| mcp-erpnext (эта карточка) | нет | API-ключ | 123 | |
| Frappe Assistant Core | нет | OAuth | 337 | ставится как приложение внутрь самого Frappe, внешний процесс не нужен |
| Odoo MCP | нет | API-ключ | 433 | сервер для другой ERP-системы Odoo |
Коротко о README
Документация открывается примечанием об установке версии 3.3.1 через npm и Deno, затем дает снимки окон, список изменений и карту документов по принципу Diátaxis: учебник, практические руководства, справочник по инструментам и переменным.