MCP-сервер 1С:Фреш на Python
1c-fresh-mcp
MCP-сервер для 1С:Фреш через стандартный OData: счета, продажи, контрагенты, обходит известные ограничения OData 1С:Фреш и учитывает НДС 22 процента
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- create_invoice и post_document создают и проводят реальные документы в 1С:Фреш
- mark_for_deletion помечает объекты и документы на удаление
Установка
Ручная установка
git clone https://github.com/XRAT-dev/1c-fresh-mcp.git && cd 1c-fresh-mcp && cp .env.example .env && bash install.shКлонирование, заполнение .env и установка зависимостей с проверкой соединения.
Проверка безопасности
Как мы проверяемВысокий рискВысокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
- create_invoice и post_document создают и проводят реальные документы в 1С:Фреш
- mark_for_deletion помечает объекты и документы на удаление
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер обращается к стандартному интерфейсу OData облачного сервиса 1С:Фреш и дает агенту инструменты по справочникам (контрагенты, товары и услуги, организации, банковские платежи) и документам (счета на оплату и реализации: создание, чтение с табличной частью, проведение, снятие с проведения, пометка на удаление). Отдельно решены типовые проблемы OData в 1С:Фреш: фильтр по ИНН, который штатно отдает ошибку 500, обходится клиентской фильтрацией, табличная часть счета передается прямо в теле документа вместо отдельного PATCH, а адрес контрагента прописывается с нужным Вид_Key, чтобы попасть в печатную форму. В комплекте есть отдельный генератор PDF счета на оплату с логотипом и автоматической пагинацией длинных таблиц.
Для кого. Для владельцев малого бизнеса и бухгалтеров на 1С:Фреш, которым нужно выставлять счета и вести продажи через агента.
Подходит, если
- Нужно быстро выставить счет на оплату и получить готовый PDF
- Нужно найти контрагента по ИНН без ручного обхода ошибки OData
- Нужно провести или снять с проведения документ продажи
Не подходит, если
- Нужна работа с обычной десктопной 1С, а не с облачным 1С:Фреш
- Нужны низкоуровневые произвольные OData-запросы за пределами готовых инструментов odata_get, odata_post и odata_patch
Пример запроса к агенту
Найди контрагента по ИНН 1234567890 и выставь ему счет на автомат ABB на 3903.70 рубляMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
FRESH_BASE_URLобязательная- Адрес публикации 1С:Фреш без завершающего слеша.
FRESH_PASSWORDобязательная, секрет- Пароль пользователя OData.
FRESH_USERNAME- Пользователь OData, по умолчанию odata.user.
Ограничения
Рассчитан только на стандартный интерфейс OData 1С:Фреш, самую старую публикацию 8.3.5 с форматом Atom. Нужен Python 3.10+ и пользователь с ролью доступа к OData. PDF-баннер и данные банка настраиваются через переменные окружения и по умолчанию пустые.
Как отключить. Удалите сервер 1c-fresh из конфигурации MCP-клиента.
Частые вопросы
Почему фильтр по ИНН сделан на стороне клиента?
Потому что стандартный $filter по ИНН в 1С:Фреш возвращает HTTP 500, инструмент get_counterparty_by_inn получает список и фильтрует сам.
Как учитывается НДС 22 процента?
Сервер собирался с учетом ставки НДС 22 процента, действующей с 2025 года, это упомянуто в кратком описании проекта.
Похожие
MCP-серверыНабор скиллов для инвестиционного исследования компаний в Claude Code и Codex по методологиям четырех инвесторов. Это исследовательский инструмент, не инвестици
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
Официальный MCP-сервер брокера Alpaca: заявки по акциям, ETF, крипте и опционам, управление позициями и рыночные данные на естественном языке
inn-check-ru: светофор риска по ИНН
inn-check-ru
Открытый скилл, который по ИНН сверяет ЕГРЮЛ, ФССП, суды, банкротства и санкции сразу по нескольким источникам и выдает светофор риска с датой и причиной
Коротко о README
Двуязычный README перечисляет группы MCP-инструментов от health-проверки до низкоуровневых odata_get/post/patch, таблицу известных особенностей OData 1С:Фреш с обходными решениями, переменные окружения для подключения и PDF, пример прямого использования Python-коннектора и раздел про генерацию PDF счета в двух вариантах: для письма и для печати.