Как подключить MCP-сервер к Hermes Agent

Nous Research· Проверено 13.11.2026

Hermes Agent хранит MCP-серверы в ~/.hermes/config.yaml в разделе mcp_servers. Сервер добавляется командой hermes mcp add, из каталога через hermes mcp install или правкой файла.

Где лежит конфиг

~/.hermes/config.yamlLinux, macOS, WSL2, Termux
$HERMES_HOME/config.yamlДругая папка данных

Как добавить сервер

1
Через файл

Откройте файл командой hermes config edit. В mcp_servers локальному серверу нужны command, args и env, удалённому — url и headers. После правки выполните /reload-mcp в чате.

2
Командой

hermes mcp add <имя> --command npx --args -y пакет для локального сервера или hermes mcp add <имя> --url адрес --auth header для удалённого. Флаг --args ставьте последним.

3
Из каталога

hermes mcp без подкоманды открывает каталог одобренных Nous серверов, hermes mcp install deepwiki ставит сервер по имени.

4
Hermes Desktop

В настройках приложения есть раздел MCP-серверов. Ссылка hermes://mcp/install открывает окно с готовым конфигом, сервер добавится после вашего подтверждения.

Как проверить и удалить

Проверкаhermes mcp test <имя> подключается к серверу и выводит его инструменты, hermes mcp list показывает все серверы. Сводка запуска в agent.log называет серверы, которые не подключились, и причину.
Удалениеhermes mcp remove <имя> удаляет сервер из config.yaml. Строка enabled: false в записи сервера выключает его без удаления.
СекретыПишите ${VAR} или ${env:VAR} в env, headers, args и url, а сами значения держите в ~/.hermes/.env. Локальный сервер получает только свой env и базовые переменные.
Выбор инструментовtools.include оставляет перечисленные инструменты, tools.exclude убирает лишние. resources: false и prompts: false отключают обёртки для ресурсов и промптов.
OAuthauth: oauth включает вход OAuth 2.1 с PKCE. Токены лежат в ~/.hermes/mcp-tokens/<сервер>.json, повторный вход — hermes mcp login <имя>.
Недоверенный серверtrust: untrusted просит подтверждения перед каждым инструментом, который может что-то изменить.
Тяжёлые серверыidle_timeout_seconds и max_lifetime_seconds перезапускают локальный сервер после простоя или по возрасту, например @playwright/mcp с Chromium.

Готовые конфиги для Hermes Agent

Нажмите на сервер, чтобы раскрыть конфиг в формате Hermes Agent. Несколько серверов в одном файле соберёт конструктор mcp.json.

Playwright MCPДаёт агенту настоящий браузер
mcp_servers:
  playwright:
    command: "npx"
    args: ["@playwright/mcp@latest"]

Страница сервера: инструменты, ключи, ограничения

GitHub MCPПодключает агента к GitHub
mcp_servers:
  github:
    url: "https://api.githubcopilot.com/mcp/"
    headers:
      Authorization: "Bearer <GitHub PAT>"

Страница сервера: инструменты, ключи, ограничения

Context7 MCPПодтягивает в контекст агента свежую документацию и примеры кода…
mcp_servers:
  context7:
    url: "https://mcp.context7.com/mcp"
    headers:
      Authorization: "Bearer <ключ Context7>"

Страница сервера: инструменты, ключи, ограничения

Figma MCPПодключает агента к макетам Figma
mcp_servers:
  figma:
    command: "npx"
    args: ["-y", "figma-developer-mcp", "--stdio"]
    env:
      FIGMA_API_KEY: "<ваш токен Figma>"

Страница сервера: инструменты, ключи, ограничения

Chrome DevTools MCPДаёт агенту живой Chrome с инструментами DevTools
mcp_servers:
  chrome-devtools:
    command: "npx"
    args: ["-y", "chrome-devtools-mcp@latest"]

Страница сервера: инструменты, ключи, ограничения

