Hermes agent

Управление Hermes Cloud через MCP

Команды для Python-зависимостей на этой странице рассчитаны на чекаут исходников, подготовленный через PM. После изменения зависимостей заново активируйте чекаут и перезапустите Hermes.

Hermes Cloud держит ваши инстансы Hermes Agent на своих серверах. Обычно ими управляют со страницы /agents в Nous Portal. Этот гайд подключает локальный Hermes Agent к MCP-серверу Portal — и дальше облачными инстансами можно управлять простой просьбой: «покажи мои облачные агенты», «перезапусти остановленный», «во сколько мне это обходится». Терминал при этом покидать не нужно.

Перед вами обычный MCP-сервер, который хостит Nous Research; доступ закрыт тем же OAuth-входом, каким вы уже пользуетесь в Portal. После подключения у Hermes появляются два инструмента, которые он вызывает от вашего имени.

Что это даёт

После подключения модель может делать с вашей организацией в Hermes Cloud вот что:

О чём просите…Что срабатывает внутри
«Покажи мои облачные агенты»agents (list)
«Какой статус у <name>?»agents (get / status)
«Во сколько примерно обходится этот инстанс?»agents (cost_estimate)
«Запусти / останови / перезапусти <name>»agent (start / stop / restart)
«Подними новый инстанс с именем <name>»agent (create)
«Удали <name>»agent (destroy)
«Обнови env / образ у <name>»agent (update_env / update_image)

Каждый вызов уходит в вашу организацию под вашей учётной записью Portal, а членство перепроверяется при каждом обращении: подключение дотянется только до тех инстансов, которыми вы и так управляете из веб-интерфейса.

Требования

  • Аккаунт Nous Portal с доступом к Hermes Cloud (хотя бы один инстанс — или возможность его создать).

  • Установленная поддержка MCP. После стандартного установочного скрипта она уже на месте; если нет:

    cd ~/.hermes/hermes-agent
python -c "import pm; pm.sync_venv(['mcp'], explicit=True)"

Отдельный API-ключ или client secret вам не понадобится — сервер работает по OAuth с PKCE, а вход сводится к одному заходу в браузер.

Шаг 1: добавьте сервер

hermes mcp add --url https://portal.nousresearch.com/mcp --auth oauth hermes-cloud

Флаг --auth oauth сообщает Hermes, что перед ним HTTP-сервер под защитой OAuth. При первом подключении Hermes:

  1. Сам находит OAuth-эндпоинты сервера (метаданные по RFC 9728 / 8414).
  2. Регистрируется как клиент (Dynamic Client Registration, RFC 7591) — никакие секреты копировать не нужно.
  3. Открывает браузер на Portal, чтобы вы вошли и подтвердили доступ.
  4. Кладёт полученный токен в ~/.hermes/mcp-tokens/ и переиспользует его; обновление происходит автоматически.

Выбор организации

Если ваш аккаунт Portal состоит больше чем в одной организации, во время авторизации браузер покажет выбор организации — отметьте ту, которой будет управлять это подключение. Выбирают один раз и только в браузере, в командной строке передавать нечего. Аккаунты с единственной организацией этот шаг пропускают и привязываются сами.

Понадобилось перенацелить подключение на другую организацию — удалите сервер и добавьте заново (hermes mcp remove hermes-cloud, затем та же команда add), а в браузере выберите другую организацию.

Шаг 2: убедитесь, что подключение живое

hermes mcp test hermes-cloud

Затем запустите сессию (или перезагрузите уже открытую):

hermes chat
/reload-mcp

Задайте вопрос на чтение — он покажет, что инструменты доступны:

List my Hermes Cloud agents and their current status.

В ответ должны прийти те же инстансы, что вы видите на странице /agents в Portal.

Шаг 3: работайте

Вопросы на чтение безопасны всегда:

Which of my cloud agents is currently running, and roughly what is each one costing?

Действия над жизненным циклом описываются обычной просьбой:

Restart the instance called research-bot.
Create a new Hermes Cloud instance named scratch, then tell me when it's ready.

Hermes показывает, что вернул каждый инструмент — список инстансов, новый статус, детали созданного инстанса, — так что результат действия виден сразу.

Конфигурация

После hermes mcp add сервер живёт в ~/.hermes/config.yaml:

mcp_servers:
  hermes-cloud:
    url: "https://portal.nousresearch.com/mcp"
    auth: oauth

Учётных данных в config.yaml нет: OAuth-токен лежит отдельно, в ~/.hermes/mcp-tokens/ — ровно так же, как refresh-токен Portal не попадает в конфиг.

Как сузить набор инструментов

Сервер отдаёт и читающий инструмент (agents), и изменяющий (agent). Нужно подключение только на чтение — смотреть и запрашивать, но никогда не запускать, не останавливать, не создавать и не удалять, — оставьте один agents:

mcp_servers:
  hermes-cloud:
    url: "https://portal.nousresearch.com/mcp"
    auth: oauth
    tools:
      include: [agents]

После правки конфига выполните /reload-mcp. Вся модель фильтрации (include/exclude, prompts, resources) разобрана в гайде Использование MCP с Hermes.

Решение проблем

Браузер показывает выбор организации — какую выбрать?

Значит, вы состоите сразу в нескольких организациях Portal. Берите ту, чьими инстансами Hermes Cloud хотите управлять из этого подключения. Сомневаетесь — это организация, которой принадлежат инстансы со страницы /agents в Portal. Перевыбрать можно позже: удалить сервер и добавить его заново.

Почему при подключении выдаёт «invalid_client» или «unknown client»?

Сохранённая регистрация клиента больше не совпадает с сервером — например, раньше вы подключались к другому окружению. Почистите кэш OAuth-состояния для этого сервера и добавьте его заново:

hermes mcp remove hermes-cloud
rm -f ~/.hermes/mcp-tokens/hermes-cloud.*
hermes mcp add --url https://portal.nousresearch.com/mcp --auth oauth hermes-cloud

Сервер добавлен, а инструменты не появились — что делать?

Перезагрузите MCP прямо внутри сессии и проверьте ещё раз:

/reload-mcp
Tell me which MCP-backed tools are available right now.

Если их по-прежнему нет, запустите hermes mcp test hermes-cloud — команда покажет ошибку подключения напрямую.

Почему Hermes снова просит войти?

OAuth-токены обновляются сами, но, когда Portal обнуляет вашу сессию (смена пароля, отзыв доступа, истечение срока), следующий вызов попросит переавторизоваться. Повторите команду hermes mcp add — браузерный поток выпустит новый токен.

Как подключиться с headless-машины, по SSH или на удалённом хосте?

Браузерный OAuth-колбэк приходит на ту машину, где работает Hermes. На удалённом хосте пробросьте loopback-порт по SSH — схема ровно та же, что и для любого другого OAuth-входа. См. OAuth через SSH и удалённые хосты.

Смотрите также

перевод и редактура:

обновлено

⌕ ESC