Yzel — 1C:Enterprise — Claude Code MCP server: how to install
MCP server connecting AI assistants to 1C:Enterprise systems via OData v3. Useful for querying records across on-premise and 1C:Fresh cloud setups.
claude mcp add yzel -e YZEL_KEY=<YZEL_KEY> -- uvx yzelWhat Yzel — 1C:Enterprise does
This server enables language models to inspect and query 1C:Enterprise environments over OData v3 with basic authentication. It parses $metadata using a streaming approach designed for large ERP schemas. It properly handles native Cyrillic entity names without requiring manual aliasing.
Credentials reside locally inside an AES-256 encrypted SQLite store at ~/.yzel/store.db. The tool requires Python 3.11 or higher. Without exposed OData endpoints on your 1C instance, the connector cannot discover schemas or fetch records.
What it helps with
- retrieve records and document entries from 1C:Enterprise over OData v3
- inspect configuration schemas containing native Cyrillic identifiers
- query business data from 1C:Fresh cloud deployments
- parse large enterprise data schemas via streaming metadata inspection
Example prompts for the agent
- Show the last ten sales invoices from 1C for this week grouped by customer
- Look up current stock levels in 1C for item code 48201
- Check outstanding balances for the specified client across open contracts in 1C
How to install Yzel — 1C:Enterprise
Platform CLI
claude mcp add yzel -e YZEL_KEY=<YZEL_KEY> -- uvx yzelReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from yzel <command>
Platform CLI
codex mcp add yzel-1centerprise --env YZEL_KEY=<YZEL_KEY> -- uvx yzelReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from yzel <command>
Config file
{
"mcpServers": {
"yzel-1centerprise": {
"command": "uvx",
"args": [
"yzel"
],
"env": {
"YZEL_KEY": "<YZEL_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from yzel <command>
Config file
{
"servers": {
"yzel-1centerprise": {
"type": "stdio",
"command": "uvx",
"args": [
"yzel"
],
"env": {
"YZEL_KEY": "<YZEL_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from yzel <command>
Platform CLI
gemini mcp add -e YZEL_KEY=<YZEL_KEY> yzel-1centerprise uvx yzelReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from yzel <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Yzel — 1C:Enterprise
How to install Yzel — 1C:Enterprise in Claude Code?
Run claude mcp add yzel -e YZEL_KEY=<YZEL_KEY> -- uvx yzel. You can configure credentials via yzel config add-1c.
What does Yzel — 1C:Enterprise do?
It connects your AI assistant directly to 1C:Enterprise over OData v3, letting the model query tables and inspect business schemas.
Does it support 1C:Fresh cloud deployments?
Yes, it works with both on-premise installations and 1C:Fresh. Configure the cloud version by running yzel config add-1c --fresh.
