Инструменты по категориям
Источник — семантическая BM-модель конфигурации в запущенной EDT. Ссылки разрешаются службами среды; запись выполняется через модель проекта и транзакции EDT.
get_configuration_properties, get_metadata_objects, get_metadata_details, object_summary, ai_context, list_subsystems, get_command_interface, semantic_metadata_search | состав и свойства конфигурации. |
|---|---|
describe_db_tables | описание таблиц хранения по метаданным проекта; get_tags, get_objects_by_tags — метки объектов и выборка по ним. |
find_references, get_outgoing_structures, dependency_graph level=metadata/mixed, impact_analysis | ссылки метаданных, зависимости и последствия изменения объекта. BSL-граф level=modules описан отдельно. |
edit_metadata, rename_metadata_object, delete_metadata_object, add_metadata_attribute, copy_object | создание, свойства, ссылки, типы, состав, переименование и удаление объектов; пакетные операции и предпросмотр по контракту операции. |
extension_workshop, extension_lifecycle, extension_diff | создание и заимствование объектов расширения, сравнение с базовой конфигурацией. |
list_extension, install_extension, uninstall_extension, export_extension | расширения подключённой базы; операции установки и удаления требуют платформы и меняют базу. |
xdto_workshop, external_object_workshop, external_data_source_workshop | XDTO, внешние обработки/отчёты и источники данных. |
config_io, import_configuration_from_xml, import_configuration_from_binary, export_configuration_to_xml, export_object, export_common_picture, unpack_external_binary | перенос конфигурации и артефактов. |
compare_configurations, compare_three_way, support_registry | сравнение, объединение поставки и режимы поддержки; audit_role_rights — права ролей, включая удаление осиротевших прав с явным применением. |
Нужны EDT и открытые проекты; бинарный импорт привлекает платформу 1С. Для .cfe с заимствованиями нужна соответствующая базовая .cf; EPF/ERF распаковываются в контексте существующего проекта. Объединение поставки меняет проект. Видимость и право записи зависят от пресета.
Работает с моделью и индексами открытого EDT-проекта, а не с отдельной выгрузкой. Текстовый поиск доступен вместе с семантической навигацией.
read_module_source, read_method_source, get_module_structure, list_modules | исходники, методы и структура модулей. |
|---|---|
write_module_source | запись BSL через среду проекта. |
code_search | операции text_search, method_references, resolve_symbol, call_hierarchy, symbol_info, content_assist; отдельные tools search_in_code, go_to_definition, get_method_call_hierarchy, get_symbol_info, get_content_assist сохраняются. |
diff_module | сравнение модуля с HEAD Git либо локальной историей. |
find_dead_code | эвристический список невызванных экспортных методов; list_interceptors — перехватчики методов расширения. |
dependency_graph level=modules | граф вызовов BSL-модулей; уровень метаданных описан в сравнении метаданных. |
Требуются запущенная EDT и её индекс проекта. Модули внешнего поставщика доступны по адресу через IModuleSourceProvider; индексные ответы указывают покрытие поставщика. Поиск может вернуть частичные результаты по таймауту. Кандидат в мёртвый код не доказывает отсутствие динамических вызовов.
Читает документацию платформы средствами EDT, выбирая версию по проекту или установленную новейшую платформу без проекта.
get_platform_documentation | типы, глобальные функции, методы, свойства и конструкторы; фильтры языка, категории, члена и лимита. |
|---|---|
docs_lookup operation=get_platform_documentation | фасад чтения той же документации. |
docs_lookup operation=system_enum_values | значения системных перечислений. |
Нужны запущенная EDT и доступная документация платформы. Названный проект без версии платформы отклоняется, подмена другой версией не выполняется. Описания ИТС/БСП и семантическая база знаний этим reader не предоставляются.
Источник — встроенные страницы справки объекта конфигурации. Сначала читается BM-модель EDT; при отсутствии страниц используется каталог справки проекта на диске.
get_object_help | принимает проект, полное имя объекта, язык и формат; возвращает HTML либо Markdown с контекстом объекта. |
|---|---|
docs_lookup operation=get_object_help | фасад той же операции; ветка платформы относится к другой категории. |
Требуются EDT и проект с существующими страницами. Инструмент не генерирует документацию из BSL и не содержит отдельного semantic/RAG-индекса знаний о конфигурации.
Работает с моделью управляемой формы EDT. Правки выполняются транзакциями среды; снимок относится к редактору формы, а не к окну работающей 1С.
get_form_structure— реквизиты, элементы, команды и события.get_form_screenshot— PNG редактора формы, опциональная запись поsavePath.edit_form— поля, группы, кнопки, таблицы, декорации и удаление элементов.- Формовые операции
edit_metadata— создание формы, её реквизиты, команды, события и привязки; этот фасад также имеет самостоятельные операции с другими метаданными. generate_event_handlers— заготовки обработчиков; здесь учитывается ветка событий формы, объектные события относятся к шаблонам кода.
Нужны запущенная EDT и проект с формой. Для формы расширения путь к реквизиту базовой формы может вызывать заимствование. Если необходимые проверки пути недоступны, ответ перечисляет непроведённые проверки. Успешная запись модели не гарантирует корректность формы при запуске клиента; runtime-сценарии проверяются тестами.
СКД и макеты редактируются в проекте через BM-модель и службы EDT. Для записи СКД используются транзакции, для табличного документа — операции модели макета.
dcs_search | поиск элементов и выражений в схемах. |
|---|---|
dcs_workshop | наборы данных, поля и условия запросов, параметры, связи, вычисляемые поля, настройки и варианты; изменения могут возвращать предупреждения о полноте настроек. |
mxl_workshop | создание и чтение макета, ячейки, оформление, объединение, рисунки, именованные области и проверка ширины печати. |
Нужны EDT и проект с владельцем схемы/макета. Валидаторы работают с моделью проекта; выполнение отчёта на данных ИБ не является частью этих инструментов. Полученный макет или схема требуют проверки в прикладном сценарии.
Диагностики берутся из служб проверки EDT; дополнительный code review запускает отдельно настроенный BSL Language Server над исходниками проекта.
diagnostics,get_project_errors,get_problem_summary,clean_project,revalidate_objects,get_check_description— маркеры, сводки, перевалидация и объяснение проверок.marker_corrections— список и применение штатных исправлений EDT дляcheckId; может менять текст модулей, отказывает при несохранённом модуле.validate_query— синтаксическая и семантическая проверка текста запроса в контексте проекта, режим СКД, описание результата и ограниченные исправления текста.validate_for_export,generate_health_snapshot— готовность объектов к выгрузке и сводка состояния.code_review— внешний BSL Language Server JAR, фильтры модулей/важности, таймаут и лимит диагностик.detect_query_anti_patterns,find_rls_violations,sensitive_data_scan, соответствующие операцииsecurity_audit— эвристические проверки запросов, RLS и потенциальных секретов.
EDT должна быть запущена, проект загружен. Для code review нужен отдельный JAR и совместимая Java. Проверка запроса не исполняет его на данных базы. Эвристические находки требуют оценки разработчиком, а чистые маркеры не доказывают прикладную корректность.
Плагин запускает тестовый контур через приложения и отладчик EDT, затем читает артефакты соответствующего framework.
yaxunit_tests | фасад режимов run/debug, параметры проекта и запуска. |
|---|---|
run_yaxunit_tests | выполнение YAxUnit и чтение JUnit-отчёта. |
debug_yaxunit_tests | запуск YAxUnit под отладчиком. |
vanessa | запуск feature или текста сценария, открытие формы/списка, действия с выбранной строкой и кнопкой, получение результатов и снимков тестового клиента. |
Требуются EDT, платформа и тестовая ИБ, YAxUnit либо Vanessa Automation; UI-сценарии требуют соответствующего менеджера/клиента тестирования и компоненты снимков. Запуск может изменять данные базы. Чтение исходников и чистая валидация проекта не заменяют успешный тестовый прогон.
Доступ к значениям runtime выполняется через механизм watch expressions отладчика EDT в выбранном кадре остановленной программы.
evaluate_expression | вычисляет переданное выражение BSL через debug delegate, возвращает результат или ошибку. |
|---|---|
launch_debugger action=evaluate | фасад того же вычисления. |
Нужны приостановленная отладочная сессия и подходящий stack frame. Это не самостоятельный read-only query endpoint и не REST-доступ к объектам базы; вычисляемый BSL может обращаться к данным и иметь побочные эффекты. Инструмент не предоставляет серверный лимит строк или гарантию отсутствия записи.
Плагин определяет каталог файловой ИБ по приложению EDT и разбирает файлы журнала напрямую. Это самостоятельный файловый reader, без расширения в базе.
read_event_log | принимает projectName, опциональный applicationId, период, событие, пользователя, важность и лимит; возвращает события, число просмотренных записей, файлы и признак усечения. |
|---|---|
infobase_admin operation=read_event_log | фасад того же reader. |
Серверная ИБ и однофайловый SQLite-формат журнала отклоняются. Поддержанный файловый журнал должен быть доступен процессу EDT. Свободный текст проходит шаблонную маскировку; имена пользователей и компьютеров не гарантированно скрываются. Технологический журнал и настройка его сбора не предоставляются.
Сервер запускается внутри EDT и публикует MCP Streamable HTTP на loopback. Контекст — открытый workspace, службы приложений и живые debug targets EDT.
project_admin, list_projects, create_project, delete_project, resync_to_disk | проекты, конфигурации запуска и синхронизация с диском. |
|---|---|
infobase_admin, get_applications, create_infobase, register_infobase, delete_infobase, set_infobase_credentials, create_launch_config, branch_infobase | подключение баз и привязки к проекту/ветке. |
update_database, sync_control, start_client | обновление базы, диагностика синхронизации и запуск клиента. |
launch_debugger, debug_launch, set_breakpoint, set_exception_breakpoint, run_to_line, step, resume, wait_for_break, debug_status, get_variables, set_variable, terminate_launch | управление отладчиком EDT. |
start_profiling, get_profiling_results | профилирование отладочной сессии. |
git, git_commit, git_checkout | JGit внутри IDE: статус, ветки, история, коммит явно названных файлов и переключение ветки. |
get_edt_version, workspace_marks, get_mcp_history, self_status, self_upkeep, answer_dialog, restart_edt | состояние среды, метки, история вызовов, модальные окна и перезапуск. |
Нужны запущенная EDT и проект; runtime требует установленной 1С и настроенной базы. Dry run обновления не проверяет готовность базы или выгрузки. Удаление базы может затронуть её файлы при соответствующем параметре. Доступ ограничивается пресетами и настройками; это не headless-сервис.
Плагин обращается к установленному 1С:Напарнику через его фасад в EDT; модель и знания предоставляет сервис Напарника.
naparnik operation=status | наличие, версия и состояние моста; probe=true активирует интеграцию для проверки доступности. |
|---|---|
naparnik operation=ask | вопрос, продолжение разговора через conversationId/replyTo, лимит раундов; длительный ответ возвращает runKey для ожидания или отмены. |
Поддержана версия Напарника 1.0.7. Мост выключен по умолчанию; после включения допускаются инструменты чтения, а отдельный флаг разрешает полный набор с записью и исполнением. Пресеты только чтения отключают мост. Вопрос и полученный Напарником контекст уходят его сервису; это не локальный LLM-сервер.
В поставке один переносимый навык, использующий MCP-инструменты установленного плагина.
ai-edt | маршрутизация задач по BSL, метаданным, формам, запросам, диагностике, отладке, базам и тестам; три reference-раздела с фасадами, workflow и ожидаемым поведением. |
|---|
Навык объясняет выбор операций и ограничения
.cf может стать проектом через бинарный импорт, .cfe с заимствованиями требует базовую конфигурацию, .epf/.erf требуют существующий проект. Сам навык не запускает сервер и не предоставляет доступ к EDT: нужны установленный плагин, запущенная среда и настроенный MCP-клиент.
Другой OSGi-бандл EDT может расширить сервер через опубликованные Java-интерфейсы. Динамический реестр подхватывает сервисы при регистрации и удаляет при снятии.
IMcpTool | имя, схема и обработчик собственного MCP-инструмента. |
|---|---|
ru.aiedt.mcp.tool.writes | признак записи; без свойства инструмент считается пишущим и ограничивается соответствующими пресетами. |
ru.aiedt.mcp.tool.heavy | признак тяжёлого вызова для ограничения параллелизма и проверки памяти. |
IModuleSourceProvider | модули по адресу без отдельного файла, доступные штатным операциям чтения/записи и поиска. |
Это Java API для разработчика EDT-бандла, без визуального конструктора BSL-tools. Дополнительные инструменты не входят в число 135 встроенных. Нужны EDT и совместимый бандл; endpoint и политика доступа остаются у основного сервера.
Шаблоны встроены в плагин; текст собирается по имени и параметрам без обращения к LLM или внешнему каталогу.
code_template | HTTP handler, регламентное задание, подписки до/при записи, API общего модуля, серверное действие формы, объектные события, печать, длительная фоновая операция, команда внешней обработки и скелет YAxUnit-теста. template=list перечисляет варианты. |
|---|---|
generate_event_handlers | запись заготовок обработчиков; здесь учитываются объектные события, а ветка формы описана в категории форм. |
Ответ code_template — фрагмент для вставки, без автоматического изменения проекта. Генерация handlers меняет модель/модуль и зависит от пресета записи. Поиска пользовательских шаблонов, рейтингов и web-каталога нет.
Что учитывать
http://localhost:12250/mcp; сервер работает внутри процесса запущенной EDT. Loopback по умолчанию, опциональная Bearer-аутентификация; при привязке ко всем интерфейсам токен обязателен. Доступны пресеты и отдельное отключение инструментов.code_review — настроенный BSL Language Server JAR и совместимая Java; для тестов — YAxUnit или Vanessa Automation; для naparnik — установленный 1С:Напарник 1.0.7 и включённый мост. Maven 3.9+ нужен только для сборки плагина из исходников.update_database dryRun=true сообщает состояние обновления, но не выполняет проверку готовности базы и экспорта. Заимствующее объекты расширение при импорте .cfe требует соответствующую базовую .cf. Мост Напарника выключен по умолчанию; вопросы и прочитанный им контекст отправляются сервису Напарника. Проверки EDT и эвристические анализы не заменяют прикладные тесты.