1C MCP
Инструмент для создания MCP-серверов в 1С:Предприятие путем разработки расширения конфигурации. Позволяет интегрировать данные и функциональность 1С с AI-ассистентами (Claude, Cursor и т.д.). Включает Python-прокси и пример расширения 1С с готовыми и
What is 1C MCP?
1C MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to инструмент для создания mcp-серверов в 1с:предприятие путем разработки расширения конфигурации. позволяет интегрировать данные и функциональность 1с с ai-ассистентами (claude, cursor и т.д.). включает...
Инструмент для создания MCP-серверов в 1С:Предприятие путем разработки расширения конфигурации. Позволяет интегрировать данные и функциональность 1С с AI-ассистентами (Claude, Cursor и т.д.). Включает Python-прокси и пример расширения 1С с готовыми и
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Инструмент для создания MCP-серверов в 1С:Предприятие путем
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx 1c-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use 1C MCP
1C MCP is a framework that lets developers create MCP servers inside 1C:Enterprise by building a configuration extension, then exposing those tools to AI assistants like Claude or Cursor via a Python proxy. It bridges the 1C ecosystem — widely used in Russian-speaking markets for ERP and accounting — with modern AI tooling, enabling AI agents to query business data, invoke 1C logic, and return structured results. The repository ships a ready-to-use extension file (.cfe), a Docker-based Python proxy, and example tool definitions so developers can get started quickly.
Prerequisites
- 1C:Enterprise 8.3 platform installed with a configured infobase
- Python 3.9+ and Docker (for the proxy server)
- Access to configure and publish HTTP services in 1C
- An MCP-compatible client such as Claude Desktop or Cursor
Install the 1C extension
Open your 1C infobase in the configurator. Attach the pre-built extension file from the repository at build/MCP_Сервер.cfe. This extension adds the MCP handler subsystem to your configuration.
Publish the HTTP service in 1C
In the 1C configurator, publish the HTTP service that the extension creates onto your 1C web server. Note the resulting service URL — this becomes your MCP_ONEC_URL.
Copy and configure the proxy environment file
Copy the Docker environment template and fill in your 1C HTTP service URL and authentication credentials.
cp .env.docker.example .env
# Edit .env:
# MCP_ONEC_URL=http://host.docker.internal/mybase/hs/mcp
# (plus 1C login and password)Start the Python proxy via Docker
Launch the Docker Compose stack. The proxy listens for MCP calls from AI clients and forwards them to the 1C HTTP service.
docker-compose up -dConfigure your MCP client
Add the 1C MCP proxy to your MCP client configuration. The proxy exposes an SSE or stdio transport that Claude Desktop or Cursor can connect to.
{
"mcpServers": {
"1c-mcp": {
"command": "docker",
"args": ["exec", "-i", "1c_mcp_proxy", "python", "-m", "mcp_proxy"],
"env": {
"MCP_ONEC_URL": "http://host.docker.internal/mybase/hs/mcp"
}
}
}
}Define custom tools in 1C
To expose your own 1C data, add a handler to the mcp_КонтейнерыИнструментов subsystem in the extension. Each tool requires two export methods in its manager module: one that describes the tool schema and one that executes the tool logic.
1C MCP Examples
Client configuration
Connect Claude Desktop to the 1C MCP Python proxy running in Docker, pointing at your 1C infobase HTTP service.
{
"mcpServers": {
"1c-mcp": {
"url": "http://localhost:8000/sse"
}
}
}Prompts to try
Once the proxy is running and connected, use these prompts to interact with 1C data through your AI assistant.
- "List all open sales orders from this month in our 1C database"
- "What is the current stock level for product SKU-10045?"
- "Show me the metadata objects available in the 1C configuration"
- "Retrieve the balance sheet for department 'Warehouse 3' as of today"
- "Create a draft sales order for customer 'Romashka LLC' with 10 units of item X"Troubleshooting 1C MCP
Docker proxy cannot reach the 1C HTTP service
If 1C runs on the same host as Docker, use 'host.docker.internal' instead of 'localhost' in MCP_ONEC_URL. On Linux, add '--add-host=host.docker.internal:host-gateway' to the Docker Compose service definition.
1C returns 401 Unauthorized when the proxy calls the HTTP service
Verify that the login and password in your .env file match a 1C user with rights to call HTTP services. Also ensure the HTTP service is published and the infobase is started in server mode.
MCP client shows no tools from the 1C server
Check that the extension is active in the 1C infobase and the HTTP service is published correctly. Use a browser to GET the service URL directly and confirm it returns a JSON response before troubleshooting the MCP layer.
Frequently Asked Questions about 1C MCP
What is 1C MCP?
1C MCP is a Model Context Protocol (MCP) server that инструмент для создания mcp-серверов в 1с:предприятие путем разработки расширения конфигурации. позволяет интегрировать данные и функциональность 1с с ai-ассистентами (claude, cursor и т.д.). включает python-прокси и пример расширения 1с с готовыми и It connects AI assistants to external tools and data sources through a standardized interface.
How do I install 1C MCP?
Follow the installation instructions on the 1C MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with 1C MCP?
1C MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is 1C MCP free to use?
Yes, 1C MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
1C MCP Alternatives — Similar Business Applications Servers
Looking for alternatives to 1C MCP? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台，「低代码 + 零代码」双模式驱动：低代码一键生成前后端代码，零代码 5 分钟搭建系统，AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等，兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式，消除 Java 项目 80% 的重复工作，提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up 1C MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use 1C MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.