Перейти к содержанию

MCP в Vanessa Automation

Как начать использовать MCP Vanessa Automation

  • Нужно установить в базу менеджера тестирования расширение из проекта onec-client-mcp-devkit
  • При запуске Vanessa Automation определяет, что в базе установлено это расширение и регистрирует в нём свои инструменты
  • В форме плагина web-transport-addin нужно нажать на кнопку "Запустить"
  • Лучше сначала запустить MCP сервер, а затем запускать ИИ среду рарзработки

Примеры конфигов для разных сред управления ИИ

Плагин Continue для VSCode

  • Путь к файлу конфига: "C:\Users\ИмяПользователя.continue\mcpServers\VanessaAutomation.yaml"
name: VanessaAutomation
version: 0.0.1
schema: v1
mcpServers:
  - name: VanessaAutomation
    type: streamable-http
    url: http://localhost:9874/mcp

Доступные инструменты:

Инструмент Описание
activate_window Активизирует внутреннее окно клиента тестирования по его заголовку. Заголовок искомого окна передаётся в обязательном параметре window_title.
check_syntax Проверяет синтаксис Gherkin в активном документе редактора Vanessa Automation или в указанном feature-файле. Возвращает Markdown с найденными ошибками: неизвестные шаги, структурные проблемы, ошибки ключевых слов.
connect_test_client Подключает клиент тестирования 1С по имени профиля. Необходимо для работы get_form_analysis, xecute_feature_step и запуска сценариев, которым требуется клиент тестирования для работы.
execute_feature_step Выполняет шаг из .feature файла по номеру строки. Валидирует что файл открыт в редакторе, активирует вкладку при необходимости.
execute_step_from_text Выполняет произвольный текст, в котором содержится шаг Vanessa Automation. Параметр stepText обязателен. Нельзя вызывать шаги, которые в себе содержат строку 'в течение' т.к. они работают асинхронно и Vanessa Automation не будет ждать завершения выполнения такого шага при работе инструмента execute_step_from_text. Такие шаги нужно выполнять в рамках feature файла.
get_active_window_data В зависимости от параметра type возвращает важные свойства активного окна клиента тестирования: window_caption (заголовок окна), navigation_link (навигационная ссылка), form_name (имя формы), form_caption (заголовок формы).
get_editor_state Возвращает состояние Monaco-редактора Vanessa Automation: открытые вкладки, содержимое активного документа, позицию курсора, ошибки. Один вызов для полного понимания контекста редактора.
get_form_analysis Возвращает информацию о текущей форме тестируемого приложения: дерево элементов или состояние формы как Gherkin-шаги. Требует подключённого клиента тестирования.
get_info_about_line_scenario Получает подробную информацию о указанной строке файла открытого в редакторе. Если в строке находится шаг сценария, то будет возвращена подробная информация о шаге.
get_test_results Подробные результаты выполнения сценария: статус каждого шага, время, ошибки. Если scenarioId не указан — результат последнего сценария.
get_VanessaAutomation_state Возвращает текущее состояние Vanessa Automation в формате Markdown: выполняется ли сценарий, текущая фича (имя, путь, язык, теги), текущий сценарий (имя, статус, теги), текущий шаг (текст, статус, ошибка).
get_window_list_os Возвращает список окон доступных для снятия скриншота с точки зрения операционной системы.
get_window_list_testclient Получает список внутренних окон клиента тестирования. Результат можно использовать для активизации окна или получения данных из текущего окна.
get_window_screenshot_os Делает скриншот окна клиента тестирования и возвращает изображение для последующего анализа с помощью компьютерного зрения.
load_features Загружает или перезагружает .feature файлы. Используйте после редактирования .feature файла, чтобы перечитать файл с диска в Vanessa Automation.
manage_breakpoints Управление точками останова в Gherkin-сценариях. Действия: toggle (по умолчанию), remove_all, list.
manage_variables Чтение, установка и удаление переменных тестового контекста. Переменные бывают локальные и глобальные.
open_feature_file Открывает .feature файл в Vanessa Editor или активирует уже открытую вкладку. Используйте перед check_syntax, execute_feature_step и ручной навигацией по редактору.
run_scenario Запускает выполнение сценариев. Режимы: all (все сценарии), reloadAndRun (перезагрузить и запустить выбранный), selected (выбранный в дереве), fromCurrentStep (с текущего шага).
search_for_steps_by_keywords Ищет шаги Vanessa Automation по переданной строке поиска и возвращает их в формате Markdown. Поиск производится по представлению шагов, описании шагов и типу шагов.
select_scenario Делает сценарий текущим по его имени.
select_step Делает шаг текущим по номеру строки.
stop_scenario Посылает команду Vanessa Automation, что нужно остановить выполнение сценариев.