Hermoso'yu herhangi bir MCP istemcisinden çalıştırın

Hermoso'nun sunucusu düz bir Model Context Protocol sunucusudur; bu yüzden “hangi istemci?” sorusu çoğunlukla yetenekten çok yapılandırma sözdizimiyle ilgilidir. İki giriş yolu vardır ve ikisi de aynı 922+ araca ulaşır.

İki taşıma yöntemi

• Barındırılan, streamable HTTP: https://app.hermoso.ai/mcp. Çoğu istemcinin istediği budur. Dinamik istemci kaydı ve PKCE ile OAuth destekler; tam yetkilendirme akışını konuşan bir istemci hiç anahtar gerektirmez. Bunu yapamayan bir istemci bunun yerine Authorization: Bearer hmk_… başlığı gönderebilir. Dikkat: bu yalnızca streamable HTTP'dir. Eski HTTP+SSE uç noktası yoktur; yalnızca eski taşımayı konuşan bir istemcinin bağlanacak bir yeri olmaz.
• npm üzerinden stdio: npx -y hermoso mcp, anahtarınız HERMOSO_TOKEN içinde. Her stdio MCP istemcisi bunu yükleyebilir. Aynı paket bir CLI'dir de (npm install -g hermoso); terminal ajanları için token açısından ucuz yoldur: her turda 922+ araçlık bir manifest taşımak yerine her komutta ayrı ayrı komut çalıştırırlar.

Ajanlar sunucu kartını /.well-known/mcp.json adresinden otomatik keşfedebilir; sunucu resmi MCP kaydında io.github.hermoso-ai/hermoso adıyla listelenir.

Genel yapılandırma bloğu

Çoğu istemci bunun bir biçimini kabul eder:

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

Anahtarı Hermoso'da MCP & CLI → Terminal & API anahtarları altında oluşturun. Bir istemci gerçek bir istisnadır: Codex JSON değil TOML okur, bu yüzden kopyalanan bir mcpServers bloğu orada yüklenmez. Onun istediği dört satır için Codex sayfasına bakın.

Kendi sayfası olan istemciler

• Claude: OAuth ile bağlanır, yapıştırılacak bir şey yoktur.
• ChatGPT: OAuth ile bağlanır, yapıştırılacak bir şey yoktur.
• Claude Code: terminalden hermoso auth login ile oturum açar, yapıştırılacak bir şey yoktur; bir terminal ajanı olduğu için uzun işlerde CLI daha ucuz yoldur.
• Cursor: terminalden hermoso auth login ile oturum açar, yapıştırılacak bir şey yoktur.
• Codex: terminalden hermoso auth login ile oturum açar, yapıştırılacak bir şey yoktur; bir terminal ajanı olduğu için uzun işlerde CLI daha ucuz yoldur.
• Cline: bir Authorization başlığında API anahtarı alır.
• OpenClaw: terminalden hermoso auth login ile oturum açar, yapıştırılacak bir şey yoktur; bir terminal ajanı olduğu için uzun işlerde CLI daha ucuz yoldur.
• Grok Bot: Hermoso Marketing Bot şablonunu ekler ve API anahtarını sohbette alır ya da Bot'un kendi terminalinden oturum açar.
• Hermes: terminalden hermoso auth login ile oturum açar, yapıştırılacak bir şey yoktur; bir terminal ajanı olduğu için uzun işlerde CLI daha ucuz yoldur.
• Gemini CLI: terminalden hermoso auth login ile oturum açar, yapıştırılacak bir şey yoktur; bir terminal ajanı olduğu için uzun işlerde CLI daha ucuz yoldur.
• Perplexity: OAuth ile bağlanır, yapıştırılacak bir şey yoktur.
• Le Chat: OAuth ile bağlanır, yapıştırılacak bir şey yoktur.
• Claude Cowork: OAuth ile bağlanır, yapıştırılacak bir şey yoktur.
• Perplexity Computer: OAuth ile bağlanır, yapıştırılacak bir şey yoktur.
• Paperclip: OAuth ile bağlanır, yapıştırılacak bir şey yoktur.
• Gemini: OAuth ile bağlanır, yapıştırılacak bir şey yoktur.
• Grok Build: terminalden hermoso auth login ile oturum açar, yapıştırılacak bir şey yoktur; bir terminal ajanı olduğu için uzun işlerde CLI daha ucuz yoldur.
• Kimi Code: barındırılan URL'yi mcp.json dosyasına ekler ve /mcp-config login ile oturum açar, yapıştırılacak bir şey yoktur; bir terminal ajanı olduğu için uzun işlerde CLI daha ucuz yoldur.
• DeepSeek Harness: terminalden hermoso auth login ile oturum açar ve Hermoso'yu yerel bir sunucu olarak çalıştırır, yapıştırılacak bir şey yoktur.
• Manus: bir Authorization başlığında API anahtarı alır.
• Muse, OAuth ile bağlanan tek bir sohbet mesajıyla kurulur, yapıştırılacak bir şey yoktur.

