Käytä Hermosoa mistä tahansa MCP-asiakkaasta

Hermosoen palvelin on tavallinen Model Context Protocol -palvelin, joten “mikä asiakas?” on enimmäkseen kysymys asetussyntaksista eikä kyvykkyydestä. Sisäänkäyntejä on kaksi, ja molemmat tavoittavat saman 922+ työkalun joukon.

Kaksi siirtotapaa

• Isännöity, suoratoisto HTTP:n yli: https://app.hermoso.ai/mcp. Tätä useimmat asiakkaat haluavat. Se tukee OAuthia dynaamisella asiakasrekisteröinnillä ja PKCE:llä, joten asiakas, joka puhuu koko valtuutusvirtaa, ei tarvitse avainta lainkaan. Asiakas, joka ei puhu sitä, voi lähettää sen sijaan otsikon Authorization: Bearer hmk_…. Huomaa, että tämä on vain suoratoisto HTTP. Vanhaa HTTP+SSE-päätepistettä ei ole, joten asiakas, joka puhuu vain vanhaa siirtotapaa, ei löydä täältä mitään, mihin yhdistää.
• stdio, npm:n kautta: npx -y hermoso mcp, avaimesi ollessa muuttujassa HERMOSO_TOKEN. Mikä tahansa stdio-MCP-asiakas voi ladata sen. Sama paketti on myös CLI (npm install -g hermoso), ja se on terminaaliagenteille edullinen tapa: ne ajavat komennon kerrallaan sen sijaan, että kantaisivat 922+ työkalun manifestia mukanaan jokaisessa vuorossa.

Agentit löytävät palvelinkortin automaattisesti osoitteesta /.well-known/mcp.json, ja palvelin on listattu virallisessa MCP-rekisterissä nimellä io.github.hermoso-ai/hermoso.

Yleinen asetuslohko

Useimmat asiakkaat hyväksyvät jonkin muunnelman tästä:

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

Luo avain Hermosossa kohdassa MCP & CLI → Pääte ja API-avaimet. Yksi asiakas on todellinen poikkeus: Codex lukee TOML-muotoa, ei JSONia, joten kopioitu mcpServers-lohko ei lataudu siellä. Katso Codex-sivu, jossa on sen neljä riviä.

Asiakkaat, joilla on oma sivu

• Claude: yhdistyy OAuthilla, mitään ei tarvitse liittää.
• ChatGPT: yhdistyy OAuthilla, mitään ei tarvitse liittää.
• Claude Code: kirjautuu terminaalista komennolla hermoso auth login, mitään ei tarvitse liittää; terminaaliagentti, joten pitkissä ajoissa CLI on edullisempi polku.
• Cursor: kirjautuu terminaalista komennolla hermoso auth login, mitään ei tarvitse liittää.
• Codex: kirjautuu terminaalista komennolla hermoso auth login, mitään ei tarvitse liittää; terminaaliagentti, joten pitkissä ajoissa CLI on edullisempi polku.
• Cline: ottaa API-avaimen Authorization-otsikossa.
• OpenClaw: kirjautuu terminaalista komennolla hermoso auth login, mitään ei tarvitse liittää; terminaaliagentti, joten pitkissä ajoissa CLI on edullisempi polku.
• Grok Bot: lisää Hermoso Marketing Bot -mallipohjan ja ottaa API-avaimen chatissa, tai kirjautuu Botin omasta terminaalista.
• Hermes: kirjautuu terminaalista komennolla hermoso auth login, mitään ei tarvitse liittää; terminaaliagentti, joten pitkissä ajoissa CLI on edullisempi polku.
• Gemini CLI: kirjautuu terminaalista komennolla hermoso auth login, mitään ei tarvitse liittää; terminaaliagentti, joten pitkissä ajoissa CLI on edullisempi polku.
• Perplexity: yhdistyy OAuthilla, mitään ei tarvitse liittää.
• Le Chat: yhdistyy OAuthilla, mitään ei tarvitse liittää.
• Claude Cowork: yhdistyy OAuthilla, mitään ei tarvitse liittää.
• Perplexity Computer: yhdistyy OAuthilla, mitään ei tarvitse liittää.
• Paperclip: yhdistyy OAuthilla, mitään ei tarvitse liittää.
• Gemini: yhdistyy OAuthilla, mitään ei tarvitse liittää.
• Grok Build: kirjautuu terminaalista komennolla hermoso auth login, mitään ei tarvitse liittää; terminaaliagentti, joten pitkissä ajoissa CLI on edullisempi polku.
• Kimi Code: lisää isännöidyn URL-osoitteen mcp.json-tiedostoon ja kirjautuu komennolla /mcp-config login, mitään ei tarvitse liittää; terminaaliagentti, joten pitkissä ajoissa CLI on edullisempi polku.
• DeepSeek Harness: kirjautuu terminaalista komennolla hermoso auth login ja ajaa Hermosoa paikallisena palvelimena, mitään ei tarvitse liittää.
• Manus: ottaa API-avaimen Authorization-otsikossa.
• Muse, asetetaan yhdellä chat-viestillä, joka yhdistyy OAuthilla, mitään ei tarvitse liittää.

