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

10 отдельных инструментов, доступных в бесплатной версии mcp-1c. Каждый инструмент вызывается 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С: лог ошибок, действий пользователей и системных событий. Фильтрация по дате, уровню важности и пользователю.

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

• 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, оставить только объекты из разных корневых веток дерева подсистем

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

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