Dört istemcinin kendi sayfası bilerek yoktur; bunun nedenini, test etmediğimiz bir desteği ima etmek yerine açıkça söylemek gerekir. VS Code: Hermoso tek tıkla açılan bir VS Code bağlantısı yayımlar, ama ürünün hiçbir yerinde bir VS Code kurulum bloğu ve test edilmiş bir yol yoktur; bu yüzden bunu iddia eden bir sayfa da yoktur. Bağlantı yalnızca temel uç noktayı kurar ve kimlik doğrulamayı VS Code'un kendi OAuth'una bırakır. Claude Desktop: Claude Desktop, claude.ai ile aynı Bağlayıcılar akışını kullanır; bu yüzden Claude sayfası onu kapsar, tekrar edilmez. Grok: Grok sohbeti bugün /mcp üzerindeki kurulum kartı üzerinden bağlanır; kendi sayfası henüz yoktur, çünkü kanal başına yazılan metin yalnızca bizim söyleyebileceğimiz bir şey eklemeden ChatGPT sayfalarını çoğaltırdı. Muse: Meta Muse bir ayarlar ekranı yerine tek bir sohbet mesajıyla kurulur; bu yüzden rehberi burada üretilmek yerine hermoso.ai/muse adresinde elle yazılmıştır.

Her kanal, hangisinden olursa olsun

İstemci, ulaşılabilir olanı değiştirmez. Hangisinden olursa olsun: Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram ve Google Business Profile üzerinde paylaşım yapıp planlayabilirsiniz; Meta, Google ve LinkedIn reklam kütüphanelerini ve organik TikTok, Instagram, YouTube, Reddit ve Threads'i araştırabilirsiniz; 100'den fazla modelle bitmiş görsel ve video reklamlar render edebilirsiniz; Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads ve AppLovin Ads üzerinde kampanyalar kurabilirsiniz.

Bir paylaşım yüzeyi kurulmuş ama platformun onayını bekleyerek tutulmaktadır: Reddit. Organik paylaşım ve paylaşım istatistikleri kuruldu, ama Reddit'in Sorumlu Geliştirici Politikası, bir uygulamanın Data API'yi kullanabilmesi için açık yazılı onay ister ve bu onay henüz verilmedi. Bağlayıcı, ölü bir API'ye çıkan bir OAuth ekranı olarak sunulmak yerine geri tutulmuştur. Reddit Ads ise ayrı bir bağlantıdır ve canlıdır: tam kampanya ağacı, tahmin, hedefleme araması, pikseller ve lead formları.

Hiçbir istemcinin tek başına yapamadığı şeyler

Bütçesi olan bir ajan, etki alanı sınırlı olduğunda işe yarar; bu yüzden sınır bir yönergede değil, sunucudadır. Her reklam kampanyası, reklam seti, reklam grubu ve reklam duraklatılmış olarak oluşturulur ve gerçek parayı açabilen durum anahtarları, açık bir onay bayrağı olmadan çalışmayı reddeder. Her render önce fiyatlandırılır (hermoso_capabilities, herhangi bir şey harcanmadan önce her modelin kesin kredi maliyetini yayınlar). Krediler ilk sağlayıcı çağrısından önce ayrılır, sonra kesin maliyetle kesinleştirilir; böylece başarısız bir gönderim, hiçbir karşılığı olmadan faturalanmak yerine iade edilir. Silme işlemleri de onay gerektirir ve her kampanya ağacı, ajanınız ne inşa ettiğini söylemeden önce reklam platformundan okunarak doğrulanır.

Bir adım bilerek sizin yapmanızdır: her hesabı bir kez bağlamak. Çoğu kanal, platformun kendi OAuth onay ekranı üzerinden bir tarayıcıda bağlanır; Bluesky bir uygulama parolası, Telegram ise bir bot belirteci alır ve bunlar Hermoso'ya yapıştırılır. Bundan sonrası her şey bir araç çağrısıdır.

Sık sorulan sorular

Hermoso herhangi bir MCP istemcisiyle çalışır mı?

stdio üzerinden, evet. npx -y hermoso mcp komutunu başlatabilen her istemci 922+ aracın tamamını alır. Barındırılan uç nokta üzerinden ise yalnızca streamable HTTP çalışır: eski bir HTTP+SSE yolu yoktur, bu yüzden yalnızca eski taşımayı konuşan bir istemcinin bağlanacağı bir yer olmaz.

API anahtarına mı ihtiyacım var, yoksa OAuth mu çalışır?

İki yol da vardır. Barındırılan uç nokta, dinamik istemci kaydı ve PKCE ile OAuth destekler; Claude, ChatGPT, Perplexity, Le Chat, Claude Cowork, Perplexity Computer, Paperclip ve Gemini bağlayıcıları, hiçbir şey yapıştırılmadan bu yolla oturum açar. Yerel bir işlem başlatan istemciler bunun yerine hermoso auth login ile bir kez oturum açar; ikisini de yapamayan bir istemci ise bir Authorization: Bearer başlığında bir API anahtarı (hmk_…) gönderir; bu anahtar MCP & CLI sekmesinde, Terminal & API anahtarları altında oluşturulur.

MCP uç nokta URL'si nedir?

https://app.hermoso.ai/mcp; /.well-known/mcp.json adresindeki sunucu kartında bir streamable-HTTP uzak sunucu olarak tanımlanır. Paket npm'de hermoso adıyla, resmi MCP kaydında ise io.github.hermoso-ai/hermoso adıyla yer alır.