Cherry Studio'nun “設定” bölümünde birçok kişinin aradığı iki şey vardır: kendi API anahtarınızla model kullanmanızı sağlayan sağlayıcı ayarları ve harici araçları bağlayan MCP sunucusu ayarları. İlki 設定 → モデルプロバイダー → プロバイダーを追加, ikincisi ise 設定 → MCP サーバー yoluyla yapılır. Bu sayfa, 30 Eylül 2026'da yayımlanan v2.1.4 sürümünü temel alır ve her iki işlemi de ekrandaki Japonca ifadeleri aynen kullanarak açıklar. v2'de sağlayıcı ekleme ekranı büyük ölçüde değiştiğinden, v1 dönemindeki “タイプ：OpenAI” seçimini anlatan açıklamalar artık ekranla uyuşmamaktadır.
Kapsam, CherryHQ/cherry-studio masaüstü sürümüdür (AGPL-3.0, Windows, macOS ve Linux). 1 Ekim 2026 itibarıyla depo arşivlenmemiştir ve en yeni sürüm v2.1.4'tür. App Store'daki aynı adlı uygulama başka bir geliştiriciye ait, ilgisiz bir uygulamadır; dikkat edin. Arayüzü Japonca yapmak için ayarlardaki dil bölümünden Japonca'yı seçin (arayüz Japonca dahil 13 dili destekler).
Sağlayıcı ayarları: Kendi API anahtarınızla model kullanma
İşlemin genel görünümü aşağıdadır. Etiketler v2.1.4'ün Japonca arayüzündeki ifadelerdir.
設定 → モデルプロバイダー → プロバイダーを追加
（ダイアログ名：カスタムプロバイダーを追加）
プロバイダー名 Kunavo
APIキー sk-kn-...
エンドポイント設定
OpenAI https://api.kunavo.com/v1
Anthropic メッセージ https://api.kunavo.com
その他のオプション
OpenAI レスポンス https://api.kunavo.com/v1 （任意）
画像生成ベースURL https://api.kunavo.com/v1 （任意）
Google Gemini 空欄のまま
→ 保存 → モデル一覧で「モデルを同期」→ 使うモデルを追加 → 「チェック」- Ayarlar → Model sağlayıcıları bölümünü açın ve Sağlayıcı ekle düğmesine basın. Açılan iletişim kutusunun başlığı “Özel sağlayıcı ekle”dir. Coding Plan türü hizmetler, birden fazla hesap veya projeleri ayırma gibi durumlarda mevcut bir sağlayıcıyı temel almak isterseniz üst kısımdaki “Ön ayardan başla (isteğe bağlı)” seçeneğini de kullanabilirsiniz.
- Sağlayıcı adı ve API anahtarı alanlarını doldurun.
- Uç nokta ayarları bölümünde başlangıçta OpenAI ve Anthropic Mesajları olmak üzere 2 alan bulunur. En az 1 metin uç noktası zorunludur. Her ikisini de doldurursanız yalnızca sohbette değil, Agent ve Anthropic biçimini kullanan özelliklerde de model seçebilirsiniz.
- Diğer seçenekler bölümünü açtığınızda OpenAI yanıtları, Google Gemini, görsel oluşturma temel URL'si ve görsel düzenleme temel URL'si alanları görünür. Kullanmadığınız alanları boş bırakabilirsiniz.
- Kaydettikten sonra sağlayıcı ekranında etkin olup olmadığını kontrol edin. Resmî belgelere göre yapılandırılmış olsa bile devre dışı bırakılmış bir sağlayıcının modelleri seçimlerde görünmez. “Anahtar çalışmıyor” sorununun en yaygın nedeni budur.
- Model listesindeki Modelleri senkronize et seçeneğiyle modelleri alın, kullanacaklarınızı ekleyin ve Kontrol et ile birini doğrulayın.
Adres yazımı: yalnızca kök adresi girin
v2.1.4 kaynak kodunda, her alana girilen kök adreste sürüm bölümü yoksa /v1 eklenir (zaten varsa eklenmez), ardından alana göre yol eklenir. Her alanın altında nihai URL “İstek yolu” olarak gösterilir; bu nedenle kaydetmeden önce burayı kontrol etmek kesin sonuç verir.
| Alan | Cherry Studio'nun eklediği yol | Kunavo |
|---|---|---|
| OpenAI | /chat/completions | Destekleniyor |
| Anthropic Mesajları | /messages | Destekleniyor |
| OpenAI Yanıtları (Diğer seçenekler) | /responses | Destekleniyor |
| Görsel oluşturma temel URL'si (Diğer seçenekler) | /images/generations | Destekleniyor |
| Görsel düzenleme temel URL'si (Diğer seçenekler) | /images/edits | Destekleniyor |
| Google Gemini (Diğer seçenekler) | /models/{model}:generateContent | Desteklenmiyor — boş bırakın |
Yapılmaması gereken iki şey vardır. /chat/completions veya /messages bölümlerini de içeren tam URL'yi yapıştırırsanız yol iki kez eklenir ve 404 alınır. Sondaki # işareti, ekrandaki ipucunda belirtildiği gibi “otomatik olarak eklenen API sürümünü devre dışı bırakır”; standart bir uç noktaya eklendiğinde /v1 eksik kalır.
Ücretleri boşa harcamamak için varsayılan modeli ayarlama
Cherry Studio, sohbet dışında da arka planda model çağırır. Hızlı model, ekrandaki açıklamaya göre “konu adlandırma ve arama anahtar kelimelerini çıkarma gibi basit görevler” için kullanılır; ipucunda da “hafif bir model seçin, akıl yürütme modellerinden kaçının” denir. Buraya ucuz bir model koymanız, her konuşmada pahalı bir modelin çalışmasını önler. Çeviri modeli de ayrıca ayarlanabilir. Birden fazla model seçip aynı anda soru sorduğunuzda, model sayısı kadar ayrı istek (yani ayrı faturalandırma) oluşacağını da unutmayın. Uygulama içindeki kullanım istatistiklerinde gösterilen tutar, yayımlanan fiyatlardan yapılan bir tahmindir; indirimli rotalarda gerçek tutardan yüksek görünebilir. Model ayarlarında birim fiyatı kendi ücretinize göre değiştirirseniz doğru sonuç elde edersiniz. Ayrıntılar için İngilizce Cherry Studio API cost sayfasına bakın.
MCP sunucusu ayarları: Harici araçları bağlama
MCP, modelin (Agent) harici araçları ve verileri kullanmasını sağlayan bir bağlantı yöntemidir. Resmî belgelerdeki yol Ayarlar → MCP → MCP sunucuları → Ekle şeklindedir. Ekleme ekranındaki “Hızlı oluşturma” ile yalnızca bağlantı bilgilerini girerek sunucu oluşturabilir, kalan ayarları daha sonra değiştirebilirsiniz.
| Tür (ekrandaki ifade) | Kullanım alanı | Girilecek bilgiler |
|---|---|---|
| Standart girdi/çıktı (stdio) | Yerel bir komutla çalışan sunucu | Komut, bağımsız değişkenler, ortam değişkenleri |
| Sunucu tarafından gönderilen olaylar (sse) | SSE URL'si sağlayan uzak hizmet | URL (gerekirse kimlik doğrulama) |
| Akış yapılabilir HTTP | Streamable HTTP URL'si sağlayan uzak hizmet | URL (gerekirse kimlik doğrulama) |
種類 標準入力/出力 (stdio)
コマンド npx
引数 -y @modelcontextprotocol/server-filesystem /Users/you/notes
環境変数 （サーバーが求めるものだけ）- Türü, sağlayıcının önerdiği bağlantı yöntemine göre seçin. Belgeler de “adından tahmin etmeyin, sağlayıcının ayarlarında belirtildiği şekilde girin” uyarısında bulunur.
- Kaydedin, sunucuyu etkinleştirin ve durumun normal hâle gelmesini bekleyin. Ayrıntılardaki “Araçlar”, “İstemler” ve “Kaynaklar” sekmelerinden nelerin sunulduğunu kontrol edin.
- İş → Agent menüsü → Düzenle → MCP yoluyla bu sunucuyu etkinleştirin. Sunucular tüm Agent'lara otomatik olarak eklenmez.
- Giriş alanındaki “+” düğmesinden sunucunun sunduğu MCP istemlerini veya MCP kaynaklarını da ekleyebilirsiniz.
MCP araçlarını gerçekte çağıran model olduğundan, araç çağrılarını destekleyen bir model seçin. Yukarıdaki sağlayıcı ayarlarında eklediğiniz Claude ve GPT modelleri araç çağrılarını destekler. Belgelerin önerdiği gibi, başlangıçta her seferinde yalnızca birini etkinleştirip çalışmasını doğrulayın; yazma veya ücretlendirme oluşturan araçları onay gerektirecek şekilde bırakmak daha güvenlidir. MCP'nin “yerleşik sunucular” veya “marketplace” bölümünden yükleme yaparken de komutların ve ortam değişkenlerinin içeriğini kontrol edin.
Kunavo kullanırken dikkat edilmesi gerekenler ve ödeme
- Doğrulamanın kapsamı. Bu ayar, Cherry Studio'nun kaynak kodu ve resmî belgeleri temel alınarak hazırlanmıştır; Kunavo'nun Cherry Studio'yu kendi uç noktalarına bağlayıp çalıştırdığı bir doğrulama değildir. Şu anda çalışan rotaları koruyarak deneyin.
- Kunavo'nun rotaları yalnızca sohbet ve görsel içindir. Gömme modelleri yoktur; bu nedenle bilgi tabanında vektör araması için başka bir sağlayıcıya veya yerel bir gömme modeline ihtiyaç vardır (belgeler, gömme olmadan da BM25 anahtar kelime aramasıyla çalışabileceğini açıklar).
- Ödeme. Aylık ücret olmadan ön ödemeli yükleme yapılır ve tutar token bazında bakiyeden düşülür. Minimum yükleme $10’dır; Stripe ödeme sayfasında kart (Visa, Mastercard, American Express, JCB), Apple Pay, Google Pay ve Link kullanılabilir. Faturalama açıklamasını inceleyin, bir hesap oluşturun ve anahtarınızı alın. İngilizce ayar sayfası Cherry Studio integration guide’dır.
Sık sorulan sorular
Cherry Studio'da kendi API anahtarımı nasıl ayarlarım?
Ayarlar → Model sağlayıcıları → Sağlayıcı ekle yoluyla “Özel sağlayıcı ekle” iletişim kutusunu açın; sağlayıcı adını ve API anahtarını girin, Uç nokta ayarları bölümündeki OpenAI ve Anthropic Mesajları alanlarına kök adresi yazıp kaydedin. Ardından model listesindeki “Modelleri senkronize et” seçeneğiyle modelleri alın, kullanacaklarınızı ekleyin ve “Kontrol et” ile birini doğrulayın. Sağlayıcının etkinleştirilmediği sürece model seçiminde görünmeyeceğini de unutmayın.
Cherry Studio'nun API adresinde /v1 gerekli mi?
Her iki kullanım da mümkündür. v2.1.4 kaynak kodunda, girilen kök adreste sürüm bölümü (/v1) yoksa otomatik olarak eklenir; zaten varsa olduğu gibi kullanılır. Ardından alana göre yol eklenir (OpenAI için /chat/completions, Anthropic için /messages). Kaçınmanız gereken şey, /chat/completions bölümünü de içeren tam URL'yi yapıştırmaktır; bu durumda yol iki kez eklenir ve 404 alınır. Sondaki # işareti sürümün otomatik eklenmesini durdurur; standart uç noktalar için bunu kullanmayın. Nihai URL'yi her alanın altında görünen “İstek yolu” bölümünden kontrol edebilirsiniz.
Cherry Studio'nun MCP sunucuları nereden yapılandırılır?
Resmî belgelerdeki yol Ayarlar → MCP → MCP sunucuları → Ekle şeklindedir. Yerel komutlar genellikle standart girdi/çıktı (stdio), uzak hizmetler ise SSE veya Streamable HTTP kullanır; bilgileri sağlayıcının yapılandırmasında belirtildiği şekilde girin. Kaydettikten sonra sunucuyu etkinleştirin, ayrıntılardaki “Araçlar” sekmesinden sunulan araçları kontrol edin ve ardından İş → Agent menüsü → Düzenle → MCP yoluyla bu sunucuyu etkinleştirin. Araçları çağıran model olduğundan, araç çağrılarını destekleyen bir model seçin.
Cherry Studio ücretsiz mi?
Masaüstü sürümü (topluluk sürümü) AGPL-3.0 lisanslı açık kaynaklı ve ücretsizdir. Ücretli olan, yapılandırdığınız sağlayıcıların modellerini kullanma maliyetidir. Cherry Studio Enterprise, fiyatı teklif usulü belirlenen ayrı bir üründür; yerleşik CherryAI ücretsizdir, ancak model yapılandırması ve limitleri yayımlanmamıştır.
“Modelleri senkronize et” seçeneğinde hiçbir şey görünmüyorsa ne yapılır?
Bu düğme, sağlayıcının model listesini (/v1/models) girilen adres ve anahtarla alır; liste boşsa önce adresi veya anahtarı sorgulayın. Tam URL yapıştırmadığınızı ve sona # eklemediğinizi kontrol edin; aynı birleşimi curl ile deneyin. JSON dönerse sorun uygulama tarafındadır, 401 dönerse anahtarla ilgilidir.
1 Ekim 2026'da doğrulandı: GitHub API (CherryHQ/cherry-studio, v2.1.4), v2.1.4 Japonca arayüz dizeleri (ja-jp.json), sağlayıcı ekleme ekranının kaynak kodu ve Cherry Studio'nun resmî belgelerindeki MCP sayfası. Kunavo, Cherry Studio'yu kendi uç noktalarına bağlayarak çalıştırmamıştır.