INFATON MCP35
OfficialINFATON MCP35 is an MCP server exposing 1С:Предприятие tools (51 in this schema, 94 in v6.2.8) that let AI assistants inspect metadata, read/write data, run queries and BSL code, and administer the infobase.
Explore metadata — get the metadata tree, object structure, attributes, tabular sections, enum values, register dimensions, document movements, and search objects by name/synonym.
Read data — run arbitrary 1С queries, fetch objects by GUID/reference, list catalog items and documents, find by code or name, and read register records and document lists with filters.
Modify data (CRUD) — create, update, copy and mark-for-deletion objects, set individual attributes, update tabular sections, post/unpost documents, and write register records directly.
Execute code and reports — evaluate 1С expressions, run arbitrary BSL code in privileged mode, read module text, and generate simple reports.
Accounting & ERP analysis — get balances/turnovers of accounting and accumulation registers, accounting entries (Дт/Кт), related documents chains, and validate document fill-in without posting.
Administer & diagnose — list active users/sessions, read the event log, inspect locks, get server/config info, check references before deletion, and run scheduled jobs.
Integrate & exchange — run data exchanges, read exchange logs, and bulk-import JSON data.
Batch & sync — execute batches of operations (sequential, stop-on-error, transactional), poll event changes (CDC), and fetch objects changed since a timestamp.
Forms, rights & printing — inspect managed form structure, check current user's rights on an object, find duplicates in catalogs, generate print forms, and list configuration extensions (CFE).
Safety controls — supports
ONEC_ALLOWED_TOOLSallow-listing, read-only configurations, and flags dangerous tools likeexecute_code,delete_object,import_data, andrun_scheduled_job.
INFATON MCP Server for 1C:Enterprise
Model Context Protocol (MCP) — a server on the 1C:Enterprise side that provides 35 tools for AI assistants to interact with the 1C database.
Protocol: JSON-RPC 2.0 (MCP specification)
📋 Repository Contents
File | Description |
| MCP HTTP service module — core code for the 35 tools |
| 1C configuration extension (ready-to-use binary package) |
| Instructions for building and installing the |
Related MCP server: onec-meta-mcp
🛠 35 Tools
Metadata (8)
# | Tool | Description |
1 |
| Configuration metadata object tree |
2 |
| Full object structure (attributes, tabular sections, modules) |
3 |
| List of object attributes |
4 |
| Object tabular sections |
5 |
| Enumeration values |
6 |
| Register dimensions, resources, and attributes |
7 |
| Document register movements |
8 |
| Search metadata (by name/synonym) |
Data (7)
# | Tool | Description |
9 |
| Execute an arbitrary 1C query |
10 |
| Get object by reference/GUID |
11 |
| List of catalog/document items with filters |
12 |
| Search by code |
13 |
| Search by name |
14 |
| Register records with filters |
15 |
| List of documents with date/number filters |
CRUD (7)
# | Tool | Description |
16 |
| Create a new object (catalog/document) |
17 |
| Modify object attributes |
18 |
| Mark for deletion |
19 |
| Post a document |
20 |
| Unpost a document |
21 |
| Copy an object |
22 |
| Modify a single attribute |
Code and Calculations (3)
# | Tool | Description |
23 |
| Execute arbitrary 1C code |
24 |
| Evaluate an expression |
25 |
| Get object module text |
Reports (1)
# | Tool | Description |
26 |
| Generate a report (DCS) |
Administration (4)
# | Tool | Description |
27 |
| List of active users |
28 |
| Event log |
29 |
| Data locks |
30 |
| 1C server information |
Checks and Control (2)
# | Tool | Description |
31 |
| Check referential integrity |
32 |
| Run a scheduled job |
Data Exchange (3)
# | Tool | Description |
33 |
| Execute data exchange |
34 |
| Exchange log |
35 |
| Import data from JSON |
🚀 Quick Start
1. Install the Extension
Open the 1C database Configurator
Configuration → Configuration Extensions → Add
Select the
INFATON_MCP.cfefileUpdate the database configuration (F7)
2. Verification
curl -u 'Логин:Пароль' -X POST \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"initialize","id":1}' \
https://ваш-сервер/база/hs/mcp/Expected response:
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"protocolVersion": "2024-11-05",
"capabilities": { "tools": {} },
"serverInfo": { "name": "infaton-1c-mcp", "version": "1.0.0" }
}
}3. Call a Tool
curl -u 'Логин:Пароль' -X POST \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"tools/call","id":2,"params":{"name":"get_metadata_tree","arguments":{}}}' \
https://ваш-сервер/база/hs/mcp/📐 Architecture
┌─────────────────────────┐
│ AI Assistant │ Claude / GPT / Qwen / ...
│ (MCP Client) │
└────────┬────────────────┘
│ JSON-RPC 2.0
▼
┌─────────────────────────┐
│ HTTP-сервис /hs/mcp/ │ Расширение INFATON_MCP.cfe
│ Module.bsl │ 35 инструментов
│ (MCP Server) │
└────────┬────────────────┘
│ Встроенный язык 1С
▼
┌─────────────────────────┐
│ База 1С:Предприятие │ ERP / УПП / Бухгалтерия / ...
│ Данные, метаданные │
└─────────────────────────┘📝 Compatibility
1C Platform: 8.3.20+ (tested on 8.3.27)
Configurations: ERP 2.5, UPP 1.3, Accounting 3.0, UT 11, KA 2
MCP Protocol: 2024-11-05
Transport: HTTP (Basic Auth)
📄 License
© 2024-2026 INFATON (infaton.ru)
For detailed instructions on building .cfe — see HOW_TO_BUILD_CFE.md
Available Tools
51 toolscheck_referencesA
Найти все ссылки на объект в базе данных. Показывает где используется данный объект. Необходимо перед удалением.
Inputs: guid (required), full_name (required).
copy_objectB
Создать копию объекта. Копирует все реквизиты и табличные части. Возвращает UUID нового объекта.
Inputs: guid (required), full_name (required).
create_objectB
Создать новый элемент справочника или документ. Для ссылочных реквизитов передавай UUID со суффиксом _guid.
Inputs: full_name (required), attributes (required), tabular_sections.
delete_objectA
Установить/снять пометку удаления объекта. Физическое удаление НЕ выполняется.
Inputs: guid (required), full_name (required), unmark.
evaluate_expressionB
Вычислить выражение на языке 1С и вернуть результат. Для простых вычислений и проверок.
Inputs: expression (required).
exchange_executeB
Выполнить обмен данными по указанному плану обмена и узлу.
Inputs: exchange_plan (required), node.
execute_batchA
Выполнить пакет операций за один HTTP-вызов. Поддерживает любые инструменты MCP. Режимы: последовательный, stop-on-error, транзакционный (атомарный). Макс. 50 операций.
Inputs: operations (required), stop_on_error, transactional.
execute_codeA
Выполнить произвольный код на языке 1С. МОЩНЫЙ ИНСТРУМЕНТ — используй только когда другие инструменты не подходят. Код выполняется в привилегированном режиме на сервере 1С. Результат должен быть в переменной Результат (строка). ВАЖНО: не выполняй операции с файловой системой, внешними соединениями или завершением сеансов без явного подтверждения пользователя.
Inputs: code (required).
execute_queryA
Выполнить произвольный запрос на языке запросов 1С. Самый мощный инструмент чтения данных. Поддерживает ВЫБРАТЬ, соединения, группировки, параметры виртуальных таблиц.
Inputs: query (required), max_results.
fill_on_basisA
Создать новый документ/справочник на основании существующего объекта. Вызывает типовой механизм ЗаполнитьНаОсновании(). Ключевой для цепочек: ЗаказКлиента → Реализация → СчётФактура.
Inputs: base_guid (required), base_type (required), target_type (required), attributes.
find_by_codeB
Найти объект по коду. Возвращает данные найденного элемента или сообщение что не найден.
Inputs: code (required), full_name (required).
find_by_nameB
Найти объект по наименованию. Возвращает данные найденного элемента.
Inputs: name (required), full_name (required).
find_duplicatesA
Найти потенциальные дубли в справочнике по указанным реквизитам. Точное и нечёткое сравнение. Возвращает пары с процентом совпадения.
Inputs: full_name (required), attributes (required), threshold, max_results.
generate_reportC
Сформировать простой отчёт по произвольному запросу. Возвращает табличные данные.
Inputs: query (required), title.
get_accounting_entriesB
Получить бухгалтерские проводки (движения) документа. Возвращает: счёт Дт, счёт Кт, сумма, количество, субконто, содержание.
Inputs: document_ref (required), register_name.
get_active_usersA
Получить список активных сеансов пользователей в информационной базе.
Inputs: no named parameters.
get_balanceC
Получить остатки и/или обороты регистра бухгалтерии. Работает с любым планом счетов. Поддерживает фильтрацию по счёту, периоду, организации и субконто.
Inputs: account_code (required), period_to, dimensions, period_from, +2 more.
get_changes_sinceA
Получить список объектов, изменённых после указанной метки. Change Data Capture для синхронизации двойников. Возвращает GUID, тип изменения, время, watermark.
Inputs: since (required), full_name (required), max_results, include_data.
get_configuration_extensionsB
Получить список расширений конфигурации (CFE). Возвращает: имя, синоним, версия, назначение, активность, безопасный режим.
Inputs: active_only.
get_document_listC
Получить список документов заданного типа с фильтрацией по периоду и статусу проведения.
Inputs: full_name (required), limit, date_to, date_from, +1 more.
get_document_movementsB
Получить список регистров, по которым документ делает движения (проводки). Ключевой инструмент для анализа учёта.
Inputs: full_name (required).
get_enum_valuesA
Получить все значения перечисления с именами и синонимами.
Inputs: full_name (required).
get_event_logB
Получить записи журнала регистрации с фильтрацией по периоду, событию и пользователю. Ключевой инструмент диагностики.
Inputs: limit, period_to, period_from, user_filter, +1 more.
get_exchange_logC
Получить журнал обменов данными: дата, план обмена, направление, результат.
Inputs: period_to, period_from, exchange_plan.
get_form_structureB
Получить структуру управляемой формы: реквизиты, команды, элементы. Полезно для понимания пользовательского интерфейса объекта.
Inputs: full_name (required), form_name.
get_listB
Получить список объектов заданного типа с пагинацией и фильтром. Возвращает код, наименование и UUID.
Inputs: full_name (required), limit, filter, offset.
get_locksA
Получить текущие блокировки данных в информационной базе. Помогает диагностировать зависания и конфликты.
Inputs: no named parameters.
get_metadata_treeA
Получить дерево метаданных конфигурации 1С. Возвращает список всех объектов по типам: справочники, документы, регистры, перечисления и т.д. Используй для обзора структуры базы.
Inputs: no named parameters.
get_module_textA
Получить исходный текст модуля объекта конфигурации. Работает только если расширение имеет доступ к основной конфигурации.
Inputs: full_name (required), module_type.
get_object_attributesA
Получить список реквизитов объекта с типами, синонимами и длиной. Используй для понимания полей при чтении/записи данных.
Inputs: full_name (required).
get_object_by_refA
Получить полные данные объекта по его типу и UUID: все реквизиты, табличные части, проведён ли, пометка удаления.
Inputs: guid (required), full_name (required).
get_object_metadataA
Получить подробные метаданные объекта 1С: реквизиты, табличные части, формы, макеты, движения. Используй для анализа структуры конкретного объекта.
Inputs: full_name (required).
get_object_tabular_sectionsA
Получить табличные части объекта и их реквизиты. Используй для анализа строковых данных документов и справочников.
Inputs: full_name (required).
get_print_formA
Получить печатную форму документа через УправлениеПечатью. Без print_form_id — список доступных форм. С ним — генерация формы.
Inputs: document_ref (required), format, print_form_id.
get_register_dimensionsB
Получить измерения, ресурсы и реквизиты регистра. Используй для понимания структуры регистров.
Inputs: full_name (required).
get_register_recordsA
Получить записи регистра с фильтрацией по измерениям и периоду. Работает с регистрами сведений, накопления и бухгалтерии.
Inputs: full_name (required), limit, filter, period_to, +1 more.
get_register_totalsA
Получить итоги регистра накопления (остатки, обороты или и то и другое). Поддерживает отбор по измерениям и выбор ресурсов.
Inputs: full_name (required), period_to, resources, dimensions, +2 more.
get_rightsA
Получить права доступа текущего пользователя к объекту метаданных. Возвращает: чтение, добавление, изменение, удаление, проведение и др.
Inputs: full_name (required).
get_server_infoA
Получить информацию о сервере: версия платформы, режим, имя базы, текущая дата/время.
Inputs: no named parameters.
import_dataA
Массовый импорт данных из JSON-массива. Создаёт или обновляет объекты.
Inputs: data (required), full_name (required), mode.
post_documentA
Провести документ. Формирует движения по регистрам.
Inputs: guid (required), full_name (required).
run_scheduled_jobC
Запустить регламентное задание по имени. Выполняется немедленно в текущем сеансе.
Inputs: job_name (required).
search_metadataA
Поиск объектов метаданных по подстроке в имени или синониме. Используй когда не знаешь точное имя объекта.
Inputs: query (required), type_filter.
set_attributeB
Быстро изменить один реквизит объекта. Удобно для массовых точечных правок.
Inputs: guid (required), value (required), full_name (required), attribute_name (required).
subscribe_eventsA
Получить события (изменения) из журнала регистрации 1С с момента указанной метки. Polling-based CDC для синхронизации двойников. Возвращает watermark для следующего запроса.
Inputs: since, full_name, max_events, event_types.
unpost_documentA
Отменить проведение документа. Удаляет движения по регистрам.
Inputs: guid (required), full_name (required).
update_objectB
Обновить реквизиты существующего объекта. Передавай только изменяемые поля.
Inputs: guid (required), full_name (required), attributes (required).
update_tabular_sectionA
Обновить табличную часть существующего объекта (документа/справочника). Три режима: replace (полная замена), append (добавление), update_by_index (по номеру строки).
Inputs: guid (required), rows (required), full_name (required), tabular_section (required), +1 more.
validate_documentA
Проверить корректность заполнения документа без проведения. Вызывает стандартную процедуру проверки. Возвращает список ошибок или подтверждение.
Inputs: document_ref (required).
write_register_recordsC
Записать данные в регистр сведений напрямую. Поддерживает периодические и непериодические регистры. Для контактной информации, курсов валют, цен, штрихкодов.
Inputs: records (required), full_name (required), period, replace.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 51 tools
Most tools have distinct purposes, but several clusters overlap heavily: metadata exploration (get_metadata_tree, get_object_metadata, get_object_attributes, get_object_tabular_sections, get_register_dimensions, get_form_structure, search_metadata), object lookup (find_by_name, find_by_code, get_object_by_ref, get_list, get_document_list), and register reads (get_register_records, get_register_totals, get_balance, get_accounting_entries). Descriptions help disambiguate but an agent could easily misselect within these groups.
Nearly all tools follow a consistent snake_case verb_noun pattern (get_, find_, create_, update_, delete_, run_, execute_). Minor deviations like exchange_execute and a few bare action names are readable but slightly off-pattern.
51 tools is a severe overload for a single server, exceeding the 50-tool threshold for extreme mismatch. The surface attempts to cover metadata, data access, diagnostics, accounting, exchange, CDC, and batch execution all at once, making selection unwieldy.
Coverage is broad and strong: full CRUD (create/update/delete/copy), posting lifecycle, metadata introspection, register read/write, accounting balances/entries, diagnostics, CDC/sync, and batch execution. A few gaps exist (e.g. no explicit transaction rollback control or attachment handling), but core lifecycle is well covered.
Maintenance
Related MCP Connectors
Unified MCP server for 70+ eCommerce platforms: products, orders, customers, and more.
MCP server that delivers up-to-date Bitrix24 REST API documentation.
MCP server for Russian books search, details, and recommendation candidates.
Headless API-first double-entry accounting & bookkeeping engine. 84 MCP tools over HTTP.
Related MCP Servers
- FlicenseNot gradedqualityAmaintenanceMCP server that validates AI-generated 1C:Enterprise (BSL) code against the real platform API. Catches unknown enum values, wrong argument counts, and missing type members by parsing the platform syntax-helper (shcntx_ru.hbk) — independent Rust implementation with built-in expression validator.33-
- FlicenseNot gradedqualityBmaintenanceMCP server for searching and analyzing 1C enterprise metadata and BSL code using a SQLite backend. Enables querying configuration structure, code routines, and performing compliance checks via natural language.-
- AlicenseNot gradedqualityDmaintenanceMCP server for RAG-based search over 1C Enterprise configuration documentation, enabling natural language queries to find objects like справочники, документы, and отчеты.MIT
- AlicenseNot gradedqualityBmaintenanceMCP server that provides read-only access to 1C:Enterprise configuration metadata extracted into SQLite, enabling LLMs to inspect objects, modules, and validate 1C queries.MIT