Инструменты Открытой версии

11 отдельных инструментов, доступных в бесплатной версии mcp-1c. Каждый инструмент вызывается AI-клиентом по имени.

Девять из них сервер регистрирует всегда. Ещё два, search_code и reload_dump, работают по выгрузке конфигурации и появляются в списке инструментов только когда сервер запущен с флагом --dump. Без этого флага AI-клиент их просто не увидит.

В Открытой версии каждый инструмент имеет собственное имя и параметры (как показано ниже). В Расширенной и Профессиональной версиях эти возможности объединены в консолидированные инструменты с параметром action (code_read, code_search, code_execute, system и др.).

get_metadata_tree

Открытая

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

Список всех объектов конфигурации по категориям: справочники, документы, регистры, перечисления, определяемые типы, обработки и т.д. Без фильтра возвращает сводку (категории и количество), с фильтром выдаёт полный перечень объектов категории. Определяемые типы (DefinedType) также присутствуют в дереве. Вызывается первым при работе с незнакомой конфигурацией.

Параметры:

• filter (необязательный) - категория для фильтрации: Справочники, Документы, РегистрыНакопления, ОбщиеМодули и др.

get_object_structure

Открытая

Реквизиты и структура объекта

Реквизиты, табличные части, измерения, ресурсы, значения перечисления и типы полей объекта метаданных. Возвращает точные имена реквизитов, табличных частей и значений перечислений для запросов и кода. Для Enum дополнительно возвращается список значений перечисления. Поддерживается object_type=Subsystem: возвращается структура подсистемы.

Параметры:

• object_type (обязательный) - тип объекта: Catalog, Document, Enum, InformationRegister, AccumulationRegister, Subsystem и др.
• object_name (обязательный) - имя объекта, например РеализацияТоваровУслуг

execute_query

Открытая

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

Выполняет запрос на языке 1С (только ВЫБРАТЬ/SELECT, безопасно для рабочих баз) и возвращает данные: элементы справочников, документы, остатки, обороты, сведения из регистров. Поддерживает параметры через &Имя.

Параметры:

• query (обязательный) - текст запроса (только ВЫБРАТЬ/SELECT)
• limit (необязательный) - максимум строк результата (по умолчанию 100, максимум 1000)
• parameters (необязательный) - параметры запроса в виде пар ключ-значение (имя без амперсанда)

validate_query

Открытая

Проверка синтаксиса запроса

Проверяет синтаксис запроса 1С без выполнения и находит ошибки в ВЫБРАТЬ/SELECT. Рекомендуется вызывать перед execute_query.

Параметры:

• query (обязательный) - текст запроса для проверки

search_code

Открытая

Поиск по коду модулей

Полнотекстовый поиск по коду всех модулей конфигурации. Три режима: smart (полнотекстовый с ранжированием BM25, по умолчанию), regex (регулярные выражения), exact (точная подстрока). Поддерживает BSL-синонимы: поиск по английским именам находит русские и наоборот.

Параметры:

• query (обязательный) - поисковый запрос
• mode (необязательный) - smart, regex или exact
• category (необязательный) - фильтр по типу метаданных (Документ, ОбщийМодуль)
• module (необязательный) - фильтр по типу модуля (МодульОбъекта, МодульМенеджера)
• limit (необязательный) - максимум результатов (по умолчанию 50, максимум 500)

Требует: --dump (путь к выгрузке конфигурации DumpConfigToFiles)

get_form_structure

Открытая

Структура формы объекта

Структура управляемой формы: элементы интерфейса, команды, кнопки и обработчики событий. Состав элементов и обработчики берутся из Form.xml выгрузки конфигурации; без --dump возвращаются только имя и заголовок формы.

Параметры:

• object_type (обязательный) - тип объекта: Document, Catalog, DataProcessor и др.
• object_name (обязательный) - имя объекта метаданных
• form_name (необязательный) - имя формы (без него возвращается первая найденная)

Полная структура требует: --dump

get_event_log

Открытая

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

Чтение журнала регистрации 1С: лог ошибок, действий пользователей и системных событий. Фильтрация по дате, уровню важности и пользователю.

Требует прав: у пользователя 1С, под которым сервер обращается к базе, должно быть право «Администрирование». Платформа не отдаёт журнал регистрации без него, поэтому расширение проверяет право до чтения и при его отсутствии отвечает HTTP 403, не возвращая ни одной записи и не сообщая их количества. Частичный журнал под видом обычного ответа был бы хуже отказа.

