Hermes MCP позволяет подключить к Hermes Agent внешний сервер инструментов через конфигурацию, ограничить видимый агенту набор функций и проверить доступ на отдельном тестовом сценарии. Для команды важны выбранный транспорт, фактические права учётной записи сервера и отказ при попытке запрещённой записи. Фильтр в клиенте сокращает доступную модели поверхность, а решение о полномочиях остаётся за сервером.
Задача подключения
Официальная документация NousResearch помещает внешние серверы в раздел mcp_servers файла ~/.hermes/config.yaml и поддерживает локальный stdio и удалённый HTTP. Для сервера доступен фильтр tools.include по именам инструментов.
В этой задаче Hermes Agent служит клиентом MCP: он обнаруживает доступные инструменты внешнего сервера и может вызывать их в рамках текущей сессии. Документация NousResearch описывает настройку в config.yaml, выбор транспорта и фильтрацию функций. Компания выбирает источник и действие, например чтение тестовой записи. После этого команда принимает решение о подключении.
Граница статьи уже сравнения Hermes и OpenClaw: выбор платформы относится к отдельному материалу «Hermes vs OpenClaw», а здесь проверяется подключение внешнего инструмента именно в Hermes. Общий принцип вызова функций рассмотрен в статье об инструментах MCP. Сейчас важны имена разрешённых операций, права самого сервера и след вызова. Результат подключения сам по себе говорит лишь о доступности сервера и его описаний.
Для пилота задают тестовый сервер с безопасной операцией чтения и отдельной операцией записи, предназначенной для проверки отказа. Администратор заранее знает, какой ответ допустим и где хранится тестовая запись. Для теста достаточно обезличенной записи без ключей и публикаций. Владелец интеграции согласует учётную запись и журнал вызовов с владельцем сервера.
Фильтр Hermes определяет, какие инструменты попадут в набор агента. Разрешение на данные и действие отдельно проверяет сервер на каждом вызове.
Транспорт и конфигурация
Для локального stdio-сервера в mcp_servers указывают имя подключения, command и args. Hermes запускает такой сервер как дочерний процесс и обменивается сообщениями через стандартные потоки. Для удалённого HTTP-сервера указывают url; параметры авторизации зависят от конкретного сервиса и согласованного способа входа. Эти формы показаны в официальной справке. Команда выбирает транспорт по расположению сервера и требованиям к доступу, сохраняя одну и ту же процедуру приёмки прав.
Пример проектной записи: в config.yaml указывают mcp_servers с именем test_docs; внутри размещают url тестового HTTP-адреса и tools.include с точным именем разрешённого инструмента чтения. Для stdio вместо url используют command и args доверенного исполняемого компонента. Имя read_record здесь условное: реальное название берут из списка инструментов подключённого сервера. Секрет размещают в утверждённом хранилище команды; пример конфигурации и промпт остаются без него.
Сервер из каталога Hermes тоже требует проверки. Документация объясняет, что каталог содержит одобренные записи и позволяет выбирать инструменты при установке, однако установка способна запускать код из указанного источника. Администратор сверяет источник кода, установку и права. Каталожная запись помогает настройке; безопасность будущего вызова проверяют отдельно. Для собственных серверов проверяют код и конфигурацию таким же образом.
При изменении конфигурации перечень функций обновляют в новой сессии либо через предусмотренный документацией механизм перезагрузки MCP. Разрешённые инструменты фиксируют вместе с версией сервера. Для чувствительного контура удобен точный список включений: широкие шаблоны могут захватить новые функции после релиза. Указание include ограничивает регистрацию инструментов в Hermes; серверные права остаются самостоятельным слоем.
Проверьте адрес HTTP-сервера либо происхождение локальной команды, затем сверьте реальные имена инструментов. Тестовый контур должен содержать только разрешённые данные.
Проба инструмента
Рабочий процесс будущего пилота строят вокруг читаемой тестовой записи. Владелец формулирует вопрос, ожидаемый идентификатор и допустимые поля ответа. Администратор сверяет список функций, выбирает минимальный include и запрашивает запись. Ответ модели сравнивают с исходной записью сервера. Такой тест показывает, что агент дошёл до нужного инструмента, понял результат и удержал идентификатор объекта.
- Владелец сервера готовит обезличенную тестовую запись и отдельную учётную запись с правом чтения. Ожидаемые поля фиксируют до запроса к агенту.
- Администратор сверяет транспорт, адрес и обнаруженные имена функций. В tools.include оставляют точное имя операции чтения, затем обновляют набор инструментов Hermes.
- Агент запрашивает тестовую запись. Парсер или скрипт сверяет полный структурированный ответ с эталоном; языковая модель объясняет содержимое и отмечает возможные несоответствия.
- Человек проверяет исходный ответ сервера и вывод модели. После этого администратор пробует запрещённую запись через отдельный контрольный клиент с ограниченной учётной записью и сохраняет факт серверного отказа.
Последний шаг проверяет полномочия сервера через отдельный контрольный клиент. Клиентский фильтр скрывает функцию записи от Hermes, поэтому серверный отказ испытывают отдельно на тестовом объекте и с заранее согласованным способом вызова. Если запись проходит, контур возвращают на настройку ролей сервера. Заявленное моделью намерение «только читать» сохраняет ошибку доступа.
В статье о настройке MCP-подключений разобран общий путь клиента к серверу. Для Hermes важны ещё правила отображения функций через include и проверка того, что модель видит ровно согласованный набор. Перед передачей сценария коллегам владелец оформляет карточку: источник, транспорт, список функций, вид разрешённой записи и владелец отзыва доступа. Карточка делает настройку проверяемой командой.
Нужен контролируемый доступ агента к вашим инструментам?
Границы прав
Фильтрация tools.include сокращает видимый набор функций; серверная учётная запись сохраняет свои права. Сервер проверяет подлинность вызова, разрешённый объект и допустимое действие. Для чтения это означает отказ на чужом объекте; для записи — отказ без профильной роли и подтверждения. Подтверждение пользователя тоже проверяют на сервере или в контролируемом промежуточном маршруте, связанном с конкретным действием. Промпт описывает порядок; технический барьер обеспечивает сервер.
Набор операций пересматривают при обновлении сервера. Если каталог инструментов расширился, точный include помогает сохранить прежнюю видимую поверхность. Однако даже старая операция чтения может начать возвращать больше полей, поэтому владелец сверяет схему ответа и настройки доступа. Ресурсы и промпты MCP тоже учитывают: официальная документация Hermes описывает отдельные переключатели для таких вспомогательных возможностей. Их включают только при понятной задаче и проверенных данных.
В журнале пилота хранят имя сервера, инструмент, идентификатор тестовой записи, результат проверки и причину отказа. Ключи, токены и чувствительные данные держат вне журнала. Если ответ сервера содержит текстовые инструкции агенту, их рассматривают как недоверенные данные. Инженер проверяет, что агент пересказывает запись как источник фактов, без изменения правил доступа из-за текста внутри ответа. Такой тест показывает, удерживает ли контур границу между содержимым данных и командами оператора.
Отказ при ошибочной конфигурации должен быть понятным. Если соединение отсутствует, функция скрыта фильтром или сервер отвечает отказом, журнал фиксирует соответствующую причину. Команда показывает отказ честно и сохраняет исходные права. После исправления конфигурации заново проверяют чтение и запрет записи, сохраняя прежний эталон. Решение о рабочем подключении принимает владелец процесса вместе с администратором сервера.
Фильтр защищает интерфейс агента от лишних функций; серверный отказ доказывает границу полномочий. Для приёмки нужны оба наблюдения.
Приёмка пилота
Будущий пилот принимают по набору доказательств: правильная тестовая запись прочитана, её поля сверены с эталоном, лишние функции отсутствуют в наборе Hermes, попытка записи отклонена сервером, а журнал позволяет восстановить ход запроса. Каждый пункт получает проверяющего. Описание возможностей поставщика подтверждает существование механизма подключения, но результат для конкретного сервера фиксируют только после собственного теста.
При смене владельца интеграции проверяют состояние учётной записи и отзыв разрешения. При изменении версии сервера снова сверяют имена функций, схему ответа и отказ на запретную операцию. Если сервер временно недоступен, агент сообщает об отсутствии данных; оператор возвращается к первоисточнику. План повторной проверки заранее включают в карточку подключения, чтобы фильтр и серверные роли оставались согласованными с рабочей задачей.
Стоимость решения зависит от выбранного сервера, инфраструктуры, сопровождения доступа и использования модели. Тарифы проверяют в текущих условиях поставщиков без переноса цифр из чужого примера. В разделе о внедрении ИИ-агентов можно обсудить проектирование серверной границы и журнала под конкретный процесс. Оценка имеет смысл после того, как команда определила разрешённые данные, точный набор функций и владельца решения.
Итогом становится воспроизводимое подключение, у которого понятны транспорт, список видимых функций и фактические серверные права. Hermes может обнаружить инструмент и передать результат модели; доверие к источнику, проверка вычислений по полным выгрузкам и разрешение на действие остаются задачами системы и человека. Такая схема помогает использовать внешний MCP-сервер в рабочем контуре без заявления о безопасности одного только фильтра.