Infaton Mcp35
@infaton
INFATON MCP Server — 51 tools for 1C:Enterprise ERP via Model Context Protocol (JSON-RPC 2.0). Digital twins, AI agents, BSL.
Overview
What is Infaton MCP35?
Infaton MCP35 is a Model Context Protocol (MCP) server for 1C:Enterprise that provides 51 tools for AI assistants to interact with a 1C database. It uses JSON-RPC 2.0 over HTTP (Basic Auth) or stdio (via a Node.js wrapper). It is built as a 1C configuration extension (INFATON_MCP.cfe) and is intended for developers and administrators who want to integrate AI agents with 1C:Enterprise systems (ERP, Accounting, Trade Management, etc.).
How to use Infaton MCP35?
Install the INFATON_MCP.cfe extension in your 1C database (via Configurator). Then configure an MCP client (e.g., Claude Desktop, Cursor) with the command npx infaton-mcp (or node index.mjs) and environment variables ONEC_URL, ONEC_USER, ONEC_PASSWORD. Alternatively, make direct HTTP POST requests to the /hs/mcp/ endpoint with JSON-RPC 2.0 payloads.
Key features of Infaton MCP35
- 51 tools across 8 groups: metadata, data reading, CRUD, code/reports, administration, integration, advanced operations, and accounting/audit/forms.
- Read, create, update, delete documents, references, and register records.
- Execute arbitrary 1C queries and code (BSL) in privileged mode.
- Accounting tools:
get_balance,get_accounting_entries,get_register_totals. - Administration: active users, event log, locks, server info, scheduled jobs.
- Batch execution of multiple tools in one request.
- Security via environment variable
ONEC_ALLOWED_TOOLSto restrict available tools. - Compatible with 1C platform 8.3.20+ and configurations like ERP 2.5, Accounting 3.0, UT 11, KA 2.
Use cases of Infaton MCP35
- AI-powered data retrieval: Ask an AI assistant to list documents, find duplicates, or show accounting entries.
- Automated document operations: Create, update, post, or unpost documents directly from a chat interface.
- Administrative monitoring: Get active users, check locks, view event log, and run scheduled jobs.
- Accounting analysis: Query balances, turnovers, and accounting entries without manual 1C report generation.
- Integration and data exchange: Execute exchange operations, import data from JSON, and get change logs.
FAQ from Infaton MCP35
What 1C platforms and configurations are supported?
1C platform 8.3.20+ (tested on 8.3.27.1989). Compatible with ERP 2.5, UPP 1.3, Accounting 3.0, UT 11, and KA 2.
What transports and authentication are supported?
HTTP with Basic Auth (username/password) and stdio (via a Node.js wrapper, index.mjs). For production, HTTPS is required to protect credentials.
What are the dangerous tools and how to restrict them?
execute_code, delete_object, run_scheduled_job, import_data, post_document, and unpost_document are considered risky. Use the ONEC_ALLOWED_TOOLS environment variable to whitelist only safe tools for read-only scenarios.
How is the MCP server installed on the 1C side?
Install the INFATON_MCP.cfe extension in the Configurator (Configuration → Extensions → Add), then update the database with F7. The HTTP service is automatically published at /hs/mcp/.
Does Infaton MCP35 require Node.js?
Node.js 18+ is only required for the stdio transport wrapper (index.mjs). Direct HTTP calls to the 1C service do not require Node.js.