Uruchom Hermoso z dowolnego klienta MCP

Serwer Hermoso to zwykły serwer Model Context Protocol, więc pytanie „który klient?” dotyczy głównie składni konfiguracji, a nie możliwości. Są dwa sposoby wejścia i oba prowadzą do tych samych ponad 922 narzędzi.

Dwa transporty

• Hostowany, strumieniowe HTTP: https://app.hermoso.ai/mcp. Tego chce większość klientów. Obsługuje OAuth z dynamiczną rejestracją klienta i PKCE, więc klient, który zna pełny przepływ autoryzacji, nie potrzebuje żadnego klucza; klient, który go nie zna, może zamiast tego wysłać nagłówek Authorization: Bearer hmk_…. Uwaga: to wyłącznie strumieniowe HTTP. Nie ma starego punktu HTTP+SSE, więc klient mówiący tylko starym transportem nie ma tu do czego się połączyć.
• stdio, przez npm: npx -y hermoso mcp, z twoim kluczem w HERMOSO_TOKEN. Każdy klient MCP działający przez stdio może to załadować. Ten sam pakiet to też CLI (npm install -g hermoso), czyli ścieżka oszczędna w tokenach dla agentów terminalowych: wywołują polecenia z powłoki zamiast nosić manifest z ponad 922 narzędziami przez każdą turę.

Agenci mogą automatycznie wykryć kartę serwera pod /.well-known/mcp.json, a serwer jest wpisany do oficjalnego rejestru MCP jako io.github.hermoso-ai/hermoso.

Ogólny blok konfiguracji

Większość klientów przyjmuje jedną z odmian tego zapisu:

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

Utwórz klucz w Hermoso w MCP & CLI → Terminal & API keys. Jeden klient to wyjątek: Codex czyta TOML, nie JSON, więc skopiowany blok mcpServers się tam nie załaduje. Cztery wiersze, których on potrzebuje, znajdziesz na stronie Codex.

Klienci z własną stroną

• Claude: łączy się przez OAuth, nic nie trzeba wklejać.
• ChatGPT: łączy się przez OAuth, nic nie trzeba wklejać.
• Claude Code: loguje się z terminala poleceniem hermoso auth login, nic nie trzeba wklejać; to agent terminalowy, więc na długie zadania lepsze jest CLI.
• Cursor: loguje się z terminala poleceniem hermoso auth login, nic nie trzeba wklejać.
• Codex: loguje się z terminala poleceniem hermoso auth login, nic nie trzeba wklejać; to agent terminalowy, więc na długie zadania lepsze jest CLI.
• Cline: przyjmuje klucz API w nagłówku Authorization.
• OpenClaw: loguje się z terminala poleceniem hermoso auth login, nic nie trzeba wklejać; to agent terminalowy, więc na długie zadania lepsze jest CLI.
• Grok Bot: dodaje szablon Hermoso Marketing Bot i przyjmuje klucz API w czacie albo loguje się z terminala samego Bota.
• Hermes: loguje się z terminala poleceniem hermoso auth login, nic nie trzeba wklejać; to agent terminalowy, więc na długie zadania lepsze jest CLI.
• Gemini CLI: loguje się z terminala poleceniem hermoso auth login, nic nie trzeba wklejać; to agent terminalowy, więc na długie zadania lepsze jest CLI.
• Perplexity: łączy się przez OAuth, nic nie trzeba wklejać.
• Le Chat: łączy się przez OAuth, nic nie trzeba wklejać.
• Claude Cowork: łączy się przez OAuth, nic nie trzeba wklejać.
• Perplexity Computer: łączy się przez OAuth, nic nie trzeba wklejać.
• Paperclip: łączy się przez OAuth, nic nie trzeba wklejać.
• Gemini: łączy się przez OAuth, nic nie trzeba wklejać.
• Grok Build: loguje się z terminala poleceniem hermoso auth login, nic nie trzeba wklejać; to agent terminalowy, więc na długie zadania lepsze jest CLI.
• Kimi Code: dodaje adres hostowany do mcp.json i loguje się poleceniem /mcp-config login, nic nie trzeba wklejać; to agent terminalowy, więc na długie zadania lepsze jest CLI.
• DeepSeek Harness: loguje się z terminala poleceniem hermoso auth login i uruchamia Hermoso jako lokalny serwer, nic nie trzeba wklejać.
• Manus: przyjmuje klucz API w nagłówku Authorization.
• Muse, konfigurowany jedną wiadomością na czacie, która łączy się przez OAuth, nic nie trzeba wklejać.

