Labsco
MCP SERVER

Infaton 1c MCP

by infaton

Reach a 1C:Enterprise database from an AI assistant — metadata, queries, documents and registers, accounting balances, rights audit and SKD reports.

ERP & Vertical Business SystemsVerified
Summary
Set `ONEC_ALLOWED_TOOLS` before you connect it to a live database.

This reaches into a production ERP, and several tools change it: `execute_code` runs arbitrary BSL in privileged mode, `delete_object` marks records for deletion, `import_data` creates and modifies in bulk, `run_scheduled_job` starts jobs, and posting tools alter register movements. The README ships a read-only allow list for exactly this reason — start from it, add what a given scenario needs, and give the server its own 1C user with minimal rights rather than an administrator's.

What it is

An MCP server that runs inside 1C:Enterprise itself. A configuration extension publishes an HTTP service in the database, and a Node.js wrapper bridges stdio clients to it over Basic Auth. Version 6.0.2 exposes 91 tools; the documented base catalogue is 51 of them, grouped from metadata and querying through CRUD, administration and accounting.

What you get
  • The configuration's metadata read directly: the object tree, an object's full structure, its attributes and tabular sections, enum values, register dimensions, a document's register movements, and metadata search by name or synonym — `get_metadata_tree`, `get_object_metadata`, `get_object_attributes`, `get_object_tabular_sections`, `get_enum_values`, `get_register_dimensions`, `get_document_movements`, `search_metadata`
  • Data read with arbitrary 1C queries or by reference, code, name and filter, including register records and filtered document lists — `execute_query`, `get_object_by_ref`, `get_list`, `find_by_code`, `find_by_name`, `get_register_records`, `get_document_list`
  • Objects created, updated, copied, marked for deletion, posted and unposted, down to a single attribute — `create_object`, `update_object`, `copy_object`, `delete_object`, `post_document`, `unpost_document`, `set_attribute`
  • Accounting answers rather than raw rows: balances and turnover on any chart of accounts, accumulation-register totals, a document's debit/credit entries, and the chain of documents entered on the basis of one another — `get_balance`, `get_register_totals`, `get_accounting_entries`, `get_related_documents`
  • Operational checks before you commit: a document validated without posting, duplicates found in a catalogue by attribute, a managed form's structure, and the current user's rights on an object — `validate_document`, `find_duplicates`, `get_form_structure`, `get_rights`
  • Administration: active users and sessions, the event log with filters, current data locks, platform and configuration info, referential integrity checks, scheduled jobs and installed extensions — `get_active_users`, `get_event_log`, `get_locks`, `get_server_info`, `check_references`, `run_scheduled_job`, `get_configuration_extensions`
  • Integration and bulk work: data exchange runs and their log, JSON import, batch execution of several tools in one call, and changes since a timestamp for change capture — `exchange_execute`, `get_exchange_log`, `import_data`, `execute_batch`, `get_changes_since`
  • Reports and code: SKD reports generated, print forms produced through the printing subsystem, module text read, and expressions evaluated — `generate_report`, `get_print_form`, `get_module_text`, `evaluate_expression`
Requirements

A 1C:Enterprise database you can install a configuration extension into: load `INFATON_MCP.cfe` in the Configurator and update the database, which publishes the HTTP service. The client then needs `ONEC_URL` pointing at that service plus `ONEC_USER` and `ONEC_PASSWORD`. The package.json names it `infaton-mcp` at 6.0.2, which npm does not have; from a clone the wrapper runs from `index.mjs`, and needs Node.js 18+. Platform 8.3.20+ , tested on 8.3.27.1989, against ERP 2.5, УПП 1.3, Бухгалтерия 3.0, УТ 11 and КА 2. Basic Auth sends the credentials base64-encoded, so publish the service over HTTPS.