Skip to main content
Glama
infaton

INFATON MCP35

Official
by infaton

INFATON MCP Server для 1С:Предприятие

MCP35 MCP server

Model Context Protocol (MCP) — сервер на стороне 1С:Предприятие, предоставляющий 51 инструмент для взаимодействия AI-ассистентов с базой данных 1С.

Протокол: JSON-RPC 2.0 (спецификация MCP)


📋 Состав репозитория

Файл

Описание

Module.bsl

Модуль HTTP-сервиса MCP — основной код, 51 инструмент (4 263 строки)

index.mjs

Node.js stdio-обёртка для MCP-клиентов (Claude Desktop, Cursor и др.)

package.json

npm-манифест для публикации и запуска через npx

glama.json

Манифест для каталога Glama.ai

INFATON_MCP.cfe

Расширение конфигурации 1С v2.1.0 (бинарный пакет)

HOW_TO_BUILD_CFE.md

Инструкция по сборке и установке .cfe

EXAMPLES.md

Примеры агентских сценариев (7 кейсов)

CHANGELOG.md

История версий


Related MCP server: code-index-mcp

🆕 Что нового в v2.1.0

Исправления (9 патчей)

#

Инструмент

Баг

Исправление

P1

get_list

Отсутствие ПЕРВЫЕ N — возвращал ВСЕ записи

Добавлен ПЕРВЫЕ с параметром limit (по умолчанию 100)

P2

get_document_list

Фильтр по дате — Дата >= без параметра

Добавлен Запрос.УстановитьПараметр для дат

P3

get_object_by_ref

Пустая ссылка → невнятная ошибка платформы

Добавлена проверка Если НЕ ЗначениеЗаполнено(Ссылка)

P4

get_active_users / get_locks

Прямой обход коллекции сеансов → ошибка на сервере

Переход на МассивСеансов = ПолучитьСеансыИнформационнойБазы()

P5

get_event_log

Дата передавалась строкой + поле «Метаданные» вместо представления

ПреобразоватьДату() + .МетаданныеПредставление

P6

ПреобразоватьДату

Не обрабатывал 2026-05-14, 14.05.2026, 20260514

Полная перезапись: ISO 8601 + 3 формата

P7

fill_on_basis

Объект.Заполнить() → верный метод ЗаполнитьНаОсновании()

Исправлен вызов метода

P8

execute_batch

Вложенный execute_batch → бесконечная рекурсия

Добавлен guard-флаг _batch_depth

P9

Версия оставалась 2.0.0

Обновлена до 2.1.0

Новые инструменты (10 штук, группа З)

#

Инструмент

Назначение

42

get_balance

Остатки и обороты регистра бухгалтерии (любой план счетов)

43

get_register_totals

Итоги регистров накопления (остатки/обороты)

44

get_accounting_entries

Бухгалтерские проводки документа (Дт, Кт, сумма)

45

get_related_documents

Цепочка связанных документов (ввод на основании)

46

validate_document

Проверка заполнения документа без проведения

47

get_form_structure

Структура управляемой формы (реквизиты, команды)

48

get_rights

Права доступа текущего пользователя к объекту

49

find_duplicates

Поиск дублей в справочниках по реквизитам

50

get_print_form

Печатные формы через подсистему УправлениеПечатью

51

get_configuration_extensions

Список расширений конфигурации (CFE)


🛠 Полный каталог: 51 инструмент

Группа А — Метаданные (8)

#

Инструмент

Описание

1

get_metadata_tree

Дерево объектов метаданных конфигурации

2

get_object_metadata

Полная структура объекта (реквизиты, ТЧ, модули)

3

get_object_attributes

Список реквизитов объекта

4

get_object_tabular_sections

Табличные части объекта

5

get_enum_values

Значения перечисления

6

get_register_dimensions

Измерения, ресурсы и реквизиты регистра

7

get_document_movements

Движения документа по регистрам

8

search_metadata

Поиск по метаданным (по имени/синониму)

Группа Б — Чтение данных (7)

#

Инструмент

Описание

9

execute_query

Выполнение произвольного запроса 1С

10

get_object_by_ref

Получение объекта по ссылке/GUID

11

get_list

Список элементов справочника/документа с фильтрами

12

find_by_code

Поиск элемента по коду

13

find_by_name

Поиск элемента по наименованию

14

get_register_records

Записи регистра с фильтрами

15

get_document_list

Список документов с фильтрами по дате/номеру

Группа В — CRUD (7)

#

Инструмент

Описание

16