Параметры (все необязательные):

• start_date, end_date - период в формате ISO 8601
• level - уровень важности: Ошибка, Предупреждение, Информация, Примечание
• user - имя пользователя 1С для фильтрации
• limit - максимум записей (по умолчанию 50, максимум 500)

get_configuration_info

Открытая

Информация о конфигурации

Общая информация о базе 1С: название конфигурации, версия, поставщик, версия платформы, режим работы (файловый / клиент-серверный). Полезно вызвать первым делом, чтобы понять, с какой конфигурацией работаете. Параметров нет.

bsl_syntax_help

Открытая

Справочник функций языка 1С

Справка по 180 встроенным функциям, методам типов и объектным паттернам языка 1С (BSL): строки, числа, даты, коллекции, файлы, HTTP, XML/JSON, транзакции, методы ТаблицаЗначений/Массив/Структура/Соответствие/Запрос и др. Возвращает синтаксис, параметры и пример использования.

Параметры:

• query (обязательный) - название функции на русском или английском, например СтрНайти или StrFind

analyze_subsystems

Открытая

Анализ топологии подсистем

Анализ распределения объектов конфигурации по подсистемам. Помогает при аудите архитектуры: найти неучтённые объекты, понять к каким подсистемам относится объект, выявить дублирование между ветвями дерева подсистем. Вид анализа задаётся параметром action:

• orphans - применимые объекты (справочники, документы, регистры, отчёты, обработки, веб-сервисы, регламентные задания и др.), не входящие ни в одну подсистему.
• containing - список подсистем, содержащих указанный объект (обратный индекс по объекту).
• intersections - объекты, входящие сразу в несколько подсистем.

Параметры:

• action (обязательный) - вид анализа: orphans, containing или intersections
• object (для action=containing) - имя объекта: полное (Документ.РеализацияТоваровУслуг) или короткое (РеализацияТоваровУслуг)
• object_type (необязательный) - уточнение вида метаданных при неоднозначном коротком имени: Справочник, Документ, РегистрСведений или английский эквивалент (Catalog, Document, InformationRegister)
• cross_branch_only (необязательный, для action=intersections) - если true, оставить только объекты из разных корневых веток дерева подсистем

reload_dump

Открытая

Перечитать выгрузку конфигурации

Перечитывает выгрузку конфигурации (DumpConfigToFiles) без перезапуска сервера. Вызывается после того, как выгрузка сделана заново. Сам 1С не запускает и выгрузку не создаёт: только перечитывает то, что уже лежит на диске. Параметров нет.

Что устаревает без вызова: модуль, добавленный или переименованный после запуска сервера, не находится ни в одном режиме search_code; изменения внутри уже существующего модуля не видит режим smart, потому что он отвечает по тексту, снятому при построении индекса. Режимы regex и exact перечитывают файлы на каждом запросе, поэтому ради них вызывать нечего.

Сверка идёт только по файлам .bsl (относительный путь, время изменения, размер). Правка, не затронувшая ни одного .bsl (например, только состав формы или только XML), сигнатуру не меняет: перестроение не выполняется и об этом сообщается явно. Индекс строится заново полностью, поэтому вызов стоит столько же, сколько перезапуск сервера с перестроением индекса.

Требует: --dump (без него инструмент не регистрируется)

MCP-промпты

Открытая версия также регистрирует готовые MCP-промпты, заранее заготовленные сценарии, которые AI-клиент подставляет в диалог. В Claude Desktop они доступны через меню «+» (или иконку слэш-команд) рядом с полем ввода, а в Claude Code через команду /mcp (промпты подключённого MCP-сервера). Промпт разворачивается в готовую инструкцию и сам вызывает нужные инструменты.

• review_module - ревью кода модуля: анализ на ошибки, нарушения стандартов 1С, производительность, читаемость и работу с транзакциями. Аргументы: object_type, object_name
• find_duplicates - поиск дублирующегося и избыточного кода в модулях объекта с предложениями по рефакторингу. Аргументы: object_type, object_name
• explain_object - объяснение назначения и устройства объекта: какие данные хранит, с чем связан, какую бизнес-логику содержат его модули. Аргументы: object_type, object_name

Сервер регистрирует и другие промпты (написание проведения, оптимизация запроса, объяснение конфигурации, анализ ошибки, помощь с отчётом, справочные промпты по синтаксису запросов и навигации по метаданным).