Cara mengatur Cherry Studio: provider API dan server MCP

Di “Pengaturan” Cherry Studio, banyak orang mencari dua hal: pengaturan penyedia untuk menggunakan model dengan kunci API sendiri, dan pengaturan server MCP untuk menghubungkan alat eksternal. Yang pertama dilakukan melalui Pengaturan → Penyedia model → Tambahkan penyedia, sedangkan yang kedua melalui Pengaturan → Server MCP. Halaman ini menjelaskan kedua prosedur berdasarkan v2.1.4 yang dirilis pada 30 September 2026, dengan label Jepang di layar apa adanya. Karena layar penambahan penyedia berubah besar pada v2, panduan era v1 yang menyuruh memilih “Tipe: OpenAI” tidak lagi sesuai dengan layar saat ini.

Targetnya adalah versi desktop CherryHQ/cherry-studio (AGPL-3.0, Windows, macOS, dan Linux). Per 1 Oktober 2026, repositori belum diarsipkan dan versi terbaru adalah v2.1.4. Waspadai aplikasi bernama sama di App Store karena merupakan aplikasi tidak terkait dari developer lain. Untuk mengubah bahasa layar ke Jepang, pilih bahasa Jepang di pengaturan bahasa (UI mendukung 13 bahasa termasuk Jepang).

Pengaturan penyedia: menggunakan model dengan kunci API sendiri

Berikut gambaran keseluruhan prosedurnya. Label menggunakan teks UI Jepang v2.1.4.

設定 → モデルプロバイダー → プロバイダーを追加
  （ダイアログ名：カスタムプロバイダーを追加）

  プロバイダー名            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           空欄のまま

→ 保存 → モデル一覧で「モデルを同期」→ 使うモデルを追加 → 「チェック」

1. Buka Pengaturan → Penyedia model, lalu tekan Tambahkan penyedia. Judul dialog yang terbuka adalah “Tambahkan penyedia khusus”. Jika ingin menggunakan penyedia yang ada sebagai dasar, misalnya untuk layanan Coding Plan, beberapa akun, atau pemisahan project, Anda juga dapat menggunakan “Mulai dari preset (opsional)” di bagian atas.
2. Masukkan Nama penyedia dan Kunci API.
3. Dalam Pengaturan endpoint, sejak awal tersedia dua kolom: OpenAI dan Pesan Anthropic. Setidaknya satu endpoint teks wajib diisi. Jika keduanya diisi, model dapat dipilih bukan hanya untuk chat, tetapi juga untuk Agent dan fitur yang menggunakan format Anthropic.
4. Buka Opsi lainnya untuk melihat kolom OpenAI Responses, Google Gemini, URL dasar pembuatan gambar, dan URL dasar pengeditan gambar. Kolom yang tidak digunakan boleh dibiarkan kosong.
5. Setelah menyimpan, pastikan penyedia ditandai Aktif di layar penyedia. Menurut dokumentasi resmi, model tidak akan muncul dalam pilihan meskipun sudah dikonfigurasi jika masih nonaktif. Ini adalah penyebab paling umum dari masalah “kunci tidak berfungsi”.
6. Impor model melalui Sinkronkan model pada daftar model, tambahkan model yang akan digunakan, lalu verifikasi pengoperasian satu model dengan Periksa.

Cara menulis alamat: masukkan root saja

Dalam source v2.1.4, jika alamat root yang dimasukkan pada setiap kolom tidak memiliki bagian versi, /v1 akan ditambahkan (jika sudah ada, tidak ditambahkan), lalu rute per kolom ditambahkan. URL akhir ditampilkan sebagai “Jalur permintaan” di bawah setiap kolom, jadi periksa bagian tersebut sebelum menyimpan.

Ada dua hal yang tidak boleh dilakukan. Jika menempelkan URL lengkap yang mencakup /chat/completions atau /messages, rute akan menjadi ganda dan menghasilkan 404. Tanda # di akhir, seperti dijelaskan dalam petunjuk di layar, berarti “menonaktifkan versi API yang ditambahkan secara otomatis”; jika dipasang pada endpoint standar, /v1 akan hilang.

Mengatur model default agar tidak membuang biaya

