aprovodka
MCP server for 1C:Enterprise databases over standard OData: catalogs, documents, registers and accounting with no configuration extension
Install
{
"mcpServers": {
"aprovodka": {
"command": "npx",
"args": ["-y", "@theyahia/aprovodka"],
"env": {
"ONEC_BASE_URL": "https://server/base/odata/standard.odata",
"ONEC_LOGIN": "user",
"ONEC_PASSWORD": "pass"
}
}
}
}Add ONEC_WRITE_MODE set to preview or approval to enable the write gate.
This is third-party code. Review the repository files before installing.
What it does
The server connects the agent to a live 1C database through the OData 3.0 interface the platform publishes itself, so nothing is added to the configuration. 34 tools cover catalogs, documents, all register kinds, the accounting register with its balance and turnover virtual tables, constants, batch operations, change tracking and metadata discovery. The agent can create and edit documents, post and unpost them and set deletion marks. Writes can go through a safety gate in preview or approval mode, and reversible operations return a rollback token. Presets for Enterprise Accounting 3.0, Trade Management 11, Payroll 3.1 and ERP 2 describe key entities and common traps.
Who it is for. For 1C developers, accountants and finance analysts who need 1C database data in a conversation with an agent.
Good fit when
- You need account balances and turnovers without writing a report
- You need to find documents and catalog records by condition
- You need to explore an unfamiliar configuration through metadata
Not a fit when
- OData is not published for the database and cannot be
- The agent must not change accounting data and there is no read-only user
Example request
Show account 41 balances at the end of last month broken down by warehouseLimitations
Requires the standard OData interface published for the database and a 1C user with suitable rights. The write safety gate is off by default (ONEC_WRITE_MODE=off) and must be enabled explicitly. Login and password are passed in environment variables. Source code and full docs live in the WWmcp monorepo; this repo is the product page. Not affiliated with 1C Company. The author also offers paid setup for a specific database.
How to disable. Delete the aprovodka block from your MCP client config and disable the 1C user the server used.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| ONEC_BASE_URL required | Database standard OData URL ending in standard.odata |
| ONEC_LOGIN required | 1C user name |
| ONEC_PASSWORD required, secret | 1C user password |
| ONEC_WRITE_MODE | Write gate mode: off, preview or approval, off by default |
Security check
- Creates, edits and posts documents in a production 1C database
- The write gate is off by default
- The 1C user login and password sit in the config
README in short
The README explains that the server uses OData 3.0 with no extensions and lists coverage: catalogs, documents, registers, accounting, batches and change tracking. It gives an MCP config with npx and ONEC_* variables and describes write safety modes and standard configuration presets. A section covers migrating from the old 1c-rest-mcp package, plus a trademark note. A large part of the README also promotes the author's paid data reconciliation service. MIT licensed.
FAQ
Do I need a configuration extension?
No, the server works only through the standard OData interface the platform publishes.
How do I protect the database from accidental changes?
Set ONEC_WRITE_MODE=preview or approval. The safest option is a read-only 1C user for the server.
How does it relate to @theyahia/1c-rest-mcp?
It is the same project renamed in v4.0.0. Tools and ONEC_* variables are unchanged; only the command and server name changed.
Related
Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data
The official CCXT MCP server and skills: market data, balances and opt-in trading across crypto exchanges and prediction markets
Skill plugins for analyzing stocks, earnings, options and startups, plus readers for social feeds and market data
Skills and an MCP server for options traders: quotes, technical analysis, Greeks, spreads, scanners and Interactive Brokers portfolio