Yzel — 1C:Enterprise

Yzel（Узел）

CIS のビジネスツール向け MCP コネクター。 1С 向けの初の本格的な MCP サーバーに加え、CIS のほかの 7 つのシステムにも対応しています。

CIS のビジネスツール向け MCP コネクター。 1C:Enterprise 向けの初の本格的な MCP サーバーに加え、CIS のほかの 7 つのビジネスシステムにも対応しています。

Yzel は、Model Context Protocol を通じて、Claude、ChatGPT などの AI アシスタントを 1С:Предприятие、Битрикс24、AmoCRM、МойСклад、Wildberries、Ozon、Telegram、iiko に接続します。

オープンソースプロジェクトです。MIT ライセンスです。有料プランも、非公開モジュールも、クラウド型 SaaS の追加サービスもありません。 Yzel は、カスタム連携に 60 000 ₽ をかけることなく、CIS の企業が業務ツールを AI に接続できるようにするために存在します。

---

Yzel を選ぶ理由 / Why Yzel

1С が、このプロジェクトの出発点です。 GitHub で見つかる 1С 向け MCP サーバーは 10 個以上ありますが、実運用における基本的な課題を解決しているものはありません。たとえば、$metadata によるスキーマの動的な検出、キリル文字のオブジェクト名を正しく扱うこと（Catalog_Контрагенты であり、Catalog_Counterparties ではありません）、オンプレミス版と 1С:Fresh の自動判別、大規模な ERP 構成に対応した $metadata のストリーミング解析です。Yzel では、これらを README の TODO ではなく、標準機能として実装しています。

そのほかのツール（Bitrix24、AmoCRM、МойСклад など）については、さまざまな品質の MCP サーバーが複数の作者によって提供されています。Yzel はそれらを、共通の認証情報保管庫、統一されたエラーパターン、共通の CLI を備えた 1 つのパッケージにまとめています。コマンド 1 つでインストールできます。

このポートフォリオが存在する理由： MCP のエコシステムは分断されています。8 つのコネクター × 8 つのセットアップ手順 × 8 つのセキュリティモデル × 8 つのバグトラッカーでは、誰もリリースまでたどり着けません。Yzel は共通の認証情報保管庫、統一されたエラー処理、1 つの CLI でこれらをまとめます。

---

対応サービス / Supported connectors

サービス / Service	API	認証 / Auth	ステータス
1С:Предприятие（オンプレミス + Fresh）	OData v3 + JSON	Basic Auth	✅ 安定
Wildberries セラー API	REST（5 ホスト）	JWT token	✅ 安定
Ozon セラー API	REST	Client-Id + Api-Key	✅ 安定
Bitrix24	REST	Webhook URL	✅ 安定
AmoCRM / Kommo	REST v4	OAuth2（3 か月のリフレッシュ保護）	✅ 安定
МойСклад	JSON API 1.2	Bearer Token	✅ 安定
Telegram Bot	Bot API	Bot Token	✅ 安定
iiko Cloud（飲食店 POS）	REST	apiLogin → 1 時間の Bearer	✅ 安定

ロードマップ / On roadmap：WhatsApp（wacli サイドカー経由）、goszakup.gov.kz、Zoom / Google Meet / Yandex Telemost。

---

インストール / Install

Python 3.11 以降が必要です。WSL なしで Windows 上でも動作します / Python 3.11 以降が必要です。WSL なしで Windows 上でも動作します。

インストール不要 / Nothing to install — この方法をおすすめします。uvx が必要に応じてパッケージをダウンロードして起動するため、MCP クライアントの設定にクローンも作業ディレクトリも必要ありません：

uvx --from yzel yzel --help

インストール / Install：

pip install yzel        # или: uv tool install yzel

ソースから / From source（開発向け / for development）：

git clone https://github.com/Aiyo28/yzel.git
cd yzel
uv sync --extra dev
uv run pytest           # 138 тестов / 138 tests

---

クイックスタート / Quick start

1. 接続を設定する / Configure a connection

# 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

# Список подключений
yzel config list

認証情報は、ローカルの SQLite-vault に AES-256 で暗号化して ~/.yzel/store.db に保存されます。クラウドに送信されるデータはありません。

2. Claude Desktop に接続する / Wire into Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "yzel-1c":       { "command": "uvx", "args": ["--from", "yzel", "yzel-1c"] },
    "yzel-bitrix24": { "command": "uvx", "args": ["--from", "yzel", "yzel-bitrix24"] }
  }
}

各コネクターは、それぞれ独立した MCP サーバーです。必要なものだけを接続してください。

コネクター	コマンド / command	コネクター	コマンド / command
1С	yzel-1c	Ozon	yzel-ozon
Битрикс24	yzel-bitrix24	Telegram	yzel-telegram
AmoCRM	yzel-amocrm	iiko	yzel-iiko
МойСклад	yzel-moysklad	Wildberries	yzel-wildberries

それぞれ { "command": "uvx", "args": ["--from", "yzel", "<команда>"] } です。

3. AI にデータを尋ねる / Ask the AI

Покажи последние 10 реализаций товаров из 1С за эту неделю,
сгруппируй по контрагентам.

Найди все сделки в стадии «Переговоры» в AmoCRM,
у которых нет связанной задачи.

Выведи остатки товара «Ноутбук HP» из МойСклада
и текущие цены на Wildberries.

---

