A Hermoso futtatása bármely MCP-kliensből

A Hermoso szervere sima Model Context Protocol szerver, így a „melyik kliens?” kérdés nagyrészt konfigurációs szintaxis kérdése, nem képességé. Két út van, és mindkettő ugyanahhoz a 922+ eszközhöz vezet.

A két átviteli mód

• Hosztolt, streamable HTTP: https://app.hermoso.ai/mcp. Ezt kéri a legtöbb kliens. Támogatja az OAuth-t dinamikus kliensregisztrációval és PKCE-vel, így az a kliens, amely a teljes engedélyezési folyamatot beszéli, egyáltalán nem igényel kulcsot; amelyik nem, az helyette egy Authorization: Bearer hmk_… fejlécet küldhet. Vedd figyelembe, hogy ez csak streamable HTTP. Nincs régi HTTP+SSE végpont, így az a kliens, amely csak a régi átvitelt beszéli, nem tud csatlakozni.
• stdio, npm-en keresztül: npx -y hermoso mcp, a kulcsodat a HERMOSO_TOKEN-ben tartva. Bármely stdio MCP-kliens be tudja tölteni. Ugyanez a csomag CLI-ként is működik (npm install -g hermoso), ez a tokentakarékos út a terminálos ügynököknek: parancsonként hívnak alfolyamatot, ahelyett hogy minden körben egy 922+ eszközös manifesztet cipelnének.

Az ügynökök a /.well-known/mcp.json útvonalon automatikusan megtalálják a szerverkártyát, a szerver pedig szerepel a hivatalos MCP-regiszterben io.github.hermoso-ai/hermoso néven.

Az általános konfigurációs blokk

A legtöbb kliens ennek valamelyik változatát fogadja el:

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

A kulcsot a Hermoso-ban hozd létre a MCP és CLI → Terminal & API keys alatt. Egy kliens kivétel: a Codex TOML-t olvas, nem JSON-t, így a bemásolt mcpServers blokk ott nem töltődik be. Lásd a Codex oldalt a négy sorért, amit ott kér.

Saját oldallal rendelkező kliensek

• Claude: OAuth-tal csatlakozik, nincs mit beilleszteni.
• ChatGPT: OAuth-tal csatlakozik, nincs mit beilleszteni.
• Claude Code: a terminálból, a hermoso auth login paranccsal jelentkezik be, nincs mit beilleszteni; terminálos ügynök, ezért hosszú futásokhoz a CLI az olcsóbb út.
• Cursor: a terminálból, a hermoso auth login paranccsal jelentkezik be, nincs mit beilleszteni.
• Codex: a terminálból, a hermoso auth login paranccsal jelentkezik be, nincs mit beilleszteni; terminálos ügynök, ezért hosszú futásokhoz a CLI az olcsóbb út.
• Cline: API-kulcsot fogad egy Authorization fejlécben.
• OpenClaw: a terminálból, a hermoso auth login paranccsal jelentkezik be, nincs mit beilleszteni; terminálos ügynök, ezért hosszú futásokhoz a CLI az olcsóbb út.
• Grok Bot: hozzáadja a Hermoso Marketing Bot sablont, és API-kulcsot fogad a csevegésben, vagy a Bot saját terminálján jelentkezik be.
• Hermes: a terminálból, a hermoso auth login paranccsal jelentkezik be, nincs mit beilleszteni; terminálos ügynök, ezért hosszú futásokhoz a CLI az olcsóbb út.
• Gemini CLI: a terminálból, a hermoso auth login paranccsal jelentkezik be, nincs mit beilleszteni; terminálos ügynök, ezért hosszú futásokhoz a CLI az olcsóbb út.
• Perplexity: OAuth-tal csatlakozik, nincs mit beilleszteni.
• Le Chat: OAuth-tal csatlakozik, nincs mit beilleszteni.
• Claude Cowork: OAuth-tal csatlakozik, nincs mit beilleszteni.
• Perplexity Computer: OAuth-tal csatlakozik, nincs mit beilleszteni.
• Paperclip: OAuth-tal csatlakozik, nincs mit beilleszteni.
• Gemini: OAuth-tal csatlakozik, nincs mit beilleszteni.
• Grok Build: a terminálból, a hermoso auth login paranccsal jelentkezik be, nincs mit beilleszteni; terminálos ügynök, ezért hosszú futásokhoz a CLI az olcsóbb út.
• Kimi Code: hozzáadja a hosztolt URL-t az mcp.json fájlhoz, és a /mcp-config login paranccsal jelentkezik be, nincs mit beilleszteni; terminálos ügynök, ezért hosszú futásokhoz a CLI az olcsóbb út.
• DeepSeek Harness: a terminálból, a hermoso auth login paranccsal jelentkezik be, és helyi szerverként futtatja a Hermoso-t, nincs mit beilleszteni.
• Manus: API-kulcsot fogad egy Authorization fejlécben.
• Muse, egyetlen csevegőüzenettel állítható be, OAuth-tal csatlakozik, nincs mit beilleszteni.