Cztery kluczowe klienty celowo nie mają własnej strony i warto powiedzieć dlaczego, zamiast sugerować szersze wsparcie, niż faktycznie przetestowaliśmy. VS Code: Hermoso publikuje jednoklikowy link deeplink do VS Code, ale nigdzie w produkcie nie ma bloku instalacji dla VS Code ani przetestowanej ścieżki, więc nie ma strony, która by ją obiecywała. Deeplink instaluje sam goły adres i zostawia uwierzytelnienie OAuth VS Code. Claude Desktop: Claude Desktop używa tego samego przepływu Konektorów co claude.ai, więc jest objęty stroną Claude i nie jest powielany. Grok: czat Grok łączy się dziś przez kartę konfiguracji na /mcp; nie ma własnej strony, bo jej treść dla kanału powieliłaby strony ChatGPT, a nie dodałaby nic, czego możemy powiedzieć tylko my. Muse: Meta Muse konfiguruje się jedną wiadomością na czacie, a nie w ekranie ustawień, więc jego przewodnik jest napisany ręcznie pod adresem hermoso.ai/muse, a nie generowany tutaj.

Każdy kanał z każdego z nich

Klient nie zmienia tego, co jest osiągalne. Z dowolnego z nich: publikuj i planuj na Facebooku, Instagramie, Threads, TikToku, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegramie, Google Business Profile; badaj biblioteki reklam Meta, Google i LinkedIn oraz organiczne TikTok, Instagram, YouTube, Reddit i Threads; renderuj gotowe reklamy graficzne i wideo w ponad 100 modelach; buduj kampanie w Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads i AppLovin Ads.

Jedna powierzchnia publikacji jest zbudowana i wstrzymana, czekając na platformę: Reddit. Publikowanie organiczne i statystyki postów są zbudowane, ale Responsible Builder Policy Reddita wymaga pisemnej zgody przed użyciem Data API przez aplikację, a ta zgoda nie została przyznana. Konektor jest wstrzymany, zamiast oferować ekran OAuth prowadzący do martwego API. Reddit Ads to osobne połączenie i jest już aktywne: pełne drzewo kampanii, prognozowanie, wyszukiwanie targetowania, piksele i formularze leadów.

Czego żaden klient nie zrobi sam

Agent z budżetem jest użyteczny tylko wtedy, gdy zakres jego działania jest ograniczony, dlatego zabezpieczenie jest w serwerze, a nie w prompcie. Każda kampania reklamowa, zestaw reklam, grupa reklam i reklama jest tworzona wstrzymana, a przełączniki statusu, które uruchamiają prawdziwe pieniądze, odmawiają działania bez jawnej flagi potwierdzenia. Każdy render jest najpierw wyceniany (hermoso_capabilities publikuje dokładny koszt w kredytach każdego modelu, zanim cokolwiek zostanie wydane). Kredyty są rezerwowane przed pierwszym wywołaniem dostawcy i rozliczane po dokładnym koszcie, więc nieudane wysłanie zwraca kredyty zamiast zostawiać cię obciążonym za nic. Usuwanie też wymaga potwierdzenia, a każde drzewo kampanii jest odczytywane z platformy reklamowej, zanim agent powie ci, co zbudował.

Jeden krok zostaje celowo po twojej stronie: połączenie każdego konta, raz. Większość kanałów łączy się przez własny ekran zgody OAuth platformy w przeglądarce; Bluesky przyjmuje hasło do aplikacji, a Telegram token bota, wklejane w Hermoso. Wszystko po tym to wywołanie narzędzia.

Często zadawane pytania

Czy Hermoso działa z każdym klientem MCP?

Przez stdio tak. Każdy klient, który potrafi uruchomić npx -y hermoso mcp, dostaje wszystkie ponad 922 narzędzia. Przez hostowany punkt końcowy działa wyłącznie strumieniowe HTTP: nie ma starej trasy HTTP+SSE, więc klient mówiący tylko starym transportem nie ma do czego się połączyć.

Czy potrzebuję klucza API, czy wystarczy OAuth?

Istnieją obie ścieżki. Hostowany punkt końcowy obsługuje OAuth z dynamiczną rejestracją klienta i PKCE, tak logują się konektory Claude, ChatGPT, Perplexity, Le Chat, Claude Cowork, Perplexity Computer, Paperclip i Gemini, bez wklejania czegokolwiek. Klienty, które uruchamiają lokalny proces, logują się raz poleceniem hermoso auth login, a klient, który nie potrafi żadnej z tych rzeczy, wysyła klucz API (hmk_…) w nagłówku Authorization: Bearer, utworzony na zakładce MCP & CLI, w sekcji Terminal & API keys.

Jaki jest adres punktu końcowego MCP?

https://app.hermoso.ai/mcp, zadeklarowany jako zdalny serwer strumieniowego HTTP w karcie serwera pod /.well-known/mcp.json. Pakiet to hermoso w npm, a io.github.hermoso-ai/hermoso w oficjalnym rejestrze MCP.