Jalankan Hermoso dari mana-mana klien MCP

Pelayan Hermoso ialah pelayan Model Context Protocol yang biasa, jadi “klien yang mana?” sebahagian besarnya soal sintaks konfigurasi dan bukan keupayaan. Ada dua cara masuk dan kedua-duanya mencapai 922+ alat yang sama.

Dua pengangkutan

• Hos, HTTP strim: https://app.hermoso.ai/mcp. Ini yang paling diingini oleh kebanyakan klien. Ia menyokong OAuth dengan pendaftaran klien dinamik dan PKCE, jadi klien yang menyokong aliran kebenaran penuh tidak memerlukan kunci langsung; klien yang tidak boleh berbuat begitu boleh menghantar header Authorization: Bearer hmk_… sebagai gantinya. Perhatikan ia HTTP strim sahaja. Tiada titik akhir HTTP+SSE lama, jadi klien yang hanya bertutur pengangkutan lama tidak mempunyai apa-apa untuk disambungkan di sini.
• stdio, melalui npm: npx -y hermoso mcp, dengan kunci anda dalam HERMOSO_TOKEN. Mana-mana klien MCP stdio boleh memuatkannya. Pakej yang sama juga ialah CLI (npm install -g hermoso), iaitu laluan yang murah dari segi token untuk ejen terminal: mereka memanggil shell bagi setiap arahan dan bukan membawa manifes 922+ alat melalui setiap giliran.

Ejen boleh menemui pelayan secara automatik melalui kad pelayan di /.well-known/mcp.json, dan ia disenaraikan dalam pendaftaran MCP rasmi sebagai io.github.hermoso-ai/hermoso.

Blok konfigurasi generik

Kebanyakan klien menerima beberapa ejaan blok ini:

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

Cipta kunci dalam Hermoso di bawah MCP & CLI → Terminal & Kunci API. Satu klien ialah pengecualian sebenar: Codex membaca TOML, bukan JSON, jadi blok mcpServers yang disalin tidak akan dimuatkan di sana. Lihat halaman Codex untuk empat baris yang dikehendakinya.

Klien yang mempunyai halaman sendiri

• Claude: sambung dengan OAuth, tiada apa untuk ditampal.
• ChatGPT: sambung dengan OAuth, tiada apa untuk ditampal.
• Claude Code: log masuk dari terminal dengan hermoso auth login, tiada apa untuk ditampal; ejen terminal, jadi CLI ialah laluan yang lebih murah untuk larian panjang.
• Cursor: log masuk dari terminal dengan hermoso auth login, tiada apa untuk ditampal.
• Codex: log masuk dari terminal dengan hermoso auth login, tiada apa untuk ditampal; ejen terminal, jadi CLI ialah laluan yang lebih murah untuk larian panjang.
• Cline: mengambil kunci API dalam header Authorization.
• OpenClaw: log masuk dari terminal dengan hermoso auth login, tiada apa untuk ditampal; ejen terminal, jadi CLI ialah laluan yang lebih murah untuk larian panjang.
• Grok Bot: menambah templat Hermoso Marketing Bot dan mengambil kunci API dalam sembang, atau log masuk dari terminal Bot itu sendiri.
• Hermes: log masuk dari terminal dengan hermoso auth login, tiada apa untuk ditampal; ejen terminal, jadi CLI ialah laluan yang lebih murah untuk larian panjang.
• Gemini CLI: log masuk dari terminal dengan hermoso auth login, tiada apa untuk ditampal; ejen terminal, jadi CLI ialah laluan yang lebih murah untuk larian panjang.
• Perplexity: sambung dengan OAuth, tiada apa untuk ditampal.
• Le Chat: sambung dengan OAuth, tiada apa untuk ditampal.
• Claude Cowork: sambung dengan OAuth, tiada apa untuk ditampal.
• Perplexity Computer: sambung dengan OAuth, tiada apa untuk ditampal.
• Paperclip: sambung dengan OAuth, tiada apa untuk ditampal.
• Gemini: sambung dengan OAuth, tiada apa untuk ditampal.
• Grok Build: log masuk dari terminal dengan hermoso auth login, tiada apa untuk ditampal; ejen terminal, jadi CLI ialah laluan yang lebih murah untuk larian panjang.
• Kimi Code: menambah URL hos ke mcp.json dan log masuk dengan /mcp-config login, tiada apa untuk ditampal; ejen terminal, jadi CLI ialah laluan yang lebih murah untuk larian panjang.
• DeepSeek Harness: log masuk dari terminal dengan hermoso auth login dan menjalankan Hermoso sebagai pelayan tempatan, tiada apa untuk ditampal.
• Manus: mengambil kunci API dalam header Authorization.
• Muse, disediakan dengan satu mesej sembang yang menyambung dengan OAuth, tiada apa untuk ditampal.

