Jalankan Hermoso dari klien MCP apa pun

Server Hermoso adalah server Model Context Protocol biasa, jadi pertanyaan “klien yang mana?” sebagian besar soal sintaks konfigurasi, bukan kemampuan. Ada dua jalan masuk dan keduanya menjangkau 922+ alat yang sama.

Dua transport

• Hosted, streamable HTTP: https://app.hermoso.ai/mcp. Ini yang paling sering dibutuhkan klien. Mendukung OAuth dengan registrasi klien dinamis dan PKCE, sehingga klien yang memahami alur otorisasi lengkap tidak memerlukan kunci sama sekali; klien yang tidak bisa dapat mengirim header Authorization: Bearer hmk_… sebagai gantinya. Perlu dicatat, ini hanya streamable HTTP. Tidak ada endpoint HTTP+SSE lama, jadi klien yang hanya memakai transport lama tidak punya apa pun untuk dihubungkan di sini.
• stdio, lewat npm: npx -y hermoso mcp, dengan kunci Anda di HERMOSO_TOKEN. Klien MCP stdio mana pun bisa memuatnya. Paket yang sama juga berupa CLI (npm install -g hermoso), jalur hemat token untuk agen terminal: mereka menjalankan perintah satu per satu alih-alih membawa manifest 922+ alat di setiap giliran.

Agen bisa menemukan server secara otomatis lewat kartu server di /.well-known/mcp.json, dan server ini terdaftar di registry MCP resmi sebagai io.github.hermoso-ai/hermoso.

Blok konfigurasi generik

Sebagian besar klien menerima salah satu ejaan dari bentuk ini:

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

Buat kunci di Hermoso di bawah MCP & CLI → Terminal & API key. Ada satu klien yang benar-benar pengecualian: Codex membaca TOML, bukan JSON, sehingga blok mcpServers yang disalin tidak akan dimuat di sana. Lihat halaman Codex untuk empat baris yang dibutuhkannya.

Klien yang punya halaman sendiri

• Claude: terhubung dengan OAuth, tidak ada yang perlu ditempel.
• ChatGPT: terhubung dengan OAuth, tidak ada yang perlu ditempel.
• Claude Code: masuk dari terminal dengan hermoso auth login, tidak ada yang perlu ditempel; agen terminal, jadi CLI adalah jalur yang lebih murah untuk proses panjang.
• Cursor: masuk dari terminal dengan hermoso auth login, tidak ada yang perlu ditempel.
• Codex: masuk dari terminal dengan hermoso auth login, tidak ada yang perlu ditempel; agen terminal, jadi CLI adalah jalur yang lebih murah untuk proses panjang.
• Cline: menerima kunci API di header Authorization.
• OpenClaw: masuk dari terminal dengan hermoso auth login, tidak ada yang perlu ditempel; agen terminal, jadi CLI adalah jalur yang lebih murah untuk proses panjang.
• Grok Bot: menambahkan templat Hermoso Marketing Bot dan menerima kunci API di chat, atau masuk dari terminal milik Bot itu sendiri.
• Hermes: masuk dari terminal dengan hermoso auth login, tidak ada yang perlu ditempel; agen terminal, jadi CLI adalah jalur yang lebih murah untuk proses panjang.
• Gemini CLI: masuk dari terminal dengan hermoso auth login, tidak ada yang perlu ditempel; agen terminal, jadi CLI adalah jalur yang lebih murah untuk proses panjang.
• Perplexity: terhubung dengan OAuth, tidak ada yang perlu ditempel.
• Le Chat: terhubung dengan OAuth, tidak ada yang perlu ditempel.
• Claude Cowork: terhubung dengan OAuth, tidak ada yang perlu ditempel.
• Perplexity Computer: terhubung dengan OAuth, tidak ada yang perlu ditempel.
• Paperclip: terhubung dengan OAuth, tidak ada yang perlu ditempel.
• Gemini: terhubung dengan OAuth, tidak ada yang perlu ditempel.
• Grok Build: masuk dari terminal dengan hermoso auth login, tidak ada yang perlu ditempel; agen terminal, jadi CLI adalah jalur yang lebih murah untuk proses panjang.
• Kimi Code: menambahkan URL yang di-host ke mcp.json dan masuk dengan /mcp-config login, tidak ada yang perlu ditempel; agen terminal, jadi CLI adalah jalur yang lebih murah untuk proses panjang.
• DeepSeek Harness: masuk dari terminal dengan hermoso auth login dan menjalankan Hermoso sebagai server lokal, tidak ada yang perlu ditempel.
• Manus: menerima kunci API di header Authorization.
• Muse, diatur lewat satu pesan chat yang terhubung dengan OAuth, tidak ada yang perlu ditempel.

