Frappe Assistant Core MCP
Приложение Frappe, которое превращает сайт ERPNext в MCP-сервер: Claude и ChatGPT работают со счетами, складом и отчетами
- 333 ★ репозитория
- Последний коммит
- AGPL-3.0
Широкий доступ
Почему такой уровень
- Модель получает права сотрудника ERPNext, в том числе на создание, изменение и удаление документов
- Инструменты анализа выполняют Python и открывают финансовые и клиентские данные компании
Установка
- Работает в
Ручная установка
bench get-app https://github.com/buildswithpaul/Frappe_Assistant_Core && bench --site <your-site> install-app frappe_assistant_coreУстановка на собственный bench. На Frappe Cloud приложение ставят из маркетплейса кнопкой Install.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Модель получает права сотрудника ERPNext, в том числе на создание, изменение и удаление документов
- Инструменты анализа выполняют Python и открывают финансовые и клиентские данные компании
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Frappe Assistant Core, сокращенно FAC, ставится в Frappe как обычное приложение и превращает сайт ERPNext в MCP-сервер. Клиент вроде Claude Desktop или ChatGPT входит через OAuth 2.0 под вашей учетной записью ERPNext и видит только те данные, которые видны вам в интерфейсе. Каждый вызов попадает в журнал Assistant Audit Log. Встроенные инструменты разложены по четырем плагинам, от операций Frappe до визуализации с дашбордами. Модель читает, создает, меняет и удаляет документы и ищет по DocType. Еще она строит отчеты, показывает ожидающие согласования и запускает шаги рабочих процессов. Плагин анализа данных выполняет Python и разбирает файлы. Администратор может публиковать Skills, то есть повторяемые инструкции для модели вроде закрытия месяца, и шаблоны запросов на Jinja с типизированными аргументами. Разработчики добавляют инструменты из своих приложений Frappe через хук.
Для кого. Для администраторов и разработчиков ERPNext и Frappe, которые хотят спрашивать нейросеть про счета, клиентов и остатки склада.
Подходит, если
- Менеджеру нужно спросить «покажи просроченные счета топ-пяти клиентов» в Claude Desktop, не заходя в отчеты ERPNext
- Нужно узнать остаток артикула по всем складам без построения отчета вручную
- Статус лида надо обновить и назначить дату следующего действия, оставив след в журнале аудита
- Команда хочет единообразные ответы по закрытию месяца: администратор публикует Skill, который указывает модели нужные отчеты
- Разработчик добавляет собственный инструмент своего приложения Frappe в тот же MCP-сервер через хук
Не подходит, если
- У вас нет Frappe версии 15 или 16 с Python 3.10: приложение требует их
- Нужно подключить Odoo, 1С или другую ERP: сервер рассчитан только на Frappe и ERPNext
- Администратор не готов доверить модели запись и удаление документов
Пример запроса к агенту
Покажи просроченные счета наших пяти крупнейших клиентов и сколько на складах осталось по артикулу SKU-1234.MCP
- Транспорт
- http
- Авторизация
- OAuth
Ограничения
Нужны Frappe версии 15 или 16 и Python 3.10 или новее, Node 22.12 требуется только для сборки интерфейса FAC Chat. Лицензия AGPL-3.0, условия коммерческого использования описаны в отдельном файле COMMERCIAL.md. Модель действует с правами пользователя ERPNext, под которым вошла, включая запись и удаление, поэтому роли стоит ограничить заранее. Встроенный чат FAC Chat работает по подписке FAC Cloud и по умолчанию выключен. API Anthropic и OpenAI из России недоступны.
Как отключить. Отключите коннектор в MCP-клиенте. Чтобы убрать приложение с сайта, выполните bench --site ваш-сайт uninstall-app frappe_assistant_core. Журнал Assistant Audit Log хранится в базе сайта, очистите его отдельно, если он больше не нужен.
Частые вопросы
Как подключить Frappe Assistant Core к Claude Desktop?
Откройте в Desk раздел FAC Admin и скопируйте MCP Endpoint URL. В Claude Desktop зайдите в Settings, Connectors, Add Custom Connector, вставьте адрес, нажмите Connect и войдите учетной записью ERPNext. После этого можно задавать вопросы, например «перечисли клиентов, созданных в этом месяце».
Какие данные увидит модель?
Только те, что доступны вошедшему пользователю в интерфейсе ERPNext. Вход идет по OAuth 2.0 от имени реального пользователя, поэтому действуют его роли и права.
Как установить FAC на Frappe Cloud и на свой bench?
На Frappe Cloud откройте вкладку Apps, найдите Frappe Assistant Core в маркетплейсе и нажмите Install. На собственном bench выполните `bench get-app https://github.com/buildswithpaul/Frappe_Assistant_Core` и `bench --site <ваш-сайт> install-app frappe_assistant_core`.
Чем FAC Chat отличается от MCP-сервера?
MCP-сервер бесплатный и работает со сторонними клиентами, а за модель вы платите сами. FAC Chat — встроенный чат в Desk и на странице /copilot. Он доступен только по подписке FAC Cloud и по умолчанию выключен.
Что такое Skills и шаблоны запросов?
Skills — документы FAC Skill с инструкциями для модели, например как проводить закрытие месяца. Шаблоны запросов — заготовки со вводом пользователя: выпадающие списки, даты, флажки. Оба вида публикует администратор.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный MCP-сервер Tableau: агент ищет источники данных, отправляет к ним запросы и открывает дашборды и метрики Pulse
MCP сервер и скиллы для продуктовой аналитики: пути пользователей, воронки, сегменты и графы переходов по событийным логам
MCP-сервер и CLI для управления настоящим Microsoft Excel: Power Query, DAX, VBA, сводные таблицы, диаграммы
MCP-сервер подключает Claude Code и Codex к открытой сессии R или Python в RStudio и Positron, где лежат ваши данные
Анализ отзывов клиентов на своем сервере: персональные данные скрыты до модели, а MCP-сервер и скилл отдают агенту цитаты из отзывов
Плагин и команды для сборки порталов данных: агент разворачивает портал из брифа и подключает датасеты из CKAN, GitHub и Frictionless
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Frappe Assistant Core (эта запись) | нет | OAuth | 333 | |
| MCP Server for Odoo | нет | ключ необязателен | 407 | подключает Odoo: чтение, создание и обновление записей ERP |
| Odoo MCP | нет | API-ключ | 425 | самостоятельно размещаемый сервер для Odoo с проверяемой записью |
Коротко о README
Подробная документация вынесена на сайт docs.assistantcore.cloud. В репозитории есть папка client_packages с готовыми пакетами для Claude Desktop.