humanemulator.net — справка. Продукт, демо и покупка — на хуманэмулятор.рф | Демо | Купить | API | лог изменений

Сверено 21 октября 2026 по выпускам 7.0.78 и 8.1.6. · ИИ Ассистент

Поиск API · Справочник объектов · Настройка ИИ Ассистента · Studio 8: что нового

MCP: справочник API

MCP в Studio — это локальный сервер с документацией API Human Emulator: модель спрашивает через search_api, get_method_info, get_class_info и get_examples и получает настоящую подпись метода с примером, а не строку, которую выучила. Это не рантайм робота и не замена записи файла на диск. По умолчанию MCP выключен.

Что лежит в коробке

Сервер справочника ставится вместе с продуктом: готовый индекс методов лежит в подпапке MCP рядом с программой. Он не стартует при запуске приложения — сервер поднимается при первой проверке или когда MCP включён. Поэтому «MCP выключен» в настройках не значит «справочника нет»: значит, процесс ещё не запущен.

В линейке 8.x (бета) индекс лежит в каждой коробке выпуска, начиная с 8.1.3, на Windows и Linux; в 7.x — начиная с 7.0.78. Коробки Runtime (исполнители без среды разработки) сервера справочника не содержат на обеих линиях: там нечего настраивать.

Как включить: «Проверить MCP»

  1. Настройки ИИ Ассистента → раздел MCP.
  2. Нажмите «Проверить MCP». Проверка пингует адрес из формы и поднимает локальный сервер, а результат показывает статусом (OK / Failed) и числом доступных инструментов.
  3. Только после успешной проверки включайте «Использовать XHE MCP сервер».
  4. Опция «Авто-включение» (включать MCP при отправке, если сервер отвечает) заведена, чтобы живым оставался честный режим: недоступный сервер не включается никогда.

Первая проверка может идти десятки секунд — это нормально: сказывается ленивый старт сервера и загрузка индекса. Повторные отвечают за доли секунды. В 8.x переключатель MCP живёт не на главной полосе чата, а в меню ⋯ «Дополнительные действия»: включать его стоит после того, как проверка в настройках прошла.