create_object

Создание нового объекта (справочник/документ)

17

update_object

Изменение реквизитов объекта

18

delete_object

Пометка на удаление

19

post_document

Проведение документа

20

unpost_document

Отмена проведения

21

copy_object

Копирование объекта

22

set_attribute

Изменение отдельного реквизита

Группа Г — Код и отчёты (4)

#

Инструмент

Описание

23

execute_code

Выполнение произвольного кода на встроенном языке

24

evaluate_expression

Вычисление выражения и возврат результата

25

get_module_text

Получение текста модуля объекта

26

generate_report

Формирование отчёта (СКД)

Группа Д — Администрирование (6)

#

Инструмент

Описание

27

get_active_users

Список активных пользователей и сеансов

28

get_event_log

Журнал регистрации с фильтрами

29

get_locks

Текущие блокировки данных

30

get_server_info

Информация о платформе, конфигурации, сервере

31

check_references

Проверка ссылочной целостности

32

run_scheduled_job

Запуск регламентного задания

Группа Е — Интеграция (3)

#

Инструмент

Описание

33

exchange_execute

Выполнение обмена данными

34

get_exchange_log

Журнал обмена

35

import_data

Импорт данных из JSON

Группа Ж — Расширенные операции v2.0 (6)

#

Инструмент

Описание

36

fill_on_basis

Заполнение документа на основании другого

37

write_register_records

Запись набора записей регистра

38

update_tabular_section

Обновление табличной части объекта

39

subscribe_events

Подписка на события журнала

40

execute_batch

Пакетное выполнение инструментов

41

get_changes_since

Получение изменений с метки времени (CDC)

Группа З — Бухгалтерия, аудит, формы v2.1 (10) 🆕

#

Инструмент

Описание

42

get_balance

Остатки/обороты регистра бухгалтерии

43

get_register_totals

Итоги регистров накопления

44

get_accounting_entries

Проводки документа (Дт/Кт/Сумма)

45

get_related_documents

Связанные документы (цепочка оснований)

46

validate_document

Проверка заполнения без проведения

47

get_form_structure

Структура управляемой формы

48

get_rights

Права доступа текущего пользователя

49

find_duplicates

Поиск дублей по реквизитам

50

get_print_form

Печатные формы через УправлениеПечатью

51

get_configuration_extensions

Список расширений конфигурации (CFE)


🚀 Быстрый старт

Вариант 1: Через Claude Desktop / Cursor (stdio)

Способ А — через npx (без клонирования)

{
  "mcpServers": {
    "1c-erp": {
      "command": "npx",
      "args": ["infaton-mcp"],
      "env": {
        "ONEC_URL": "https://your-server/base/hs/mcp/",
        "ONEC_USER": "Username",
        "ONEC_PASSWORD": "Password"
      }
    }
  }
}

Способ Б — из клонированного репозитория

{
  "mcpServers": {
    "1c-erp": {
      "command": "node",
      "args": ["/path/to/MCP35/index.mjs"],
      "env": {
        "ONEC_URL": "https://your-server/base/hs/mcp/",
        "ONEC_USER": "Username",
        "ONEC_PASSWORD": "Password"
      }
    }
  }
}

Вариант 2: Прямой HTTP-вызов

1. Установите расширение

  1. Откройте Конфигуратор базы 1С

  2. Конфигурация → Расширения конфигурации → Добавить

  3. Выберите файл INFATON_MCP.cfe (или соберите по инструкции из Module.bsl)

  4. Обновите конфигурацию БД (F7)

2. Проверьте подключение

curl -u 'Логин:Пароль' -X POST \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"initialize","id":1}' \
  https://ваш-сервер/база/hs/mcp/

Ожидаемый ответ:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": { "tools": {} },
    "serverInfo": { "name": "infaton-1c-mcp", "version": "2.1.0" }
  }
}

3. Вызовите инструмент

curl -u 'Логин:Пароль' -X POST \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":2,"params":{"name":"get_balance","arguments":{"account_code":"41.01","period_from":"2026-01-01T00:00:00","period_to":"2026-03-31T23:59:59"}}}' \
  https://ваш-сервер/база/hs/mcp/

📐 Архитектура

┌─────────────────────────┐
│   AI Assistant          │  Claude / GPT / Qwen / Gemini / ...
│   (MCP Client)          │
└────────┬────────────────┘
         │ stdio (JSON-RPC 2.0)
         ▼
