MCP-сервер 1С:Фреш на Python
1c-fresh-mcp
MCP-сервер для 1С:Фреш через стандартный OData: счета, продажи, контрагенты, обходит известные ограничения OData 1С:Фреш и учитывает НДС 22 процента
- 1 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- 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 и установка зависимостей с проверкой соединения.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- 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-сервер 1С:Фреш отличается от других MCP для 1С?
Сервер работает с облачным 1С:Фреш через стандартный OData: справочники (контрагенты, товары и услуги, организации, банковские платежи) и документы (счета, продажи). Он обходит известные ограничения OData 1С:Фреш и учитывает НДС 22 процента.
Почему фильтр по ИНН сделан на стороне клиента и как учитывается НДС?
OData 1С:Фреш не умеет фильтровать по ИНН на стороне сервиса, поэтому сервер получает данные и фильтрует их сам. Ставка НДС 22 процента заложена в расчетах сервера. Установка: git clone, запуск по README. Работает в Claude Desktop и Claude Code. Риск высокий.
Обсуждение
Вопросов и отзывов пока нет.
CLI и MCP-сервер для 1С:Фреш
1C-Fresh: CLI и MCP
CLI и локальный MCP-сервер на Go для 1С:Фреш через OData: товары, цены, остатки, покупатели, заказы, продажи и деньги
MCP-сервер для данных 1С:Предприятия через OData: дебиторка, продажи, остатки и деньги, а по отдельному флагу создание и проведение документов
MCP-сервер для баз 1С:Предприятия через стандартный OData: справочники, документы, регистры и бухгалтерия без расширений в конфигурации
MCP-сервер OData 1С
1C OData MCP Server
Небольшой MCP-сервер на Python, который оборачивает стандартные операции чтения OData 1С:Управление предприятием в три инструмента
MCP-сервер OData 1С с JSON-кэшем
MCP сервер для работы с OData 1C
Python MCP-сервер поверх OData 1С: читает и меняет справочники и документы, сохраняет все данные в JSON-файлы для локального анализа без повторных запросов
АИ Финансист: MCP-сервер для 1С
mcp_1c (AI Финансист)
Связка MCP-сервера, OData-клиента 1С и локальной языковой модели с чатом на Gradio для вопросов по данным 1С и загруженным PDF
Коротко о README
Двуязычный README перечисляет группы MCP-инструментов от health-проверки до низкоуровневых odata_get/post/patch, таблицу известных особенностей OData 1С:Фреш с обходными решениями, переменные окружения для подключения и PDF, пример прямого использования Python-коннектора и раздел про генерацию PDF счета в двух вариантах: для письма и для печати.