Empat klien sengaja tidak mempunyai halaman sendiri, dan wajar menjelaskan sebabnya daripada memberi gambaran sokongan yang lebih luas daripada yang telah kami uji. VS Code: Hermoso menerbitkan pautan deep satu klik untuk VS Code, tetapi tiada blok pemasangan VS Code di mana-mana dalam produk dan tiada laluan yang diuji, jadi tiada halaman yang mendakwa ada satu. Pautan deep memasang titik akhir kosong dan membiarkan pengesahan kepada OAuth VS Code sendiri. Claude Desktop: Claude Desktop menggunakan aliran Connectors yang sama dengan claude.ai, jadi ia dilindungi oleh halaman Claude dan tidak diduplikasi. Grok: sembang Grok menyambung hari ini melalui kad persediaan di /mcp; ia belum mempunyai halaman sendiri kerana salinan setiap salurannya akan menduplikasi halaman ChatGPT dan bukan menambah apa-apa yang hanya kami boleh katakan. Muse: Meta Muse disediakan dengan satu mesej sembang dan bukan skrin tetapan, jadi panduannya ditulis dengan tangan di hermoso.ai/muse dan bukan dijana di sini.

Setiap saluran, dari mana-mana daripadanya

Klien tidak mengubah apa yang boleh dicapai. Dari mana-mana daripadanya: terbit dan jadualkan ke Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, Google Business Profile; kaji perpustakaan iklan Meta, Google dan LinkedIn serta TikTok, Instagram, YouTube, Reddit dan Threads organik; render iklan imej dan video siap merentas 100+ model; dan bina kempen 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 penerbitan dibina tetapi ditahan, menunggu platform: Reddit: penerbitan organik dan statistik siaran sudah dibina, tetapi Polisi Pembina Bertanggungjawab Reddit memerlukan kelulusan bertulis yang jelas sebelum sesuatu apl boleh menggunakan Data API, dan tiket itu belum diluluskan. Sambungan itu ditahan dan bukannya ditawarkan sebagai skrin OAuth yang membawa ke API yang mati. Reddit Ads ialah sambungan yang berbeza dan ia hidup: pokok kempen penuh, ramalan, carian sasaran, piksel dan borang prospek.

Apa yang tiada klien boleh buat sendiri

Ejen dengan bajet hanya berguna jika skop tindakannya terhad, jadi pagarnya berada dalam pelayan dan bukan dalam arahan. Setiap kempen iklan, set iklan, kumpulan iklan dan iklan dicipta dijeda, dan suis status yang mengaktifkan wang sebenar enggan dijalankan tanpa bendera pengesahan yang jelas. Setiap render dinilai dahulu (hermoso_capabilities menerbitkan kos kredit tepat setiap model sebelum apa-apa dibelanjakan). Kredit ditempah sebelum panggilan pembekal pertama dan diselesaikan pada kos tepat selepas itu, jadi penghantaran yang gagal dikembalikan dan bukannya meninggalkan anda dicaj untuk tiada apa-apa. Pemadaman juga memerlukan pengesahan, dan setiap pokok kempen dibaca semula daripada platform iklan sebelum ejen anda memberitahu anda apa yang dibinanya.

Satu langkah yang sengaja milik anda: menyambungkan setiap akaun, sekali. Kebanyakan saluran menyambung melalui skrin persetujuan OAuth platform itu sendiri dalam pelayar; Bluesky mengambil kata laluan apl dan Telegram token bot, ditampal dalam Hermoso. Selepas itu, semuanya ialah panggilan alat.

Soalan lazim

Adakah Hermoso berfungsi dengan mana-mana klien MCP?

Melalui stdio, ya. Mana-mana klien yang boleh melancarkan npx -y hermoso mcp mendapat semua 922+ alat. Melalui titik akhir hos, ia HTTP strim sahaja: tiada laluan HTTP+SSE lama, jadi klien yang hanya bertutur pengangkutan lama tidak mempunyai apa-apa untuk disambungkan.

Adakah saya perlukan kunci API, atau OAuth berfungsi?

Kedua-dua laluan wujud. Titik akhir hos menyokong OAuth dengan pendaftaran klien dinamik dan PKCE, yang digunakan oleh penyambung Claude, ChatGPT, Perplexity, Le Chat, Claude Cowork, Perplexity Computer, Paperclip dan Gemini untuk log masuk tanpa menampal apa-apa. Klien yang memulakan proses tempatan log masuk sekali dengan hermoso auth login, dan klien yang tidak boleh kedua-duanya menghantar kunci API (hmk_…) dalam header Authorization: Bearer, dicipta pada tab MCP & CLI, di bawah Terminal & Kunci API.

Apakah URL titik akhir MCP?

https://app.hermoso.ai/mcp, diisytiharkan sebagai jauh HTTP strim dalam kad pelayan di /.well-known/mcp.json. Pakejnya ialah hermoso di npm dan io.github.hermoso-ai/hermoso dalam pendaftaran MCP rasmi.