Query and update 1C:Enterprise over OData v3. Cyrillic-aware, Fresh and on-prem.
io.github.Aiyo28/yzel (MCP Server)
Yzel is an MCP server for “Query and update 1C:Enterprise over OData v3.” It is Cyrillic-aware and designed for Fresh and on-prem environments. The package positions itself as MCP connectors for CIS business tools, covering 1C plus additional systems in one bundle, as described in the readme excerpt.
🛠️ Key Features
Query and update 1C:Enterprise via OData v3
Cyrillic-aware handling
Supports Fresh and on-prem deployments
Packaged as MCP connectors for CIS business tools
🚀 Use Cases
Integrating 1C:Enterprise data operations through MCP
Connecting CIS business systems listed in the repository topics (e.g., amocrm, bitrix24, moysklad, ozon, wildberries)
⚡ Developer Benefits
MCP-compatible (per readme badge)
Python ecosystem indicated (Python 3.11+ from badge)
Includes MIT License (badge shown)
⚠️ Limitations
Source material does not specify supported MCP tools count, authentication details, or the full list of integrated systems beyond the topics shown.
Подключите AI-ассистента к 1С, Wildberries и Ozon. Открытый хобби-проект на MCP. Connect your AI assistant to 1C, Wildberries and Ozon. An open-source MCP hobby project.
Yzel подключает Claude, ChatGPT и других AI-ассистентов к 1С:Предприятию, Битрикс24, AmoCRM, МойСкладу, Wildberries, Ozon, Telegram и iiko через Model Context Protocol. Открытый код, MIT, без платных тарифов и закрытых модулей.
Yzel connects Claude, ChatGPT and other AI assistants to 1C:Enterprise, Bitrix24, AmoCRM, MoySklad, Wildberries, Ozon, Telegram and iiko over the Model Context Protocol. Open source, MIT, no paid tiers, no closed modules.
Откуда это / How it started
Друг попросил подключить Claude к своей 1С, а мне хотелось следить за Wildberries через AI. Я сделал и то, и другое, а потом добавил сервисы, которыми пользуются вокруг меня: Ozon, МойСклад, Битрикс24, AmoCRM, Telegram, iiko. Это хобби-проект: делаю в свободное время, бесплатно, под MIT.
A friend asked me to connect Claude to their 1C, and I wanted AI to keep an eye on Wildberries. So I built both, then added the other services people around me use: Ozon, MoySklad, Bitrix24, AmoCRM, Telegram, iiko. It's a hobby project: built in spare time, free, MIT.
Поддерживаемые сервисы / Supported connectors
Сервис / Service
API
Авторизация / Auth
Статус
1С:Предприятие (on-prem + Fresh)
OData v3 + JSON
Basic Auth
✅ Stable
Wildberries Seller API
REST (5 хостов)
JWT token
✅ Stable
Ozon Seller API
REST
Client-Id + Api-Key
✅ Stable
Bitrix24
REST
Webhook URL
✅ Stable
AmoCRM / Kommo
REST v4
OAuth2 (3mo refresh guard)
✅ Stable
МойСклад
JSON API 1.2
Bearer Token
✅ Stable
Telegram Bot
Bot API
Bot Token
✅ Stable
iiko Cloud (F&B POS)
REST
apiLogin → 1h Bearer
✅ Stable
Все восемь коннекторов ставятся одним пакетом, с общим хранилищем ключей и одним CLI. / All eight connectors ship in one package, with one credential store and one CLI.
Планируется / On the roadmap: WhatsApp (через wacli sidecar), goszakup.gov.kz, Zoom / Google Meet / Yandex Telemost. См. / See ROADMAP.md.
Установка / Install
Попробовать одной командой / Try it with one command
bash
uvx --from yzel yzel --help
uvx скачивает пакет и запускает его, ставить заранее ничего не нужно. Нужны uv и Python 3.11+; работает на Windows без WSL. Если uv уже стоит, первый запуск занимает около 4 секунд.
uvx fetches the package and runs it, nothing to install first. Needs uv and Python 3.11+; works on Windows without WSL. With uv already installed, the first run takes about 4 seconds.
Пакет опубликован в PyPI и в официальном MCP Registry как io.github.Aiyo28/yzel. / Published on PyPI and in the official MCP Registry as io.github.Aiyo28/yzel.
Claude Desktop в один клик (1С) / Claude Desktop, one click (1C)
Скачайте yzel-1c-<версия>.mcpb со страницы последнего релиза / Download the .mcpb from the latest release.
Откройте файл двойным щелчком, Claude Desktop покажет окно установки / Double-click it; Claude Desktop opens an install dialog.
Введите адрес OData, пользователя и пароль 1С / Enter the OData URL, 1C user and password.
Флажок «Только чтение» включён по умолчанию: Claude видит только инструменты чтения. Снимите его, чтобы разрешить запись / The «Только чтение» (read-only) checkbox is on by default: Claude sees only the read tools. Untick it to allow writes.
Python и зависимости Claude Desktop ставит сам, терминал не нужен. Пароль хранится в настройках Claude Desktop и уходит только на ваш сервер 1С.
Claude Desktop installs Python and dependencies itself, no terminal. The password stays in Claude Desktop's settings and is sent only to your 1C server.
# 1С (on-prem)
yzel config add-1c
# 1С:Fresh (облако)
yzel config add-1c --fresh
# Wildberries
yzel config add-wildberries
# Все остальные / any other
yzel config add-bitrix # Битрикс24
yzel config add-amocrm # AmoCRM
yzel config add-moysklad # МойСклад
yzel config add-ozon # Ozon
yzel config add-telegram # Telegram Bot
yzel config add-iiko # iiko Cloud# Список подключений / list connections
yzel config list
Учётные данные хранятся зашифрованными (Fernet: AES-128 + HMAC-SHA256) в локальном SQLite-vault ~/.yzel/store.db. Ключ лежит рядом в ~/.yzel/vault.key или задаётся через YZEL_KEY, так что копия папки ~/.yzel/ открывает и данные. Ничего не отправляется в облако. / Credentials are stored encrypted (Fernet: AES-128 + HMAC-SHA256) in a local SQLite vault at ~/.yzel/store.db. The key sits next to it in ~/.yzel/vault.key or comes from YZEL_KEY, so a copy of the ~/.yzel/ folder opens the data too. Nothing goes to a cloud.
Для 1С вместо vault можно задать переменные окружения, они имеют приоритет / For 1C, env vars can replace the vault and take precedence: YZEL_1C_URL, YZEL_1C_USERNAME, YZEL_1C_PASSWORD (пароль может быть пустым / the password may be empty).
Чтобы скрыть и запретить все инструменты записи, задайте YZEL_READ_ONLY=1 / To hide and refuse every write tool, set YZEL_READ_ONLY=1.
Каждая запись возвращает outcome: applied, rejected, not_sent, may_have_applied, duplicate_refused или refused. Повтор того же create после неясного ответа отклоняется 10 минут, чтобы документ не создался дважды. / Every write returns an outcome. An identical create after an unclear result is refused for 10 minutes, so a document is not created twice. См. / See docs/specs/write-safety.md.
2. Подключите к Claude Desktop / Wire into Claude Desktop
Покажи последние 10 реализаций товаров из 1С за эту неделю,
сгруппируй по контрагентам.
code
Найди все сделки в стадии «Переговоры» в AmoCRM,
у которых нет связанной задачи.
code
Выведи остатки товара «Ноутбук HP» из МойСклада
и текущие цены на Wildberries.
Особенности 1С / 1C-specific features
Каждая 1С-инсталляция уникальна. Что делает коннектор:
Находит схему сам. При первом вызове onec_list_entities или onec_schema парсится $metadata: коннектор узнаёт доступные справочники, документы, регистры, включая кастомные.
Кириллические имена как есть.Catalog_Номенклатура остаётся Catalog_Номенклатура, без транслитерации.
Streaming-парсинг $metadata. Конфигурации ERP могут давать 10+ МБ XML. Yzel не загружает всё в память.
Сам различает 1С:Fresh и on-prem. Разные форматы адреса (1cfresh.com/a/sbm/<id>/odata/ и <host>/<base>/odata/) обрабатываются без настройки.
Basic Auth без токен-сессий. В 1С нет refresh-потока, каждый запрос отправляет base64(user:pass). Yzel не изобретает несуществующую token-refresh логику.
Без BSL-расширений. Yzel подключается к опубликованным OData/HTTP API. Менять конфигурацию 1С не нужно.
Тесты идут против mock-серверов, которые я написал сам. Если сервис поменял API, тесты этого не увидят. Повторяемой проверки на живых аккаунтах пока нет: журнал в docs/LIVE-CHECKS.md пуст.
1С на живом 1С:Fresh проверена только до транспорта и $metadata. Пробные тенанты Fresh не публикуют объекты через OData, поэтому чтение и запись данных на реальной базе не подтверждены. Для этого нужна on-prem база или платный Fresh с правами администратора.
Запись в 1С: create, update и delete через OData. Проведение документов и регистры накопления с транзакциями не сделаны.
В один клик ставится только 1С. Остальные семь коннекторов ставятся через uvx и конфиг клиента.
MCP SDK закреплён на <2.0. Переход на mcp 2.x ещё не сделан.
AmoCRM: готовые токены вводятся через CLI, встроенного OAuth в браузере пока нет.
WhatsApp и goszakup.gov.kz пока не поддерживаются.
In English:
Tests run against mock servers I wrote myself. If a service changes its API, the tests can't see it. There is no repeatable live-account check yet: the run log in docs/LIVE-CHECKS.md is empty.
1C is verified on a live 1C:Fresh endpoint up to transport and $metadata only. Fresh trial tenants don't publish objects over OData, so reading and writing data on a real infobase is unconfirmed. That needs an on-prem infobase or a paid Fresh tenant with admin rights.
1C writes: create, update and delete over OData. Posting documents and accumulation registers with transactions are not done.
Only 1C installs in one click. The other seven connectors go through uvx and the client config.
The MCP SDK is pinned to <2.0. The mcp 2.x port is not done.
AmoCRM: tokens are entered through the CLI; there is no built-in browser OAuth flow yet.
WhatsApp and goszakup.gov.kz are not supported yet.
Архитектура / Architecture
code
Yzel CLI ──→ ~/.yzel/store.db ← зашифрованные credentials (Fernet), ключ в vault.key
│
YZEL_1C_* env ──────┤ ← для 1С env имеет приоритет; так их передаёт .mcpb
│
▼
core ← виды инструментов, YZEL_READ_ONLY,
│ write runner: outcome + 10-мин защита от дублей
▼
MCP-серверы ← по одному на коннектор
├── 1C (OData v3, Cyrillic-aware, $metadata по запросу, streaming)
├── Wildberries (5 хостов, per-host rate limits)
├── Ozon (dual-header auth, sandbox support)
├── Bitrix24 (webhook, leaky-bucket 2 req/sec)
├── AmoCRM (OAuth2 + 3mo refresh-staleness guard)
├── Moysklad (Bearer, rate limiter, expand-aware)
├── Telegram (retry_after handling)
└── iiko (apiLogin → 1h Bearer, auto-refresh)
│
▼
Claude / ChatGPT / любой MCP-клиент
Каждый коннектор:
Отдельный пакет в src/yzel/connectors/<name>/
Собственный mock-сервер для тестов (tests/mock_<name>_server.py)
Типизированные ошибки с status_code + RU-сообщения для MCP
Без модификаций клиентских систем, только публичные API
Разработка / Development
bash
git clone https://github.com/Aiyo28/yzel.git
cd yzel
uv sync --extra dev
uv run pytest
uv run pytest tests/test_onec.py # один коннектор / one connector
uv run python -m yzel.connectors.onec.server # MCP-сервер из исходников / server from source
Модули серверов / server modules: yzel.connectors.<name>.server, где / where <name> = onec, wildberries, ozon, bitrix24, amocrm, moysklad, telegram, iiko.
Протокол для агентов и особенности каждого API: CLAUDE.md. Как прислать изменения: CONTRIBUTING.md.
Issues и PR приветствуются. Особенно / Especially welcome:
Тестирование против реальных конфигураций 1С (Бухгалтерия, УТ, ERP, Fresh)
Новые коннекторы (WhatsApp, goszakup, meeting platforms)
Переводы error-messages
Документация use-case'ов
Лицензия и поддержка / License and support
MIT, весь код. Без BSL и закрытых модулей. Yzel некоммерческий и не продаётся.
MIT, all of it. No BSL, no closed modules. Yzel is non-commercial and not for sale.
Если Yzel сэкономил вам время, можете угостить кофе. / If Yzel saved you time, you can buy me a coffee.