┌─────────────────────────┐
│   index.mjs             │  Node.js stdio → HTTP proxy
│   (MCP Transport)       │
└────────┬────────────────┘
         │ HTTP POST (Basic Auth)
         ▼
┌─────────────────────────┐
│   HTTP-сервис /hs/mcp/  │  Расширение INFATON_MCP.cfe
│   Module.bsl            │  51 инструмент (4 263 строки)
│   (MCP Server)          │
└────────┬────────────────┘
         │ Встроенный язык 1С
         ▼
┌─────────────────────────┐
│   База 1С:Предприятие   │  ERP / УПП / Бухгалтерия / УТ / КА
│   Данные, метаданные    │
└─────────────────────────┘

📝 Совместимость

Параметр

Значение

Платформа 1С

8.3.20+ (тестировалось на 8.3.27.1989)

Конфигурации

ERP 2.5, УПП 1.3, Бухгалтерия 3.0, УТ 11, КА 2

MCP Протокол

2024-11-05

Транспорт

HTTP (Basic Auth), stdio (через index.mjs)

Node.js

18+ (для stdio-обёртки)


📊 История версий

Версия

Дата

Инструментов

Изменения

v2.1.0

2026-05-14

51

+10 инструментов (бухгалтерия, аудит, формы), 9 багфиксов

v2.0.0

2026-05-08

41

+6 инструментов (batch, CDC, fill_on_basis и др.)

v1.0.0

2026-04-28

35

Первый публичный релиз


🔒 Безопасность

Обязательно для продакшена

Требование

Почему важно

HTTPS

Basic Auth передаёт логин/пароль в base64. По HTTP они видны любому в сети

Отдельный пользователь 1С

Создайте пользователя mcp_agent с минимальными правами — только нужные объекты

ONEC_ALLOWED_TOOLS

Ограничьте список инструментов для конкретного сценария

Опасные инструменты

Следующие инструменты требуют явного разрешения и должны использоваться осознанно:

Инструмент

Риск

Рекомендация

execute_code

Выполняет произвольный BSL-код в привилегированном режиме

Запрещать через ONEC_ALLOWED_TOOLS если не нужен

delete_object

Помечает объекты на удаление

Запрещать в аналитических сценариях

run_scheduled_job

Запускает регламентные задания

Запрещать если не нужен

import_data

Массовое создание/изменение объектов

Запрещать в read-only сценариях

post_document / unpost_document

Изменяет проведение документов и движения по регистрам

Только для операционных сценариев

Конфигурация только для чтения

ONEC_ALLOWED_TOOLS="get_metadata_tree,execute_query,get_object_by_ref,get_list,find_by_code,find_by_name,get_register_records,get_document_list,get_server_info,get_event_log,get_balance,get_register_totals,get_accounting_entries,get_related_documents,get_form_structure,get_rights,find_duplicates"

Подробнее — см. EXAMPLES.md.


📄 Лицензия

MIT © 2024-2026 INFATON — Привалов С.Ю.


Подробная инструкция по сборке .cfe — см. HOW_TO_BUILD_CFE.md

Примеры агентских сценариев — см. EXAMPLES.md

История изменений — см. CHANGELOG.md


📰 Публикация на Инфостарт

Infostart

Статья на портале Инфостарт: INFATON MCP Server v2.1 — 51 инструмент для AI-интеграции с 1С:Предприятие

Install Server
A
license - permissive license
B
quality
A
maintenance

Maintenance

Maintainers
Response time
2wRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    -
    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.
    Last updated
    19
  • A
    license
    -
    quality
    A
    maintenance
    Rust-native code index MCP server with first-class 1C:Enterprise (BSL) support. Static binary, no runtime — 25 MCP tools (18 universal + 7 BSL-specific), tree-sitter AST for 10 languages, federation across multiple repos.
    Last updated
    90
    MIT
  • A
    license
    -
    quality
    A
    maintenance
    Integrates AI agents with 1C:Enterprise databases via MCP and REST API, supporting a built-in HTTP server (no Python required) or a Python proxy mode.
    Last updated
    216
    GPL 3.0
  • F
    license
    -
    quality
    C
    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.
    Last updated

View all related MCP servers

Related MCP Connectors

  • ERP français avec serveur MCP natif : plus de 1 800 actions métier auto-générées via OpenAPI.

  • 350+ production-ready APIs through one MCP server — weather, geocoding, validation, financial data.

  • A paid remote MCP for hosted MCP server, built to return verdicts, receipts, usage logs, and audit-r

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/infaton/MCP35'

If you have feedback or need assistance with the MCP directory API, please join our Discord server