Empat klien sengaja tidak punya halaman sendiri, dan layak dijelaskan alasannya daripada memberi kesan dukungan yang lebih luas daripada yang sudah kami uji. VS Code: Hermoso menerbitkan deeplink VS Code satu klik, tetapi tidak ada blok pemasangan VS Code di mana pun dalam produk dan tidak ada jalur yang sudah diuji, jadi tidak ada halaman yang mengklaimnya. Deeplink hanya memasang endpoint polos dan menyerahkan autentikasi ke OAuth VS Code sendiri. Claude Desktop: Claude Desktop memakai alur Connectors yang sama dengan claude.ai, jadi sudah dicakup oleh halaman Claude alih-alih digandakan. Grok: chat Grok terhubung hari ini lewat kartu pengaturan di /mcp; ia belum punya halaman sendiri karena salinan per kanalnya hanya akan menggandakan halaman ChatGPT tanpa menambah hal yang hanya bisa kami katakan. Muse: Meta Muse diatur lewat satu pesan chat, bukan layar pengaturan, jadi panduannya ditulis tangan di hermoso.ai/muse dan tidak dibuat di sini.

Setiap saluran, dari klien mana pun

Klien tidak mengubah apa yang bisa dijangkau. Dari klien mana pun: publikasi dan jadwalkan ke Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, Google Business Profile; riset perpustakaan iklan Meta, Google, dan LinkedIn ditambah TikTok, Instagram, YouTube, Reddit, dan Threads organik; render iklan gambar dan video jadi di atas 100+ model; dan bangun kampanye di Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads, dan AppLovin Ads.

Satu permukaan publikasi sudah dibangun tetapi ditahan, menunggu platform: Reddit: posting organik dan statistik posting sudah dibangun, tetapi Responsible Builder Policy Reddit mewajibkan persetujuan tertulis eksplisit sebelum aplikasi boleh memakai Data API, dan tiket itu belum disetujui. Konektornya ditahan, bukan ditawarkan sebagai layar OAuth yang mengarah ke API yang mati. Reddit Ads adalah koneksi yang berbeda dan sudah aktif: seluruh pohon kampanye, peramalan, pencarian targeting, pixel, dan lead form.

Yang tidak bisa dilakukan klien mana pun sendirian

Agen dengan anggaran hanya berguna jika dampaknya terbatas, jadi pagarnya ada di server, bukan di prompt. Setiap kampanye iklan, ad set, ad group, dan iklan dibuat dalam keadaan dijeda, dan sakelar status yang menyalakan uang sungguhan menolak berjalan tanpa flag konfirmasi eksplisit. Setiap render diberi harga lebih dulu (hermoso_capabilities menampilkan biaya kredit pasti setiap model sebelum apa pun dibelanjakan). Kredit dipesan sebelum panggilan penyedia pertama dan diselesaikan pada biaya pasti setelahnya, sehingga pengiriman yang gagal dikembalikan, bukan membuat Anda ditagih tanpa hasil. Penghapusan juga memerlukan konfirmasi, dan setiap pohon kampanye dibaca ulang dari platform iklan sebelum agen Anda memberi tahu apa yang sudah dibangun.

Satu langkah sengaja menjadi tanggung jawab Anda: menautkan setiap akun, sekali. Sebagian besar saluran tertaut lewat layar persetujuan OAuth platform itu sendiri di browser; Bluesky memakai kata sandi aplikasi dan Telegram memakai token bot, yang ditempel di Hermoso. Semua setelah itu adalah panggilan alat.

Pertanyaan yang sering diajukan

Apakah Hermoso bekerja dengan klien MCP apa pun?

Lewat stdio, ya. Klien mana pun yang bisa menjalankan npx -y hermoso mcp mendapat seluruh 922+ alat. Lewat endpoint yang di-host, hanya streamable HTTP: tidak ada rute HTTP+SSE lama, jadi klien yang hanya memakai transport lama tidak punya apa pun untuk dihubungkan.

Apakah saya memerlukan kunci API, atau OAuth saja sudah cukup?

Keduanya tersedia. Endpoint yang di-host mendukung OAuth dengan registrasi klien dinamis dan PKCE, yaitu cara konektor Claude, ChatGPT, Perplexity, Le Chat, Claude Cowork, Perplexity Computer, Paperclip, dan Gemini masuk tanpa ada yang ditempel. Klien yang memulai proses lokal masuk sekali dengan hermoso auth login, dan klien yang tidak bisa keduanya mengirim kunci API (hmk_…) di header Authorization: Bearer, yang dibuat di tab MCP & CLI, di bawah Terminal & API key.

Apa URL endpoint MCP?

https://app.hermoso.ai/mcp, dideklarasikan sebagai remote streamable-HTTP di kartu server di /.well-known/mcp.json. Paketnya bernama hermoso di npm dan io.github.hermoso-ai/hermoso di registry MCP resmi.