Rulează Hermoso din orice client MCP

Serverul Hermoso este un server Model Context Protocol simplu, deci „ce client?” este mai ales o întrebare despre sintaxa configului, nu despre capabilitate. Există două căi de intrare, iar ambele ajung la aceleași 922+ unelte.

Cele două transporturi

• Găzduit, HTTP streamable: https://app.hermoso.ai/mcp. Acesta este cel pe care îl vor majoritatea clienților. Suportă OAuth cu înregistrare dinamică a clientului și PKCE, deci un client care vorbește fluxul complet de autorizare nu are nevoie de nicio cheie; un client care nu poate poate trimite în schimb un header Authorization: Bearer hmk_…. Ține cont că este doar HTTP streamable. Nu există endpoint HTTP+SSE vechi, deci un client care vorbește doar vechiul transport nu are aici la ce să se conecteze.
• stdio, prin npm: npx -y hermoso mcp, cu cheia ta în HERMOSO_TOKEN. Orice client MCP stdio îl poate încărca. Același pachet este și un CLI (npm install -g hermoso), care este calea ieftină în tokeni pentru agenții de terminal: apelează prin shell pentru fiecare comandă, în loc să care un manifest de peste 922+ unelte prin fiecare tur.

Agenții pot descoperi automat cardul serverului la /.well-known/mcp.json, iar serverul este listat în registrul oficial MCP ca io.github.hermoso-ai/hermoso.

Blocul generic de configurare

Majoritatea clienților acceptă o variantă a acestuia:

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

Creează cheia în Hermoso, la MCP & CLI → Terminal și chei API. Un client face excepție: Codex citește TOML, nu JSON, deci un bloc mcpServers copiat nu se va încărca acolo. Vezi pagina Codex pentru cele patru linii pe care le cere.

Clienți cu pagină proprie

• Claude: se conectează prin OAuth, nu trebuie lipit nimic.
• ChatGPT: se conectează prin OAuth, nu trebuie lipit nimic.
• Claude Code: se autentifică din terminal cu hermoso auth login, nu trebuie lipit nimic; fiind un agent de terminal, CLI-ul este calea mai ieftină pentru rulările lungi.
• Cursor: se autentifică din terminal cu hermoso auth login, nu trebuie lipit nimic.
• Codex: se autentifică din terminal cu hermoso auth login, nu trebuie lipit nimic; fiind un agent de terminal, CLI-ul este calea mai ieftină pentru rulările lungi.
• Cline: primește o cheie API într-un header Authorization.
• OpenClaw: se autentifică din terminal cu hermoso auth login, nu trebuie lipit nimic; fiind un agent de terminal, CLI-ul este calea mai ieftină pentru rulările lungi.
• Grok Bot: adaugă șablonul Hermoso Marketing Bot și primește o cheie API în chat, sau se autentifică din terminalul propriu al Bot-ului.
• Hermes: se autentifică din terminal cu hermoso auth login, nu trebuie lipit nimic; fiind un agent de terminal, CLI-ul este calea mai ieftină pentru rulările lungi.
• Gemini CLI: se autentifică din terminal cu hermoso auth login, nu trebuie lipit nimic; fiind un agent de terminal, CLI-ul este calea mai ieftină pentru rulările lungi.
• Perplexity: se conectează prin OAuth, nu trebuie lipit nimic.
• Le Chat: se conectează prin OAuth, nu trebuie lipit nimic.
• Claude Cowork: se conectează prin OAuth, nu trebuie lipit nimic.
• Perplexity Computer: se conectează prin OAuth, nu trebuie lipit nimic.
• Paperclip: se conectează prin OAuth, nu trebuie lipit nimic.
• Gemini: se conectează prin OAuth, nu trebuie lipit nimic.
• Grok Build: se autentifică din terminal cu hermoso auth login, nu trebuie lipit nimic; fiind un agent de terminal, CLI-ul este calea mai ieftină pentru rulările lungi.
• Kimi Code: adaugă URL-ul găzduit în mcp.json și autentifică-te cu /mcp-config login, nu trebuie lipit nimic; fiind un agent de terminal, CLI-ul este calea mai ieftină pentru rulările lungi.
• DeepSeek Harness: se autentifică din terminal cu hermoso auth login și rulează Hermoso ca server local, nu trebuie lipit nimic.
• Manus: primește o cheie API într-un header Authorization.
• Muse, configurat printr-un singur mesaj de chat care se conectează prin OAuth, nu trebuie lipit nimic.

