1c-rest-mcp server
MCP server for 1C Enterprise — ERP catalogs, documents via REST API (Russia)
12 stars
Reviews
Write oneNobody has reviewed 1c-rest-mcp yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
1c-rest-mcp tools (9, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
create_documentwrite actionСоздание нового документа в 1С через OData POST.
get_catalogsПолучение данных из справочников 1С через OData 3.0. Поддерживает фильтрацию, сортировку, пагинацию.
get_document_by_numberНайти документ в 1С по номеру. Удобная обёртка над OData $filter.
get_documentsПолучение документов 1С через OData 3.0. Фильтрация по дате, типу, произвольным полям.
get_registerПолучение данных из регистров 1С (информационных и накопления) через OData 3.0.
get_reportПолучение отчёта из 1С по произвольному URL HTTP-сервиса (/hs/...).
list_entitiesПолучить список всех доступных сущностей базы 1С: справочники (Catalog_*),
odata_queryПроизвольный OData 3.0 запрос к любой сущности 1С. Поддерживает $filter, $select, $expand, $orderby, $top, $skip, $inlinecount.
update_documentwrite actionОбновление существующего документа в 1С через OData PATCH.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan28 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 22 days ago15/15
- Maintainer identityregistry namespace matches repository owner6/10
Install 1c-rest-mcp in Claude Code, Cursor or VS Code
Runs npx -y @theyahia/1c-rest-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add 1c-rest-mcp -- npx -y @theyahia/1c-rest-mcp
What the publisher says
From the 1c-rest-mcp repository's README, as published. We do not edit it. Read it on GitHub
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 не падает, она молча отдаёт неверное число. Проверить это можно только на конкретной конфигурации.
Что входит, за одну информационную базу:
штатного отчёта 1С, строка в строку.
- файл схемы под вашу конфигурацию — какие сущности есть, как они называются, что с чем связано;
- список ловушек именно вашей базы — где запрос вернёт правдоподобное, но неверное;
- отчёт сверки по 10 согласованным вопросам — ответ агента стоит рядом с цифрой из вашего же
Срок — 5 рабочих дней. Приёмка — по совпадению цифр, критерий согласуем до начала. Предоплата 100%, чек НПД. Условия целиком — договор-оферта.
📧 leadmanager81@yandex.ru · 💬 @metarebalancer — ответим в рабочие дни, 10:00–19:00 МСК. Напишите, какая у вас конфигурация и опубликован ли OData.
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:
require an extension in the database; the two that don't, don't touch live data.
- No BSL, nothing installed into the configuration. Six of the eight comparable servers
point in the client, so no tool can bypass it. Reversible operations return a rollback token; irreversible ones are labelled with the reason.
- 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
Russian descriptions, ready query examples, and the traps people hit.
- Curated configuration presets for БП 3.0, УТ 11, ЗУП 3.1 and ERP 2 — key entities with
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 ONECWRITEMODE 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
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
1c-rest-mcp: common questions
- Is 1c-rest-mcp server safe?
- Yes, by our scan: it is graded A (89/100). Read the 1c-rest-mcp safety report
- How do I install 1c-rest-mcp?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does 1c-rest-mcp need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is 1c-rest-mcp maintained?
- The last commit was 23 days ago (2026-09-05). The latest release is v1.2.1.