Инструменты по категориям
Расширение читает объект Метаданные работающей базы, без XML-индекса. Вызовы доступны через HTTP JSON-RPC сервис 1С; отдельный официальный STDIO-прокси обеспечивает стандартное подключение MCP-клиента.
get_configuration_info | имя, синоним, версия, поставщик, платформа, совместимость, режим базы и расширения с именем, версией и активностью. |
|---|---|
get_metadata_tree | счётчики и первые 50 объектов без фильтра, список по Catalog.* и другим поддержанным типам либо объект по точному имени. |
get_object_structure | принимает object_type и name, возвращает реквизиты, табличные части, измерения и ресурсы с именами, синонимами и типами. |
Поддержаны справочники, документы, регистры сведений и накопления, роли, перечисления, общие модули, обработки и отчёты. Список ролей не раскрывает их права; отдельного графа связей, анализа форм и изменения метаданных нет. Поле required у реквизитов возвращается как false и не отражает проверку заполнения платформой. Нужны расширение, БСП, публикация базы и настроенный доступ.
Аудитор кода диагностирует конкретную ошибку по стеку. Расширение передаёт модуль и строку REST-шиму; тот обращается к rlm-tools-bsl, работающему с заданной XML/BSL-выгрузкой, и получает тело метода и вызывающие места. Диагноз формирует модель через коннектор ИИконы.
ДиагностироватьОшибку— публичный BSL-вызов с текстом ошибки, именем модуля и номером строки; возвращает диагноз модели.ДиагностироватьИСохранить— находит ошибку по хешу в регистре мониторинга, извлекает координату и записывает диагноз обратно.- Автоанализ новых ошибок — регламентный сценарий для записей с координатой в стеке.
Это функции расширения, не MCP tools. Нужны модель, REST-шим, RLM и актуальные исходники; без найденного исходного метода полноценного контекста кода нет. Синтаксические проверки, набор правил статического анализатора, quick fixes и запуск тестов не предоставляются. Ответ LLM требует проверки разработчиком.
Инструмент исполняется в серверной сессии 1С через HTTP-сервис расширения. Для стандартного MCP-клиента предусмотрен отдельный STDIO-прокси.
execute_query | принимает обязательные query_id, query_text, limit и необязательные params. Выполняет запрос языка 1С; возвращает описания колонок, массив строк, total и признак truncated. |
|---|
query_id служит идентификатором переданного запроса, а не выбором из серверного каталога шаблонов. Лимит — целое от 1 до 1000; проверяется начало SELECT/ВЫБРАТЬ и запрещённые операции, вставляется ограничение с пробной дополнительной строкой. Права и RLS применяет платформа в текущей сессии. Ссылочные значения сериализуются строковым представлением. Произвольный BSL и запись бизнес-данных этим инструментом не предоставляются. Контроль персональных данных коннектора на результат MCP не распространяется; доступ определяется правами сессии публикации.
Мониторинг работает внутри расширения
читает журнал регистрации средствами платформы, сохраняет сгруппированные ошибки и статистику в регистрах базы. Управление доступно через обработку настроек, дашборд и регламентные задания, а не отдельный MCP log-tool.
- Сбор ошибок ЖР — чтение за период с пагинацией и отбором уровней; исключение тестовых событий и маркеров тестовых прогонов.
- Группировка — хеш события и нормализованного текста, учёт повторений и дат появления.
- ИИ-анализ — пакетный диагноз и критичность, сохраняемые в журнале мониторинга; глубокий анализ может привлекать метаданные и запросы к данным.
- Уведомления — Telegram и дайджесты по настройкам; регламентная очистка старых записей.
Нужны платформа 1С, БСП и расширение; для ИИ-анализа — модель, для уведомлений — Telegram. Технологический журнал не разбирается, logcfg.xml не настраивается. Внешний MCP-клиент не получает отдельной операции чтения ЖР; чтение регистров мониторинга возможно только обычным запросом при наличии соответствующих прав.
Расширяемый сервер использует состав специальной подсистемы 1С как реестр модулей-инструментов. Реестр вызывает публичную процедуру объявления инструментов в каждом включённом общем модуле; вызов по имени направляется в его обработчик.
- Регистрация собственного tool — общий модуль с
ДобавитьИнструментыиВыполнитьИнструмент, включённый в подсистему инструментов; объявление имени, описания и JSON Schema. tools/listиtools/call— публикация реестра и диспетчеризация через HTTP JSON-RPC; STDIO-прокси пересылает актуальный список из базы.ping— проверка доступности сpongи временем.generate_diagram— рендер переданногоkindиcodeчерез Kroki, результат SVG либо PNG в base64; базу не читает и схему из метаданных не строит.
В поставке шесть tools; resources и prompts не публикуются. Новые инструменты добавляются BSL-кодом и составом подсистемы, визуального конструктора нет. Агентская петля внутри 1С использует отдельный разрешённый список: новый инструмент не включается в него автоматически. Нужны расширение, БСП и веб-публикация; для стандартного MCP handshake — официальный Node.js STDIO-прокси. Сам HTTP-диспетчер поддерживает только tools/list и tools/call. Доступ защищён Basic Auth, ограничением частоты и аудитом.
Что учитывать
/hs/iikona-mcp/rpc внутри публикации базы, с Basic Auth; HTTP-диспетчер поддерживает tools/list и tools/call. Стандартный MCP handshake и STDIO предоставляет отдельный официальный iikona-mcp-proxy, пересылающий инструменты из сервиса 1С. SSE/Streamable HTTP непосредственно в расширении не реализованы..cfe. Для MCP — веб-публикация HTTP-сервиса, настроенные учётные данные и права сессии; для STDIO-прокси — Node.js 18+ и MCP SDK. Для ИИ-сценариев — доступная модель и её ключ либо локальный API; для диаграмм — Kroki; для аудитора — отдельный REST-шим, rlm-tools-bsl и актуальная XML/BSL-выгрузка. Qdrant и локальный сервис распознавания имён подключаются опционально.execute_query принимает query_id, query_text, params и обязательный limit от 1 до 1000, проверяет текст на запрещённые операции и выполняет запрос под правами текущей сессии, без привилегированного режима. Контроль персональных данных запросов к моделям не маскирует результаты MCP. Метаданные не редактируются; чтения BSL-модулей, запуска произвольного BSL и отдельного MCP-инструмента чтения ЖР нет. Аудитор даёт диагноз LLM по ошибке и исходникам через внешний сервис, а не диагностики линтера. generate_diagram рендерит переданный код в SVG/PNG через Kroki и сам не строит связи конфигурации. Модели и внешние сервисы могут оплачиваться отдельно.