Cherry Studio memanggil model di latar belakang, bukan hanya untuk chat. Model cepat digunakan, sesuai penjelasan layar, untuk “tugas sederhana seperti memberi nama topik dan mengekstrak kata kunci pencarian”, dan petunjuknya juga menyarankan “pilih model ringan dan hindari model penalaran”. Cukup masukkan model murah di sini untuk mencegah model mahal berjalan setiap kali percakapan. Model terjemahan juga dapat diatur secara terpisah. Ingat bahwa jika memilih beberapa model dan menanyakannya secara bersamaan, jumlah permintaan terpisah (= tagihan terpisah) sama dengan jumlah model. Jumlah dalam statistik penggunaan aplikasi adalah estimasi berdasarkan harga publik dan dapat tampak lebih tinggi daripada kenyataan pada jalur yang memberikan diskon. Ubah tarif satuan dalam pengaturan model ke tarif Anda sendiri agar sesuai. Untuk detail, lihat Cherry Studio API cost versi bahasa Inggris.

Pengaturan server MCP: menghubungkan alat eksternal

MCP adalah metode koneksi yang memungkinkan model (Agent) menggunakan alat dan data eksternal. Langkah dalam dokumentasi resmi adalah Pengaturan → MCP → Server MCP → Tambahkan. Dengan “Buat cepat” pada layar penambahan, Anda dapat membuat server hanya dengan memasukkan informasi koneksi; sisanya dapat disesuaikan nanti.

種類      標準入力/出力 (stdio)
コマンド   npx
引数       -y @modelcontextprotocol/server-filesystem /Users/you/notes
環境変数   （サーバーが求めるものだけ）

1. Pilih jenis sesuai metode koneksi yang dijelaskan penyedia. Dokumentasi juga meminta Anda “memasukkan sesuai konfigurasi penyedia, bukan menebak dari namanya”.
2. Simpan dan aktifkan server, lalu tunggu hingga statusnya normal. Periksa apa yang tersedia pada tab “Alat”, “Prompt”, dan “Resource” di detail.
3. Aktifkan server tersebut melalui Pekerjaan → menu Agent → Edit → MCP. Server tidak otomatis ditambahkan ke semua Agent.
4. Anda juga dapat menyisipkan prompt MCP atau resource MCP yang disediakan server melalui “+” pada kolom input.

Karena model yang benar-benar memanggil alat MCP, pilih model yang mendukung pemanggilan alat. Model Claude dan GPT yang ditambahkan melalui pengaturan penyedia di atas mendukung pemanggilan alat. Sesuai anjuran dokumentasi, aktifkan satu per satu terlebih dahulu dan verifikasi pengoperasiannya; untuk alat yang melakukan penulisan atau menimbulkan biaya, biarkan pengaturan tetap memerlukan persetujuan demi keamanan. Saat memasang dari “Server bawaan” atau “Marketplace” MCP, periksa juga isi perintah dan variabel lingkungannya.

Catatan dan pembayaran saat menggunakan Kunavo

• Cakupan verifikasi. Pengaturan ini dibuat berdasarkan source dan dokumentasi resmi Cherry Studio; ini bukan verifikasi bahwa Kunavo telah benar-benar menghubungkan dan menjalankan Cherry Studio dengan endpoint miliknya. Uji coba dengan tetap mempertahankan jalur yang saat ini berfungsi.
• Jalur Kunavo hanya mendukung chat dan gambar. Tidak ada model embedding, jadi pencarian vektor basis pengetahuan memerlukan penyedia lain atau model embedding lokal (dokumentasi menjelaskan bahwa pencarian kata kunci BM25 dapat berjalan tanpa embedding).
• Pembayaran. Sistem pengisian prabayar tanpa biaya bulanan; saldo dipotong berdasarkan token. Pengisian minimum adalah $10, dan checkout Stripe menerima kartu (Visa, Mastercard, American Express, JCB), Apple Pay, Google Pay, serta Link. Baca penjelasan penagihan, lalu buat akun untuk menerbitkan kunci. Halaman pengaturan berbahasa Inggris adalah Cherry Studio integration guide.

Pertanyaan umum

Diverifikasi pada 1 Oktober 2026: GitHub API (CherryHQ/cherry-studio, v2.1.4), string UI Jepang v2.1.4 (ja-jp.json), source layar penambahan penyedia, dan halaman MCP dalam dokumentasi resmi Cherry Studio. Kunavo belum menjalankan Cherry Studio terhadap endpoint miliknya sendiri.