Neljällä asiakkaalla ei ole omaa sivua tarkoituksella, ja on syytä sanoa miksi sen sijaan, että viittaisimme laajempaan tukeen kuin mitä olemme testanneet. VS Code: Hermoso julkaisee yhden napsautuksen VS Code -linkin, mutta tuotteessa ei ole missään VS Coden asennuslohkoa eikä testattua polkua, joten sivua ei ole, joka väittäisi sellaista. Linkki asentaa pelkän päätepisteen ja jättää todennuksen VS Coden omalle OAuthille. Claude Desktop: Claude Desktop käyttää täsmälleen samaa Liittimet-virtaa kuin claude.ai, joten sitä käsittelee Claude-sivu eikä sitä ole kopioitu. Grok: Grok-chat yhdistyy tällä hetkellä MCP-sivun asetuskortin kautta; sillä ei ole vielä omaa sivua, koska kanavakohtainen teksti toistaisi ChatGPT-sivut eikä lisäisi mitään, mitä vain me voisimme sanoa. Muse: Meta Musen asetus tehdään yhdellä chat-viestillä eikä asetusnäkymässä, joten sen opas on kirjoitettu käsin osoitteessa hermoso.ai/muse eikä generoitu täällä.

Jokainen kanava, mistä tahansa niistä

Asiakas ei muuta sitä, mihin pääset käsiksi. Mistä tahansa niistä voit julkaista ja ajastaa Facebookiin, Instagramiin, Threadsiin, TikTokiin, YouTubeen, X:ään, LinkedIniin, Pinterestiin, Blueskyyn, Telegramiin ja Google Business Profileen. Voit tutkia Metan, Googlen ja LinkedInin mainoskirjastoja sekä orgaanisesti TikTokia, Instagramia, YouTubea, Redditiä ja Threadsia. Voit renderöidä valmiita kuva- ja videomainoksia yli sadalla mallilla ja rakentaa kampanjoita Metassa, Google Adsissa, Microsoft Advertisingissa, Reddit Adsissa, LinkedInissä, Pinterestissä, X Adsissa, TikTok Adsissa, Snapchat Adsissa, ChatGPT Adsissa, Apple Search Adsissa ja AppLovin Adsissa.

Yksi julkaisupinta on rakennettu, mutta pidetty pois, odottamassa alustan päätöstä: Reddit. Orgaaninen julkaisu ja julkaisutilastot on rakennettu, mutta Redditin Responsible Builder Policy vaatii nimenomaisen kirjallisen luvan ennen kuin sovellus saa käyttää Data API:a, eikä sitä lupaa ole myönnetty. Liitin on pidetty pois käytöstä sen sijaan, että tarjottaisiin OAuth-näyttö, joka johtaisi kuolleeseen rajapintaan. Reddit Ads on eri yhteys, ja se on käytössä: koko kampanjapuu, ennustaminen, kohdistushaku, pikselit ja lomakkeet.

Mitä mikään asiakas ei voi tehdä yksin

Agentilla, jolla on budjetti, on hyötyä vain, jos sen vaikutusala on rajattu. Siksi aita on palvelimessa eikä kehotteessa. Jokainen mainoskampanja, mainosryhmä ja mainos luodaan pysäytettynä, ja tilanvaihdot, jotka käynnistävät oikeaa rahaa, eivät toimi ilman nimenomaista vahvistuslippua. Jokaiselle renderöinnille tehdään tarjous ensin (hermoso_capabilities kertoo jokaisen mallin tarkan krediittihinnan ennen kuin mitään kuluu). Krediitit varataan ennen ensimmäistä palveludarin kutsua ja maksetaan lopulta tarkalla hinnalla, joten epäonnistunut käynnistys hyvitetään eikä jätä sinua laskutettavaksi turhasta. Poistot vaativat vahvistuksen, ja jokainen kampanjapuu luetaan takaisin mainosalustalta ennen kuin agenttisi kertoo, mitä se rakensi.

Yksi vaihe on tarkoituksella sinun: yhdistä jokainen tili kerran. Useimmat kanavat yhdistyvät alustan oman OAuth-suostumusnäytön kautta selaimessa. Bluesky ottaa sovellussalasanan ja Telegram botin tunnuksen, jotka liitetään Hermosoon. Kaikki sen jälkeen on työkalukutsu.

Usein kysytyt kysymykset

Toimiiko Hermoso minkä tahansa MCP-asiakkaan kanssa?

Stdio-yhteydellä kyllä. Mikä tahansa asiakas, joka pystyy käynnistämään komennon npx -y hermoso mcp, saa kaikki 922+ työkalua. Isännöidyn päätepisteen kautta yhteys on vain suoratoisto HTTP: vanhaa HTTP+SSE-reittiä ei ole, joten asiakas, joka puhuu vain vanhaa siirtotapaa, ei voi yhdistää.

Tarvitsenko API-avaimen vai riittääkö OAuth?

Molemmat ovat olemassa. Isännöity päätepiste tukee OAuthia dynaamisella asiakasrekisteröinnillä ja PKCE:llä, ja niin Claude-, ChatGPT-, Perplexity-, Le Chat-, Claude Cowork-, Perplexity Computer-, Paperclip- ja Gemini-liittimet kirjautuvat sisään ilman mitään liitettävää. Paikallisen prosessin käynnistävät asiakkaat kirjautuvat kerran komennolla hermoso auth login. Asiakas, joka ei osaa kumpaakaan, lähettää API-avaimen (hmk_…) Authorization: Bearer -otsikossa. Avaimen luot MCP & CLI -välilehdellä kohdassa Pääte ja API-avaimet.

Mikä on MCP-päätepisteen URL-osoite?

https://app.hermoso.ai/mcp, ilmoitettuna suoratoistoetäpalvelimena palvelinkortissa osoitteessa /.well-known/mcp.json. Paketti on nimeltään hermoso npm:ssä ja io.github.hermoso-ai/hermoso virallisessa MCP-rekisterissä.