Filesystem MCPОткрывает агенту доступ к файлам в папках, которые вы перечислили при…
mcp_servers:
  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Desktop", "/path/to/other/allowed/dir"]

Страница сервера: инструменты, ключи, ограничения

Fetch MCPДаёт агенту читать веб-страницы
mcp_servers:
  fetch:
    command: "uvx"
    args: ["mcp-server-fetch"]

Страница сервера: инструменты, ключи, ограничения

Memory MCPДаёт агенту долгую память между чатами
mcp_servers:
  memory:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-memory"]
    env:
      MEMORY_FILE_PATH: "<полный путь>/memory.jsonl"

Страница сервера: инструменты, ключи, ограничения

Supabase MCPПодключает агента к проектам Supabase
mcp_servers:
  supabase:
    url: "https://mcp.supabase.com/mcp"

Страница сервера: инструменты, ключи, ограничения

Notion MCPЛокальный сервер Notion поверх Notion API
mcp_servers:
  notion:
    command: "npx"
    args: ["-y", "@notionhq/notion-mcp-server"]
    env:
      NOTION_TOKEN: "ntn_<токен интеграции>"

Страница сервера: инструменты, ключи, ограничения

Blender MCPСвязывает агента с запущенным Blender
mcp_servers:
  blender:
    command: "uvx"
    args: ["mcp-for-blender"]

Страница сервера: инструменты, ключи, ограничения

1С MCPПоказывает агенту метаданные и содержимое базы 1С:Предприятие
mcp_servers:
  1c:
    url: "http://<веб-сервер>/<имя публикации>/hs/mcp/"
    headers:
      Authorization: "Basic <логин и пароль пользователя 1С>"

Страница сервера: инструменты, ключи, ограничения

Ограничения

!

Удалённый сервер по умолчанию подключается через Streamable HTTP, для старых SSE-серверов нужна строка transport: sse.

!

Запрос с OAuth в браузере не дождётся автоматической перезагрузки конфига: она ждёт 30 секунд. Запустите hermes mcp login <имя> в отдельном терминале.

!

За один проход Hermes подключает не больше 4 серверов одновременно, остальные ждут своей очереди.

!

Уведомления об изменении промптов и ресурсов сервера Hermes пока не обрабатывает.

Если не работает

Сервер в конфиге, но ничего не загружается
Проверьте, не осталась ли строка enabled: false, есть ли npx или uvx, доступен ли адрес и верны ли env или headers.
Инструментов меньше, чем у сервера
Их отсёк фильтр tools.include или tools.exclude, либо сервер не поддерживает ресурсы и промпты.
Удалённый сервер отвечает 400 или 405
Адрес работает только по SSE, добавьте transport: sse. Ответ 401 или 403 говорит о неверном токене или входе OAuth.
${VAR} in url/headers is not set in this profile's .env
Впишите переменную в .env профиля, при следующем подключении Hermes подставит её.

Частые вопросы

Где в Hermes Agent настройки MCP?
В файле ~/.hermes/config.yaml, раздел mcp_servers. Блок mcpServers из ~/.claude.json Claude Code переносится туда как mcp_servers.
Как передать токен удалённому серверу?
Полем headers: Authorization: "Bearer ${TOKEN}", а сам токен положите в ~/.hermes/.env.
Как применить изменения без перезапуска?
Выполните /reload-mcp в чате. Запущенный hermes gateway сам замечает правки config.yaml примерно за минуту.
Подходят ли конфиги из Cursor и Claude?
Ключи command, args, env, url и headers совпадают, ссылки ${env:VAR} Hermes тоже понимает. Нужно сменить корневой ключ на mcp_servers и записать конфиг в YAML.

Источники: hermes-agent.nousresearch.com, hermes-agent.nousresearch.com, hermes-agent.nousresearch.com, hermes-agent.nousresearch.com, hermes-agent.nousresearch.com, github.com