Skip to main content
Glama
INFATON MCP35

INFATON MCP35

Official
by infaton

INFATON MCP Server for 1C:Enterprise

MCP35 MCP server

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

Module.bsl

MCP HTTP service module — core code for the 35 tools

INFATON_MCP.cfe

1C configuration extension (ready-to-use binary package)

HOW_TO_BUILD_CFE.md

Instructions for building and installing the .cfe


Related MCP server: onec-meta-mcp

🛠 35 Tools

Metadata (8)

#

Tool

Description

1

get_metadata_tree

Configuration metadata object tree

2

get_object_metadata

Full object structure (attributes, tabular sections, modules)

3

get_object_attributes

List of object attributes

4

get_object_tabular_sections

Object tabular sections

5

get_enum_values

Enumeration values

6

get_register_dimensions

Register dimensions, resources, and attributes

7

get_document_movements

Document register movements

8

search_metadata

Search metadata (by name/synonym)

Data (7)

#

Tool

Description

9

execute_query

Execute an arbitrary 1C query

10

get_object_by_ref

Get object by reference/GUID

11

get_list

List of catalog/document items with filters

12

find_by_code

Search by code

13

find_by_name

Search by name

14

get_register_records

Register records with filters

15

get_document_list

List of documents with date/number filters

CRUD (7)

#

Tool

Description

16

create_object

Create a new object (catalog/document)

17

update_object

Modify object attributes

18

delete_object

Mark for deletion

19

post_document

Post a document

20

unpost_document

Unpost a document

21

copy_object

Copy an object

22

set_attribute

Modify a single attribute

Code and Calculations (3)

#

Tool

Description

23

execute_code

Execute arbitrary 1C code

24

evaluate_expression

Evaluate an expression

25

get_module_text

Get object module text

Reports (1)

#

Tool

Description

26

generate_report

Generate a report (DCS)

Administration (4)

#

Tool

Description

27

get_active_users

List of active users

28

get_event_log

Event log

29

get_locks

Data locks

30

get_server_info

1C server information

Checks and Control (2)

#

Tool

Description

31

check_references

Check referential integrity

32

run_scheduled_job

Run a scheduled job

Data Exchange (3)

#

Tool

Description

33

exchange_execute

Execute data exchange

34

get_exchange_log

Exchange log

35

import_data

Import data from JSON


🚀 Quick Start

1. Install the Extension

  1. Open the 1C database Configurator

  2. Configuration → Configuration Extensions → Add

  3. Select the INFATON_MCP.cfe file

  4. Update 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 tools
check_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

    B3.2/5.0

    Scored across 51 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      A
      maintenance
      MCP 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
      -
    • F
      license
      Not graded
      quality
      B
      maintenance
      MCP 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.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for RAG-based search over 1C Enterprise configuration documentation, enabling natural language queries to find objects like справочники, документы, and отчеты.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP 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