Подключите Hermoso из любого MCP-клиента

Сервер Hermoso это обычный сервер Model Context Protocol, поэтому вопрос «какой клиент?» в основном касается синтаксиса конфигурации, а не возможностей. Есть два способа подключиться, и оба ведут к одним и тем же 922+ инструментам.

Два транспорта

• Размещённый, потоковый HTTP: https://app.hermoso.ai/mcp. Большинству клиентов нужен именно он. Он поддерживает OAuth с динамической регистрацией клиента и PKCE, так что клиент, который понимает полный поток авторизации, не требует вообще никакого ключа; клиент, который не понимает, может отправить заголовок Authorization: Bearer hmk_…. Обратите внимание: поддерживается только потоковый HTTP. Эндпоинта старого HTTP+SSE нет, так что клиент, который говорит только по старому транспорту, здесь подключиться не сможет.
• stdio, через npm: npx -y hermoso mcp, с вашим ключом в HERMOSO_TOKEN. Любой MCP-клиент с stdio может его загрузить. Тот же пакет работает и как CLI (npm install -g hermoso), это экономичный по токенам путь для терминальных агентов: они запускают команды в оболочке по одной, вместо того чтобы таскать манифест на 922+ инструмента через каждый ход.

Агенты могут автоматически находить карточку сервера по адресу /.well-known/mcp.json, а сам сервер внесён в официальный реестр MCP под именем io.github.hermoso-ai/hermoso.

Общий блок конфигурации

Большинство клиентов принимают какой-то вариант такого блока:

{ "mcpServers": { "hermoso": {
    "url": "https://app.hermoso.ai/mcp",
    "headers": { "Authorization": "Bearer <your key>" }
} } }

Создайте ключ в Hermoso в разделе MCP и CLI → Терминал и API-ключи. Одно исключение: Codex читает TOML, а не JSON, так что скопированный блок mcpServers там не загрузится. Для него см. страницу Codex, где указаны четыре нужные строки.

Клиенты со своей страницей

• Claude: подключается через OAuth, ничего вставлять не нужно.
• ChatGPT: подключается через OAuth, ничего вставлять не нужно.
• Claude Code: вход из терминала командой hermoso auth login, ничего вставлять не нужно; это терминальный агент, так что для долгих сессий дешевле CLI.
• Cursor: вход из терминала командой hermoso auth login, ничего вставлять не нужно.
• Codex: вход из терминала командой hermoso auth login, ничего вставлять не нужно; это терминальный агент, так что для долгих сессий дешевле CLI.
• Cline: принимает API-ключ в заголовке Authorization.
• OpenClaw: вход из терминала командой hermoso auth login, ничего вставлять не нужно; это терминальный агент, так что для долгих сессий дешевле CLI.
• Grok Bot: добавляет шаблон Hermoso Marketing Bot и принимает API-ключ в чате, либо вход из терминала самого Bot.
• Hermes: вход из терминала командой hermoso auth login, ничего вставлять не нужно; это терминальный агент, так что для долгих сессий дешевле CLI.
• Gemini CLI: вход из терминала командой hermoso auth login, ничего вставлять не нужно; это терминальный агент, так что для долгих сессий дешевле CLI.
• Perplexity: подключается через OAuth, ничего вставлять не нужно.
• Le Chat: подключается через OAuth, ничего вставлять не нужно.
• Claude Cowork: подключается через OAuth, ничего вставлять не нужно.
• Perplexity Computer: подключается через OAuth, ничего вставлять не нужно.
• Paperclip: подключается через OAuth, ничего вставлять не нужно.
• Gemini: подключается через OAuth, ничего вставлять не нужно.
• Grok Build: вход из терминала командой hermoso auth login, ничего вставлять не нужно; это терминальный агент, так что для долгих сессий дешевле CLI.
• Kimi Code: добавляет размещённый URL в mcp.json и входит командой /mcp-config login, ничего вставлять не нужно; это терминальный агент, так что для долгих сессий дешевле CLI.
• DeepSeek Harness: вход из терминала командой hermoso auth login и запуск Hermoso как локального сервера, ничего вставлять не нужно.
• Manus: принимает API-ключ в заголовке Authorization.
• Muse, настраивается одним сообщением в чате, которое подключается через OAuth, ничего вставлять не нужно.

У четырёх клиентов нет собственной страницы, и стоит объяснить почему, а не создавать впечатление более широкой поддержки, чем мы протестировали. VS Code: Hermoso публикует ссылку для установки в VS Code в один клик, но в продукте нет блока установки для VS Code и нет проверенного пути, поэтому страница ничего не обещает. Ссылка устанавливает голый эндпоинт, а аутентификацию оставляет OAuth самого VS Code. Claude Desktop: Claude Desktop использует тот же поток Connectors, что и claude.ai, поэтому он описан на странице Claude, а не продублирован. Grok: чат Grok подключается сегодня через карточку настройки на /mcp; собственной страницы у него пока нет, потому что её текст повторял бы страницы ChatGPT и не добавлял ничего, что можно сказать только о нём. Muse: Meta Muse настраивается одним сообщением в чате, а не на экране настроек, поэтому его руководство написано вручную на hermoso.ai/muse, а не генерируется здесь.

Все каналы из любого из них

Клиент не меняет того, что доступно. Из любого из них вы публикуете и планируете в Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, Google Business Profile; исследуете рекламные библиотеки Meta, Google и LinkedIn, а также органические TikTok, Instagram, YouTube, Reddit и Threads; рендерите готовые статичные и видеообъявления на более чем 100 моделях; и строите кампании в Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads и AppLovin Ads.

Одна поверхность публикации построена, но задержана по вине платформы: Reddit. Организационные публикации и статистика постов готовы, но Политика ответственного разработчика Reddit требует явного письменного одобрения, прежде чем приложение сможет использовать Data API, и это одобрение пока не получено. Коннектор задержан, а не предлагается как экран OAuth, ведущий к нерабочему API. Reddit Ads это другое подключение, и оно работает: полное дерево кампаний, прогнозирование, поиск таргетинга, пиксели и формы лидов.

Чего никакой клиент не может сделать сам

Агент с бюджетом полезен только тогда, когда радиус действия ограничен, поэтому защита находится на сервере, а не в промпте. Каждая рекламная кампания, группа объявлений, группа в Google Ads и объявление создаются на паузе, а переключатели статуса, которые запускают реальные деньги, отказываются работать без явного флага подтверждения. Каждый рендер заранее оценивается (hermoso_capabilities публикует точную стоимость каждой модели до того, как что-либо будет списано). Кредиты резервируются до первого вызова провайдера и списываются по точной стоимости после, так что неудачный запуск возвращает деньги, а не оставляет вас с оплатой за ничего. Удаление тоже требует подтверждения, и каждое рекламное дерево кампаний перечитывается с рекламной платформы до того, как ваш агент расскажет, что он построил.

Один шаг намеренно остаётся за вами: подключение каждого аккаунта один раз. Большинство каналов подключаются через экран согласия OAuth платформы в браузере; Bluesky принимает пароль приложения, а Telegram токен бота, которые вставляются в Hermoso. Всё после этого это вызов инструмента.

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

Работает ли Hermoso с любым MCP-клиентом?

Через stdio да: любой клиент, который может запустить npx -y hermoso mcp, получает все 922+ инструмента. Через размещённый эндпоинт поддерживается только потоковый HTTP: эндпоинта старого HTTP+SSE нет, так что клиент, который говорит только по старому транспорту, не может подключиться.

Нужен ли API-ключ или работает OAuth?

Оба пути существуют. Размещённый эндпоинт поддерживает OAuth с динамической регистрацией клиента и PKCE; так подключаются Claude, ChatGPT, Perplexity, Le Chat, Claude Cowork, Perplexity Computer, Paperclip и Gemini, и ничего вставлять не нужно. Клиенты, которые запускают локальный процесс, входят один раз командой hermoso auth login. Клиент, который не умеет ни того, ни другого, отправляет API-ключ (hmk_…) в заголовке Authorization: Bearer; ключ создаётся на вкладке MCP и CLI, в разделе Терминал и API-ключи.

Какой URL у MCP-эндпоинта?

https://app.hermoso.ai/mcp, объявлен как удалённый потоковый HTTP-сервер в карточке сервера по адресу /.well-known/mcp.json. Пакет называется hermoso на npm, а в официальном реестре MCP это io.github.hermoso-ai/hermoso.