Patru clienți nu au pagină proprie, deliberat, și merită spus de ce, în loc să sugerăm un suport mai larg decât am testat. VS Code: Hermoso publică un deeplink VS Code cu un click, dar nu există niciun bloc de instalare VS Code în produs și nicio cale testată, deci nicio pagină nu pretinde una. Deeplink-ul instalează endpointul simplu și lasă autentificarea în seama OAuth-ului VS Code. Claude Desktop: Claude Desktop folosește același flux Connectors ca claude.ai, deci este acoperit de pagina Claude și nu este duplicat. Grok: Grok chat se conectează azi prin cardul de configurare de pe /mcp; nu are încă pagină proprie, pentru că pagina per canal ar duplica paginile ChatGPT fără să adauge ceva ce doar noi putem spune. Muse: Meta Muse se configurează printr-un singur mesaj de chat, nu printr-un ecran de setări, deci ghidul său este scris manual la hermoso.ai/muse și nu generat aici.

Fiecare canal, din oricare dintre ele

Clientul nu schimbă ce este accesibil. Din oricare dintre ei: publici și programezi pe Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, Google Business Profile; cercetezi bibliotecile de reclame Meta, Google și LinkedIn, plus TikTok, Instagram, YouTube, Reddit și Threads organice; randezi reclame finalizate, imagine și video, pe peste 100 de modele; și construiești campanii pe Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads și AppLovin Ads.

O suprafață de publicare este construită și ținută în așteptare, până decide platforma. Reddit: postarea organică și statisticile postărilor sunt construite, dar Reddit Responsible Builder Policy cere aprobare scrisă explicită înainte ca o aplicație să folosească Data API, iar acea aprobare nu a fost acordată. Conectorul este ținut în așteptare, în loc să fie oferit ca un ecran OAuth care duce la un API mort. Reclamele Reddit sunt o altă conexiune și sunt live: arborele complet de campanii, prognoza, căutarea de direcționare, pixelii și formularele de lead.

Ce nu poate face niciun client singur

Un agent cu buget este util doar dacă raza de acțiune este mărginită, deci gardul este în server, nu într-un prompt. Fiecare campanie, grup de anunțuri, grup de reclame și reclamă este creată pe pauză, iar comutatoarele de stare care armează banii reali refuză să ruleze fără un indicator explicit de confirmare. Fiecare randare este cotată mai întâi (hermoso_capabilities publică costul exact în credite al fiecărui model înainte ca ceva să cheltuiască). Creditele sunt rezervate înainte de primul apel către furnizor și decontate la costul exact după aceea, astfel încât o trimitere eșuată se rambursează în loc să te lase taxat fără nimic. Ștergerile cer și ele confirmare, iar fiecare arbore de campanie este citit înapoi din platforma de reclame înainte ca agentul tău să-ți spună ce a construit.

Un pas rămâne intenționat al tău: conectarea fiecărui cont, o dată. Majoritatea canalelor se conectează prin ecranul de consimțământ OAuth al platformei, într-un browser; Bluesky cere o parolă de aplicație, iar Telegram un token de bot, lipite în Hermoso. Totul după aceea este un apel de unealtă.

Întrebări frecvente

Hermoso funcționează cu orice client MCP?

Prin stdio, da. Orice client care poate lansa npx -y hermoso mcp primește toate cele 922+ unelte. Prin endpointul găzduit este doar HTTP streamable: nu există o rută HTTP+SSE veche, deci un client care vorbește doar vechiul transport nu are de unde să se conecteze.

Am nevoie de o cheie API sau funcționează OAuth?

Ambele căi există. Endpointul găzduit suportă OAuth cu înregistrare dinamică a clientului și PKCE, așa cum se conectează Claude, ChatGPT, Perplexity, Le Chat, Claude Cowork, Perplexity Computer, Paperclip și Gemini, fără să lipească nimic. Clienții care pornesc un proces local se autentifică o dată cu hermoso auth login, iar un client care nu poate niciuna trimite o cheie API (hmk_…) într-un header Authorization: Bearer, creată în tabul MCP & CLI, la Terminal și chei API.

Care este URL-ul endpointului MCP?

https://app.hermoso.ai/mcp, declarat ca remote streamable-HTTP în cardul serverului de la /.well-known/mcp.json. Pachetul este hermoso pe npm și io.github.hermoso-ai/hermoso în registrul oficial MCP.