@theyahia/1c-rest-mcp
OfficialThis server acts as an MCP gateway for 1C:Enterprise via its OData 3.0 REST API, enabling AI agents to discover, query, and manipulate business data. Key capabilities include:
Discover Structure: List all OData entities (catalogs, documents, registers, reports), fetch raw metadata, and describe specific entity fields.
Manage Catalogs: Read, create, and update catalog items with OData filtering, sorting, selection, and pagination.
Handle Documents: Read, create, update, post, unpost, and delete documents; locate by number or GUID; retrieve tabular sections.
Work with Registers: Read information/accumulation registers, write information register records, get accumulation balances, and read accounting register records.
Manage Constants: Get and set 1C constant values.
Shortcut Operations: Fuzzy-search by description, fetch by GUID (
Ref_Key), count entity records, set/clear deletion marks, retrieve recent documents.Generate Reports: Fetch 1C reports from configured HTTP service URLs.
Run Arbitrary OData Queries: Full support for
$filter,$select,$expand,$orderby,$top,$skip, and$inlinecounton any entity.Batch Operations: Batch-create documents, batch-update catalog items, and run multiple OData GET queries concurrently with bounded concurrency.
Track Changes: Poll for modified rows since a given timestamp using date field filters (no webhooks).
Guided Workflows (Prompts): Built-in multi-tool workflows —
inventory-database(database mapping),find-and-post-document(document management), andreconcile-balances(register comparison).Flexible & Secure Deployment: Runs via stdio or HTTP (with session management, CORS, graceful shutdown); supports HTTP Basic authentication and output sanitization.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@theyahia/1c-rest-mcpGet the document with number 'INV-001' and type 'Invoice'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
aprovodka
MCP server for 1C:Enterprise — an AI agent reads and writes live 1C database data through the platform's own OData 3.0 interface. No configuration extension, no BSL.
34 tools · 11 modules · Node.js 18+ · stdio + Streamable HTTP
📄 Сайт продукта и услуги · 📖 Руководство пользователя (рус., 75 стр.) · 💬 Заказать сверку цифр
npx -y @theyahia/aprovodkaСхема вашей базы + сверка цифр — 12 000 ₽
Сервер бесплатный и открытый. Платная — работа по вашей базе, где всё держится на одном: самоделка на OData не падает, она молча отдаёт неверное число. Проверить это можно только на конкретной конфигурации.
Что входит, за одну информационную базу:
файл схемы под вашу конфигурацию — какие сущности есть, как они называются, что с чем связано;
список ловушек именно вашей базы — где запрос вернёт правдоподобное, но неверное;
отчёт сверки по 10 согласованным вопросам — ответ агента стоит рядом с цифрой из вашего же штатного отчёта 1С, строка в строку.
Срок — 5 рабочих дней. Приёмка — по совпадению цифр, критерий согласуем до начала. Предоплата 100%, чек НПД. Условия целиком — договор-оферта.
📧 leadmanager81@yandex.ru · 💬 @metarebalancer — ответим в рабочие дни, 10:00–19:00 МСК. Напишите, какая у вас конфигурация и опубликован ли OData.
Related MCP server: 1C MCP Server
What it does
Business data in a 1C database is closed to outside programs until someone writes a report, an external data processor, or an exchange for it. aprovodka removes that cycle: the OData 3.0 interface is published by the platform itself, and that is enough.
Coverage: catalogs, documents, all four register kinds, the accounting register including its virtual tables (balances, turnovers, ext-dimensions), constants, batch operations, change tracking, and metadata discovery.
What makes it different from the rest of the niche:
No BSL, nothing installed into the configuration. Six of the eight comparable servers require an extension in the database; the two that don't, don't touch live data.
Writes, not just reads. Create and update documents, post and unpost, deletion marks.
A write-safety gate. Three modes —
off,preview,approval— intercepted at a single point in the client, so no tool can bypass it. Reversible operations return a rollback token; irreversible ones are labelled with the reason.Curated configuration presets for БП 3.0, УТ 11, ЗУП 3.1 and ERP 2 — key entities with Russian descriptions, ready query examples, and the traps people hit.
Configuration
{
"mcpServers": {
"aprovodka": {
"command": "npx",
"args": ["-y", "@theyahia/aprovodka"],
"env": {
"ONEC_BASE_URL": "https://server/base/odata/standard.odata",
"ONEC_LOGIN": "user",
"ONEC_PASSWORD": "pass"
}
}
}
}Set ONEC_WRITE_MODE to preview or approval to enable the write gate (off by default,
byte-for-byte the previous behaviour). Full environment reference, per-tool documentation and
the module filter are in the monorepo README.
Where the code lives
Source, tests and releases live in the theYahia/WWmcp
monorepo, alongside the shared @theyahia/mcp-core. This repository is the product's front page.
Migrating from @theyahia/1c-rest-mcp
The package was renamed in v4.0.0 — «1С» may not be used in a product's name (Infostart rules, § 2.2.11). The old package is frozen at v3.2.0.
Install:
npx -y @theyahia/aprovodkaBinary renamed:
1c-rest-mcp→aprovodkaServer name in the MCP handshake is now
aprovodka— update the key if you pinned it
Everything else is unchanged: tool names, arguments, return formats, prompts, and the ONEC_*
environment variables (the 1C_* aliases still work). No config changes beyond the command.
Trademarks
aprovodka is an independent product. It is not a product of 1C Company and is not affiliated with it. «1С» and «1С:Предприятие» are trademarks of 1C Company; this product's name contains neither. Interaction with the database happens only through the open OData interface the platform itself provides.
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
AlicenseBqualityBmaintenanceMCP server for 1C:Enterprise ERP with 35 tools: metadata inspection, document CRUD, register queries, and BSP integration. First MCP server for Russian ERP systems (300,000+ organizations). JSON-RPC 2.0 compliant BSL implementation.5130MIT- FlicenseNot gradedqualityDmaintenanceActs as a bridge between AI agents (Claude, Cursor) and 1C:Enterprise databases, enabling metadata retrieval, configuration analysis, and code generation through natural language using the MCP protocol.
- AlicenseNot gradedqualityAmaintenanceIntegrates AI agents with 1C:Enterprise databases via MCP and REST API, supporting a built-in HTTP server (no Python required) or a Python proxy mode.227GPL 3.0
- AlicenseNot gradedqualityDmaintenanceMCP server for RAG-based search over 1C Enterprise configuration documentation, enabling natural language queries to find objects like справочники, документы, and отчеты.MIT
Related MCP Connectors
ERP français avec serveur MCP natif : plus de 1 800 actions métier auto-générées via OpenAPI.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Hosted MCP server for Mini Accountant: invoices, expenses, customers, analytics, tax estimates.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/theYahia/aprovodka'
If you have feedback or need assistance with the MCP directory API, please join our Discord server