Spusťte Hermoso z libovolného klienta MCP

Server Hermoso je běžný server Model Context Protocol, takže otázka „který klient?“ je většinou otázkou syntaxe konfigurace, ne schopností. Vede sem dvě cesty a obě zpřístupní stejných více než 922 nástrojů.

Dva přenosové kanály

• Hostovaný, streamovaný HTTP: https://app.hermoso.ai/mcp. Tohle chce většina klientů. Podporuje OAuth s dynamickou registrací klienta a PKCE, takže klient, který zvládne celý autorizační tok, nepotřebuje vůbec žádný klíč; klient, který to nezvládne, může místo toho poslat hlavičku Authorization: Bearer hmk_…. Pozor, je to pouze streamovaný HTTP. Neexistuje žádný starý endpoint HTTP+SSE, takže klient, který umí jen starý přenos, se tu nemá k čemu připojit.
• stdio, přes npm: npx -y hermoso mcp, s vaším klíčem v HERMOSO_TOKEN. Každý klient MCP přes stdio ho může načíst. Stejný balíček je i CLI (npm install -g hermoso), což je úsporná cesta pro terminálové agenty: spouštějí příkazy jeden po druhém místo toho, aby s každým krokem nesli manifest s více než 922 nástroji.

Agenti mohou serverovou kartu automaticky najít na /.well-known/mcp.json a server je uveden v oficiálním registru MCP jako io.github.hermoso-ai/hermoso.

Obecný blok konfigurace

Většina klientů přijímá nějakou podobu tohoto zápisu:

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

Klíč vytvořte v Hermoso v části MCP a CLI → Terminal & API keys. Jeden klient je skutečná výjimka: Codex čte TOML, ne JSON, takže zkopírovaný blok mcpServers se tam nenačte. Čtyři řádky, které chce, najdete na stránce Codex.

Klienti s vlastní stránkou

• Claude: připojí se přes OAuth, nic se nevkládá.
• ChatGPT: připojí se přes OAuth, nic se nevkládá.
• Claude Code: přihlásí se z terminálu příkazem hermoso auth login, nic se nevkládá; je to terminálový agent, takže pro dlouhé běhy je levnější cesta CLI.
• Cursor: přihlásí se z terminálu příkazem hermoso auth login, nic se nevkládá.
• Codex: přihlásí se z terminálu příkazem hermoso auth login, nic se nevkládá; je to terminálový agent, takže pro dlouhé běhy je levnější cesta CLI.
• Cline: přijímá API klíč v hlavičce Authorization.
• OpenClaw: přihlásí se z terminálu příkazem hermoso auth login, nic se nevkládá; je to terminálový agent, takže pro dlouhé běhy je levnější cesta CLI.
• Grok Bot: přidá šablonu Hermoso Marketing Bot a přijme API klíč v chatu, nebo se přihlásí z terminálu samotného Bota.
• Hermes: přihlásí se z terminálu příkazem hermoso auth login, nic se nevkládá; je to terminálový agent, takže pro dlouhé běhy je levnější cesta CLI.
• Gemini CLI: přihlásí se z terminálu příkazem hermoso auth login, nic se nevkládá; je to terminálový agent, takže pro dlouhé běhy je levnější cesta CLI.
• Perplexity: připojí se přes OAuth, nic se nevkládá.
• Le Chat: připojí se přes OAuth, nic se nevkládá.
• Claude Cowork: připojí se přes OAuth, nic se nevkládá.
• Perplexity Computer: připojí se přes OAuth, nic se nevkládá.
• Paperclip: připojí se přes OAuth, nic se nevkládá.
• Gemini: připojí se přes OAuth, nic se nevkládá.
• Grok Build: přihlásí se z terminálu příkazem hermoso auth login, nic se nevkládá; je to terminálový agent, takže pro dlouhé běhy je levnější cesta CLI.
• Kimi Code: přidá hostovanou URL do mcp.json a přihlásí se příkazem /mcp-config login, nic se nevkládá; je to terminálový agent, takže pro dlouhé běhy je levnější cesta CLI.
• DeepSeek Harness: přihlásí se z terminálu příkazem hermoso auth login a spustí Hermoso jako místní server, nic se nevkládá.
• Manus: přijímá API klíč v hlavičce Authorization.
• Muse, nastavený jednou zprávou v chatu, která se připojí přes OAuth, nic se nevkládá.