Подсказка настройки формулирует правило прямо: «Живая документация API XHE. Не включайте, пока „Проверить MCP“ не пройдёт». Красная проверка при живом сайте справки — это не «MCP не работает», а «сервер не поднят или индекс не на месте».
Страница «MCP» окна «Настройки ИИ» Studio 8: адрес сервера, чекбокс использования, кнопка «Проверить MCP» с чипом статуса, авто-включение и офлайн-каталог методов
Страница MCP окна «Настройки ИИ» в Studio 8: адрес (http://localhost:8000/mcp), чекбокс «Использовать XHE MCP сервер», кнопка «Проверить MCP» с чипом статуса рядом и два переключателя — «Авто-включение MCP при доступности» и «Офлайн-каталог методов». Отмеченный чекбокс на кадре — состояние стенда: порядок действий остаётся прежним, сначала проверка, потом включение. Справа — справка раздела, где сказано, что офлайн-каталог работает без запущенного сервера.

Адрес и четыре инструмента

Адрес по умолчанию — http://localhost:8000/mcp; он же правится в настройках, если сервер поднят в другом месте. Общение — обычный HTTP с JSON-RPC: запрос initialize, затем tools/list и вызовы инструментов. Программа ходит только по локальному адресу (loopback) и наружу ничего не открывает: справочник локален.

ИнструментЗачем модели
search_apiнайти метод по формулировке задачи («распознавать капчу», «найти окно по заголовку»)
get_method_infoточная сигнатура метода: параметры, типы, возвращаемое значение
get_class_infoобзор объекта (класса) и его методов
get_examplesпример вызова на языке робота

Именно эти четыре позиции и показывает успешная проверка. Если сервер отвечает на пинг, но список инструментов не отдаётся, счётчик не появится — см. раздел «Когда MCP мешает».

Страница «API-каталог» окна «Настройки ИИ» Studio 8: поиск ресурсов, кнопка «Обновить» и четыре карточки шаблонов ресурсов MCP XHE
Вкладка API-каталог в Studio 8 — то же самое глазами пользователя: поиск ресурсов, «Обновить» и «Шаблоны ресурсов (4)» с шаблонами вызова (php://class/{class_name}, php://category/{category}, php://examples/{class_name}/{method_name}, php://method/{class_name}/{method_name}), а под прокруткой — «Инструменты MCP XHE (4)». Вкладка только показывает, что отдал сервер: настроить отсюда ничего нельзя.

Windows и Linux, Studio и Runtime

Контракт проверяли на трёх хостах — классическая Studio на Windows, Studio 8 на Windows и Studio 8 на Linux. Результат: один и тот же индекс, те же четыре инструмента, одинаковые ответы на одинаковые запросы; русские формулировки дают правильные вершины с примерами («найти окно по заголовку» → get_by_text, «заполнить поле» → set_value_by_name).

Что при этом различается по хостам:

  • классическая Studio (7.x), Windows — сервер поднимается из {app}\MCP тем же приложением, что и робот;
  • Studio 8, Windows и Linux — payload лежит в коробке обеих марок (rpa и xhe), сервер стартует той же командой; на Linux сборка индекса приехала в 8.1.6;
  • Runtime (обе линии, обе ОС) — MCP отсутствует намеренно: это исполнитель, в нём нет панели ИИ Ассистента.

Версии: индекс в коробках 8.x — с 8.1.3 (Windows) и 8.1.6 (Linux); в 7.x — с 7.0.78. Примеры вызовов в выдаче установленного продукта вернулись в 7.0.78.

Без MCP: офлайн-каталог

Для задачи «открыть URL, подождать, сохранить title, quit» MCP не нужен. Ассистент опирается на:

  • AGENTS.md и включённые .agents/rules/*.md;
  • канон: WEB::$browser->navigate, wait_js, get_title, запись в data/*, WINDOW::$app->quit();
  • grep / search_project по проекту;
  • офлайн-каталог частотных методов — справочник методов прямо в промпте, из шаблонов API; он включён по умолчанию и работает без сервера. MCP его дополняет, а не заменяет: редкие методы и примеры — у MCP, типовые — уже в контексте.

В режиме MCP off вызовов search_api в trace быть не должно: поиск уходит в офлайн-каталог. Скрипт на PHP при этом остаётся скриптом на PHP — каталог отвечает «как называется метод», а не «как работает ваш робот».

Версии: офлайн-каталог частотных методов — с 7.0.78.

MCP on vs off

MCP onMCP off
Инструменты документацииsearch_api, get_method_info, get_class_info, get_examplesнет; поиск по офлайн-каталогу в промпте
Типичный title-роботработаетработает на каноне
Редкий метод APIlookup в справке, точная сигнатураспросить пользователя или дать пример в чат
Пример вызова на языке роботаget_examplesсниппеты из каталога: сниппеты
Стоимостьживёт локально, внешних вызовов нетто же

Когда MCP мешает

Пинг может отвечать 200, а список инструментов — падать: например, индекс на месте, но сервер не догружен. Проверка при этом либо показывает Failed, либо не называет число инструментов. Не считайте такой MCP рабочим: вызовы документации модель будет получать пустыми, а робота это не ускоряет.

Продукт ведёт себя честно: если сервер отвечает, но search_api падает, MCP остаётся выключенным, а поиск уходит в офлайн-каталог — в журнале это видно строкой про то, что сервер отвечает, но поиск не работает. Варианты действий: гонять робота с MCP off (для типовых задач этого достаточно) или починить сервер — проверить адрес в настройках, порт и наличие папки MCP рядом с программой.

Ещё одна частая жалоба — «MCP выключился сам». Так и задумано: авто-включение включает сервер только при живом ping и ничего не включает вслепую.

Как проверить у себя

  1. Настройки → MCP → «Проверить MCP». Должно появиться число инструментов (четыре). Пусто или Failed — сервер не поднят.
  2. Включите MCP, задайте модели вопрос про редкий метод («как сохранить страницу в PDF?») и посмотрите карточки инструментов в ленте чата: должен вызываться search_api.
  3. Выключите MCP и повторите тот же вопрос: вызовов search_api в trace быть не должно — ответ модель соберёт по офлайн-каталогу и правилам проекта.
  4. Проверьте папку MCP рядом с исполняемым файлом: если её нет, установка неполная — переустановите продукт или сверьтесь с структурой папок.

Смежные страницы: ИИ Ассистент: полный маршрут, настройка провайдера, панель ИИ Ассистента, типовые ошибки.

← Композер · Со страницы →