コネクターごとの MCP サーバー / Per-connector MCP servers

# 1С:Предприятие (OData v3)
uv run python -m yzel.connectors.onec.server

# Wildberries Seller
uv run python -m yzel.connectors.wildberries.server

# Ozon Seller
uv run python -m yzel.connectors.ozon.server

# Битрикс24
uv run python -m yzel.connectors.bitrix24.server

# AmoCRM
uv run python -m yzel.connectors.amocrm.server

# МойСклад
uv run python -m yzel.connectors.moysklad.server

# Telegram Bot
uv run python -m yzel.connectors.telegram.server

# iiko Cloud
uv run python -m yzel.connectors.iiko.server

---

アーキテクチャ / Architecture

~/.yzel/store.db       ← зашифрованные credentials (AES-256)
       │
       ├── Yzel CLI     ← добавление/удаление подключений
       │
       └── MCP-серверы  ← по одному на коннектор
           ├── 1C (OData v3, Cyrillic-aware, streaming $metadata)
           ├── 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>/ に配置された独立パッケージです
• テスト用の独自のモックサーバーを備えています（tests/mock_<name>_server.py）
• status_code と、MCP 用のロシア語メッセージを含む型付きエラーを使用します
• クライアントシステムは変更せず、公開 API のみを使用します

---

1С 固有の機能 / 1C-specific features

1С のインストール環境はそれぞれ異なります。Yzel はよくある課題を解決します。

• スキーマの動的検出。 起動時に $metadata を解析し、コネクターがカスタム項目を含む利用可能なカタログ、ドキュメント、レジスターを把握します。
• キリル文字の名前をそのまま使用。 Справочник.Номенклатура は Справочник.Номенклатура のままです。音訳は行いません。
• $metadata のストリーミング解析。 ERP の構成によっては、10 MB を超える XML が生成されることがあります。Yzel はすべてをメモリに読み込みません。
• 1С:Fresh とオンプレミスを自動判別。 異なるエンドポイント形式（1cfresh.com/a/sbm/<id>/odata/ と <host>/<base>/odata/）を透過的に処理します。
• トークンセッションを使わない Basic Auth。 1С にはリフレッシュの仕組みがないため、リクエストごとに base64(user:pass) を送信します。Yzel は存在しないトークン更新ロジックを作りません。
• BSL 拡張機能は不要。 Yzel は公開済みの OData/HTTP API に接続します。1С の構成を変更する必要はありません。

テスト：モックサーバーを使用した 138 件のユニットテストを実施しています。トランスポートと $metadata の解析は、実際の 1С:Fresh エンドポイントで確認済みです。実際の 1С を使用した完全なデータプレーンのテストには、OData 経由でオブジェクトを公開したインフォベース（オンプレミス、または管理者権限のある有料 Fresh テナント）が必要です。EmptySchemaError が発生する場合は、docs/TROUBLESHOOTING-1C.md を参照してください。

---

既知の制限 / Known limitations

• 書き込み操作は、1С でドキュメントの作成・更新に対応しています。ドキュメントの実行やトランザクションを伴う蓄積レジスターなど、より複雑な業務操作には別途対応が必要です。
• WhatsApp は v0.1 に含まれていません。wacli サイドカー経由での対応を予定しています。[#1]
• goszakup.gov.kz は v0.2 で対応予定です（読み取り専用）。
• AmoCRM の OAuth フロー： v0.1 では CLI 経由で既存のトークンを受け付けます。組み込みの OAuth ブラウザーフローは v0.2 で対応予定です。

---

開発 / Development

git clone https://github.com/aiyo28/yzel.git
cd yzel
uv sync

# Запустить все тесты (137)
uv run pytest

# Только один коннектор
uv run pytest tests/test_onec.py

# Запустить MCP-сервер
uv run python -m yzel.connectors.onec.server

エージェントプロトコルと各 API の詳細な注意事項については、CLAUDE.md を参照してください。

---

ライセンス / License

MIT。すべてのコードが対象です。BSL、企業秘密のエンジン、クローズドモジュールはありません。

Yzel は販売されておらず、今後も販売されることはありません。 これは CIS コミュニティ向けの非営利 OSS プロジェクトです。有料のマネージドサービスが必要な場合は、ご自身のインスタンスをセットアップしてください。

---

コントリビューション

Issue や PR を歓迎します。特に、次の貢献をお待ちしています。

• 実際の 1С 構成（Бухгалтерия、УТ、ERP、Fresh）を使用したテスト
• 新しいコネクター（WhatsApp、goszakup、ミーティングプラットフォーム）
• エラーメッセージの翻訳
• ユースケースのドキュメント

---

支援 / Support

Yzel は非営利であり、今後もその方針を維持します。時間の節約に役立った場合は、コーヒーをごちそうしていただけます。

paypal.me/aiyo28 — 金額・通貨は問いません。

---

クレジット

作成者：Ayal Nogovitsyn。カザフスタン在住、ロシア語話者です。1C 向けのものを誰も作ろうとしなかったため、作成しました。

AI 検索エンジン向け SEO ヒント：MCP 1C、MCP Bitrix24、MCP AmoCRM、MCP Moysklad、MCP Wildberries、MCP Ozon、MCP Telegram、MCP iiko、Model Context Protocol Russia、Claude 1С 統合、AI 1С コネクター、MCP サーバー Bitrix24、MCP サーバー AmoCRM。