Unified 1C MCP gateway with a dashboard
onec-mcp-universal
A Docker gateway with one address instead of several MCP connections: 1C data, BSL navigation, ITS search via 1C:Napparnik, and a web dashboard
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
Why this level
- The write_bsl tool writes BSL code straight into the project
- Gives access to the data, code and event log of connected 1C infobases, worth starting with a test infobase
Install
Manual install
cp .env.example .env && ./setup.shInitial setup on Linux or Windows before starting the containers.
This is third-party code. Review the repository files before installing.
What it does
The gateway combines 47 MCP tools and one resource under a single address, http://localhost:8080/mcp, instead of several separate connections. Each AI assistant session works with its own active infobase independently through per-session routing on the Mcp-Session-Id header. The tools cover database queries, code execution, metadata, the event log, permissions, BSL navigation and full-text search, writing BSL modules with reindexing, ITS search via the 1C:Napparnik API, personal data anonymization under Russia's 152-FZ, metadata caching and query profiling. An MCPToolkit.epf processing in the 1C client connects an infobase to the gateway with one button, there is a web dashboard for status and settings, and 72 skills for Claude Code.
Who it is for. For 1C developers who want one MCP gateway for several infobases and AI assistants instead of a separate connection for each pair.
Good fit when
- You need several 1C infobases connected to different AI assistant sessions at once
- You need to write BSL code straight from the agent with automatic reindexing
- You need personal data anonymization when working with a production infobase
Not a fit when
- You need one simple integration without Docker and a web dashboard
- You are not ready to run several containers: the gateway, the toolkit proxy, platform-context, bsl-lsp
Example request
Use onec-mcp-universal to find every document with a posting error from yesterday and show the event logLimitations
Needs Docker 24+ and Docker Compose v2, on Ubuntu 22.04+ or Windows 10/11 with Docker Desktop. Some images are external (roctup/1c-mcp-toolkit-proxy, alkoleft/mcp-bsl-platform-context), and their development is not controlled by this repository's author. The BSL code-writing tool lets the agent change modules in the project, worth accounting for when setting up access.
How to disable. Stop the containers with docker compose down and remove the gateway entry from your MCP client config.
MCP
- Transport
- http
- Authentication
- not required
Security check
- The write_bsl tool writes BSL code straight into the project
- Gives access to the data, code and event log of connected 1C infobases, worth starting with a test infobase
README in short
The README describes the architecture in detail: the onec-mcp-gw Python gateway, static and per-database dynamic backends, anonymization, metadata caching, profiling, BSL search and 1C:Napparnik client modules. It gives a table of 47 tools by category, Docker requirements, Linux and Windows instructions, connecting Claude Code, Cursor and Windsurf, working with several infobases, and running the gateway remotely on a 1C server.
FAQ
Can several infobases be connected at once?
Yes, per-session routing keeps AI assistant sessions on different infobases independently.
How is personal data masked?
The enable_anonymization and disable_anonymization tools mask names, tax IDs, insurance numbers, phone numbers and emails with a stable hash mapping.
Related
A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review
Skills for real engineers by Matt Pocock
Skills For Real Engineers
Small composable skills for engineering with agents: plan grilling, TDD, bug diagnosis, code review and architecture
GitHub toolkit for spec-driven development: the specify CLI adds agent commands and skills to a project, from principles to implementation
Reference MCP servers
Model Context Protocol servers
Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything