Запуск Hermoso з будь-якого MCP-клієнта

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

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

• Хмарний, streamable HTTP: https://app.hermoso.ai/mcp. Саме його найчастіше потребують клієнти. Він підтримує OAuth з динамічною реєстрацією клієнта та PKCE, тож клієнту, який знає повний потік авторизації, ключ не потрібен; клієнт, який не знає, може надіслати заголовок Authorization: Bearer hmk_…. Зауважте, що це лише streamable 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: додає хмарну адресу до 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. Органічні публікації та статистика дописів збудовані, але Responsible Builder Policy від Reddit вимагає явного письмового схвалення, перш ніж застосунок використає Data API, а такого дозволу ще не отримано. Коннектор утримується, а не пропонується як екран OAuth, що веде до неробочого API. Reddit Ads це інше підключення, і воно працює: повне дерево кампаній, прогнозування, пошук таргетингу, пікселі та форми лідів.

Чого жоден клієнт не зробить сам

Агент із бюджетом корисний лише тоді, коли радіус дії обмежений, тож огорожа стоїть на сервері, а не в промпті. Кожна рекламна кампанія, група оголошень, група реклами та оголошення створюються на паузі, а перемикачі статусу, що вмикають реальні гроші, не працюють без явного прапорця підтвердження. Кожен рендер спершу котирується (hermoso_capabilities публікує точну вартість кожної моделі до будь-яких витрат). Кредити резервуються до першого виклику провайдера і списуються за точною вартістю після, тож невдала відправка повертає кошти, а не залишає вас оплачувати нічого. Видалення теж потребують підтвердження, а кожне дерево кампаній читається назад з рекламної платформи, перш ніж ваш агент розповість, що побудував.

Один крок залишається за вами: прив'язати кожен акаунт один раз. Більшість каналів прив'язується через власний екран згоди OAuth платформи в браузері; Bluesky приймає пароль застосунку, а Telegram токен бота, які вставляються в Hermoso. Усе після цього це виклик інструмента.

Поширені запитання

Чи працює Hermoso з будь-яким MCP-клієнтом?

Через stdio так. Будь-який клієнт, який може запустити npx -y hermoso mcp, отримує всі 922+ інструменти. Через хмарну кінцеву точку це лише streamable 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, оголошена як віддалений streamable-HTTP у серверній картці за адресою /.well-known/mcp.json. Пакет називається hermoso на npm, а io.github.hermoso-ai/hermoso в офіційному реєстрі MCP.