Čtyři klienti záměrně nemají vlastní stránku a stojí za to vysvětlit proč, místo abychom naznačovali širší podporu, než jsme otestovali. VS Code: Hermoso zveřejňuje odkaz pro instalaci do VS Code jedním kliknutím, ale v produktu nikde není blok pro instalaci do VS Code a netestovaná cesta neexistuje, takže neexistuje ani stránka, která by ji tvrdila. Odkaz nainstaluje holý endpoint a ověření nechá na OAuth samotného VS Code. Claude Desktop: Claude Desktop používá stejný tok Connectors jako claude.ai, takže ho pokrývá stránka Claude a nedubluje se. Grok: chat Grok se dnes připojuje přes kartu s nastavením na stránce /mcp; vlastní stránku zatím nemá, protože její kopie pro jednotlivé kanály by jen duplikovala stránky ChatGPT a nepřidala nic, co bychom řekli jen my. Muse: Meta Muse se nastavuje jednou zprávou v chatu, ne na obrazovce nastavení, takže jeho průvodce je napsán ručně na adrese hermoso.ai/muse a nevzniká zde automaticky.

Každý kanál, z kteréhokoli z nich

Klient nemění, čeho lze dosáhnout. Z kteréhokoli z nich můžete publikovat a plánovat na Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, Google Business Profile; zkoumat knihovny reklam Meta, Google a LinkedIn spolu s organickým TikTokem, Instagramem, YouTube, Redditem a Threads; renderovat hotové obrázkové a video reklamy napříč více než 100 modely; a sestavovat kampaně na Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads a AppLovin Ads.

Jeden publikační povrch je hotový a držený zpátky, dokud to dovolí platforma: Reddit. Organické příspěvky a statistiky příspěvků jsou hotové, ale Reddit ve svých zásadách Responsible Builder vyžaduje výslovný písemný souhlas dřív, než aplikace může použít Data API, a tento souhlas zatím nebyl udělen. Konektor je proto držen zpět a nenabízí se jako obrazovka OAuth vedoucí k mrtvému API. Reddit Ads je jiné připojení a je živé: celý strom kampaní, prognózy, vyhledávání cílení, pixely a formuláře pro leady.

Co žádný klient nedokáže sám

Agent s rozpočtem je užitečný jen tehdy, když je dopad omezený, takže ohrazení je na serveru, ne v promptu. Každá reklamní kampaň, sada reklam, skupina reklam a reklama se vytvoří pozastavená a přepínače stavu, které zapínají skutečné peníze, se bez výslovného potvrzovacího příznaku nespustí. Každý render se nejdřív nacení (hermoso_capabilities zveřejní přesnou cenu v kreditech u každého modelu dřív, než cokoli utratí). Kredity se rezervují před prvním voláním poskytovatele a poté se vyúčtují přesnou cenou, takže neúspěšné odeslání se vrátí zpět a nezůstane vám účtováno nic. Mazání je také chráněné potvrzením a každý strom kampaně se přečte zpět z reklamní platformy, než váš agent řekne, co vytvořil.

Jeden krok je záměrně váš: propojení každého účtu, jednou. Většina kanálů se propojuje přes obrazovku souhlasu OAuth dané platformy v prohlížeči; Bluesky přijímá heslo k aplikaci a Telegram token bota, vložené do Hermoso. Vše ostatní je už volání nástroje.

Často kladené otázky

Funguje Hermoso s libovolným klientem MCP?

Přes stdio ano. Každý klient, který umí spustit npx -y hermoso mcp, získá všech více než 922 nástrojů. Přes hostovaný endpoint je to pouze streamovaný HTTP: neexistuje žádná stará trasa HTTP+SSE, takže klient, který umí jen starý přenos, se nemá k čemu připojit.

Potřebuji API klíč, nebo funguje OAuth?

Existují obě cesty. Hostovaný endpoint podporuje OAuth s dynamickou registrací klienta a PKCE, a tak se konektory Claude, ChatGPT, Perplexity, Le Chat, Claude Cowork, Perplexity Computer, Paperclip a Gemini přihlašují, aniž by se cokoli vkládalo. Klienti, kteří spouštějí místní proces, se přihlásí jednou příkazem hermoso auth login. Klient, který neumí ani jedno, pošle API klíč (hmk_…) v hlavičce Authorization: Bearer, vytvořený na kartě MCP a CLI v části Terminal & API keys.

Jaká je URL endpointu MCP?

https://app.hermoso.ai/mcp, uvedená jako vzdálený endpoint se streamovaným HTTP v serverové kartě na /.well-known/mcp.json. Balíček je hermoso na npm a io.github.hermoso-ai/hermoso v oficiálním registru MCP.