Négy kliensnek nincs saját oldala, és érdemes megindokolni, miért, nem pedig nagyobb támogatottságot sugallni annál, amit teszteltünk. VS Code: a Hermoso közzétesz egy egykattintásos VS Code deeplinket, de a termékben sehol nincs VS Code-telepítő blokk, és nincs tesztelt út, ezért nincs olyan oldal, amely állítana egyet. A deeplink a csupasz végpontot telepíti, a hitelesítést pedig a VS Code saját OAuth-ja intézi. Claude Desktop: a Claude Desktop ugyanazt a Connectors-folyamatot használja, mint a claude.ai, ezért a Claude oldal fedi, nem duplikáljuk. Grok: a Grok chat most a /mcp oldal beállítókártyáján keresztül csatlakozik; saját oldala még nincs, mert az csatornánkénti szövege megismételné a ChatGPT-oldalakat, nem adna hozzá olyat, amit csak mi tudnánk elmondani. Muse: a Meta Muse-t egy csevegőüzenet állítja be, nem egy beállítási képernyő, ezért útmutatóját kézzel írtuk meg a hermoso.ai/muse oldalon, nem generáltuk ide.

Minden csatorna, bármelyikből

A kliens nem változtatja meg, mi érhető el. Bármelyikből: közzététel és ütemezés a Facebookra, az Instagramra, a Threads-re, a TikTokra, a YouTube-ra, az X-re, a LinkedIn-re, a Pinterestre, a Blueskyra, a Telegramra, a Google Business Profile-ra; a Meta, a Google és a LinkedIn hirdetési könyvtáraiban való kutatás, plusz az organikus TikTok, Instagram, YouTube, Reddit és Threads; kész képi és videós hirdetések renderelése több mint 100 modellel; és kampányok építése a Meta, a Google Ads, a Microsoft Advertising, a Reddit Ads, a LinkedIn, a Pinterest, az X Ads, a TikTok Ads, a Snapchat Ads, a ChatGPT Ads, az Apple Search Ads és az AppLovin Ads platformokon.

Egy közzétételi felület épült meg, de visszatartjuk a platformra várva: a Reddit esetében a szervezett posztolás és a poszt-statisztikák készen állnak, de a Reddit Responsible Builder Policy-ja kifejezett, írásbeli jóváhagyást kér, mielőtt egy alkalmazás használhatná a Data API-t, és ez a jóváhagyás még nem érkezett meg. A csatlakozó visszatartott, nem egy OAuth-képernyőként kínáljuk, amely egy halott API-hoz vezet. A Reddit Ads más kapcsolat, és az él: a teljes kampányfa, az előrejelzés, a célzáskeresés, a pixelek és a lead formok.

Amit egyik kliens sem tud egyedül

Egy költségkerettel rendelkező ügynök csak akkor hasznos, ha a kockázata korlátos, ezért a zár a szerveren van, nem egy utasításban. Minden hirdetéskampány, hirdetéskészlet, hirdetéscsoport és hirdetés szüneteltetve jön létre, a pénzt mozgató kapcsolók pedig megerősítő jelzés nélkül nem futnak le. Minden renderelést előre árazunk (a hermoso_capabilities minden modell pontos kreditköltségét közzéteszi, mielőtt bármi költene). A krediteket az első szolgáltatóhívás előtt foglaljuk le, és utána a pontos költség szerint számoljuk el, így egy meghiúsult indítás visszatérít, nem hagy számlázva semmiért. A törlések is megerősítéshez kötöttek, és minden kampányfát az ügynök azelőtt olvas vissza a hirdetési platformról, hogy megmondaná, mit épített.

Egy lépés szándékosan a tiéd: minden fiók egyszeri összekapcsolása. A legtöbb csatorna a platform saját OAuth-hozzájárulási képernyőjén keresztül kapcsolódik egy böngészőben; a Bluesky alkalmazásjelszót, a Telegram pedig bot-tokent kér, amelyeket a Hermoso-ba illesztesz. Minden más egy eszközhívás.

Gyakori kérdések

Működik a Hermoso bármely MCP-kliensben?

Stdio-n igen: bármely kliens, amely el tudja indítani az npx -y hermoso mcp parancsot, mind a 922+ eszközt megkapja. A hosztolt végponton csak streamable HTTP működik: nincs régi HTTP+SSE útvonal, így a csak a régi átvitelt beszélő kliens nem tud csatlakozni.

Kell API-kulcs, vagy működik az OAuth?

Mindkét út létezik. A hosztolt végpont támogatja az OAuth-t dinamikus kliensregisztrációval és PKCE-vel; így csatlakoznak a Claude, a ChatGPT, a Perplexity, a Le Chat, a Claude Cowork, a Perplexity Computer, a Paperclip és a Gemini kapcsolói, beillesztés nélkül. A helyi folyamatot indító kliensek egyszer a hermoso auth login paranccsal jelentkeznek be; amelyik egyik módon sem tud, az API-kulcsot (hmk_…) küldi egy Authorization: Bearer fejlécben, amelyet az MCP és CLI fülön, a Terminal & API keys alatt hozol létre.

Mi az MCP-végpont URL-je?

https://app.hermoso.ai/mcp, a /.well-known/mcp.json szerverkártyában streamable-HTTP távoli szerverként deklarálva. A csomag neve hermoso az npm-en, az io.github.hermoso-ai/hermoso pedig a hivatalos MCP-regiszterben.