Cherry Studio einrichten: API-Anbieter und MCP-Server

In den „Einstellungen“ von Cherry Studio suchen viele Menschen nach zwei Dingen: den Anbietereinstellungen, um Modelle mit dem eigenen API-Schlüssel zu verwenden, und den MCP-Servereinstellungen, um externe Tools zu verbinden. Ersteres erfolgt über Einstellungen → Modellanbieter → Anbieter hinzufügen, Letzteres über Einstellungen → MCP-Server. Diese Seite beschreibt beide Abläufe anhand der am 30. September 2026 veröffentlichten Version v2.1.4 und verwendet dabei genau die japanischen Bezeichnungen der Benutzeroberfläche. Da sich der Dialog zum Hinzufügen eines Anbieters in v2 stark geändert hat, stimmen Anleitungen aus der v1-Zeit, die zur Auswahl von „Typ: OpenAI“ auffordern, nicht mehr mit der Oberfläche überein.

Gegenstand ist die Desktop-Version von CherryHQ/cherry-studio (AGPL-3.0, Windows, macOS und Linux). Am 1. Oktober 2026 war das Repository nicht archiviert; die aktuelle Version ist v2.1.4. Achten Sie darauf, dass die gleichnamige App im App Store von einem anderen Entwickler stammt und nicht dazugehört. Um die Oberfläche auf Japanisch zu stellen, wählen Sie Japanisch in den Spracheinstellungen (die Benutzeroberfläche unterstützt 13 Sprachen einschließlich Japanisch).

Anbietereinstellungen: Modelle mit dem eigenen API-Schlüssel verwenden

Hier ist der vollständige Ablauf. Die Bezeichnungen entsprechen der japanischen Benutzeroberfläche von 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. Öffnen Sie Einstellungen → Modellanbieter und klicken Sie auf Anbieter hinzufügen. Der Titel des geöffneten Dialogs lautet „Benutzerdefinierten Anbieter hinzufügen“. Wenn Sie für Coding-Plan-Dienste, mehrere Konten oder getrennte Projekte einen vorhandenen Anbieter als Grundlage verwenden möchten, können Sie oben auch „Mit einer Voreinstellung beginnen (optional)“ nutzen.
2. Geben Sie Anbietername und API-Schlüssel ein.
3. Unter Endpunkteinstellungen sind bereits die beiden Felder OpenAI und Anthropic Messages vorhanden. Mindestens ein Textendpunkt ist erforderlich. Wenn Sie beide ausfüllen, können Sie Modelle nicht nur im Chat, sondern auch in Agenten und Funktionen mit dem Anthropic-Format auswählen.
4. Unter Weitere Optionen finden Sie Felder für OpenAI Responses, Google Gemini, die Basis-URL für Bildgenerierung und die Basis-URL für Bildbearbeitung. Nicht benötigte Felder können leer bleiben.
5. Prüfen Sie nach dem Speichern auf der Anbieterseite, ob der Anbieter aktiviert ist. Laut offizieller Dokumentation erscheinen Modelle trotz abgeschlossener Konfiguration nicht zur Auswahl, solange der Anbieter deaktiviert ist. Dies ist die häufigste Ursache dafür, dass ein „Schlüssel nicht funktioniert“.
6. Importieren Sie Modelle über Modelle synchronisieren in der Modellliste, fügen Sie die gewünschten Modelle hinzu und testen Sie eines über Überprüfen.

Adressen eingeben: nur die Basisadresse

Im Quellcode von v2.1.4 wird an die in den jeweiligen Feldern eingetragene Basisadresse der Versionsteil /v1 angehängt, wenn er fehlt (andernfalls nicht), und anschließend der feldspezifische Pfad ergänzt. Unter jedem Feld wird der endgültige URL als „Anforderungspfad“ angezeigt; prüfen Sie ihn vor dem Speichern.

Es gibt zwei Dinge, die Sie nicht tun dürfen. Wenn Sie vollständige URLs einschließlich /chat/completions oder /messages einfügen, wird der Pfad doppelt ergänzt und führt zu 404. Das abschließende # deaktiviert, wie der Hinweis auf dem Bildschirm erklärt, „die automatisch hinzugefügte API-Version“. Bei einem Standardendpunkt fehlt dann /v1.

Standardmodell so einstellen, dass Kosten nicht unnötig entstehen

Cherry Studio ruft Modelle auch im Hintergrund und nicht nur im Chat auf. Das Schnellmodell wird laut Beschreibung der Oberfläche für „einfache Aufgaben wie das Benennen von Themen und das Extrahieren von Suchbegriffen“ verwendet; der Hinweis empfiehlt außerdem, „ein leichtgewichtiges Modell auszuwählen und Reasoning-Modelle zu vermeiden“. Wenn Sie hier ein günstiges Modell hinterlegen, verhindern Sie, dass bei jeder Unterhaltung ein teures Modell ausgeführt wird. Ein Übersetzungsmodell kann ebenfalls separat konfiguriert werden. Wenn Sie mehrere Modelle auswählen und gleichzeitig befragen, entstehen für jedes Modell separate Anfragen (= separate Abrechnungen). Die Beträge in der Nutzungsstatistik der App sind eine Schätzung anhand veröffentlichter Preise und fallen bei rabattierten Routen höher aus als tatsächlich. Wenn Sie den Stückpreis in den Modelleinstellungen auf Ihren eigenen Preis ändern, stimmen die Werte. Weitere Informationen finden Sie in der englischen Version Cherry Studio API cost.

MCP-Servereinstellungen: externe Tools verbinden

MCP ist eine Verbindungsmethode, mit der Modelle (Agenten) externe Tools und Daten verwenden können. Die Anleitung in der offiziellen Dokumentation lautet Einstellungen → MCP → MCP-Server → Hinzufügen. Über „Schnellerstellung“ im Hinzufügedialog können Sie nur die Verbindungsdaten eingeben und den Server anlegen; den Rest können Sie später anpassen.

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

1. Wählen Sie den Typ entsprechend der vom Anbieter angegebenen Verbindungsmethode. Die Dokumentation fordert ebenfalls dazu auf, nicht vom Namen auszugehen, sondern die Werte gemäß den Angaben des Anbieters einzugeben.
2. Speichern und aktivieren Sie den Server und warten Sie, bis sein Status normal ist. Prüfen Sie in den Detail-Tabs „Tools“, „Prompts“ und „Ressourcen“, was bereitgestellt wird.
3. Aktivieren Sie den Server unter Arbeit → Agent-Menü → Bearbeiten → MCP. Server werden nicht automatisch allen Agenten hinzugefügt.
4. Über „+“ in einem Eingabefeld können Sie auch vom Server bereitgestellte MCP-Prompts oder MCP-Ressourcen einfügen.

Da das Modell die MCP-Tools tatsächlich aufruft, wählen Sie ein Modell mit Unterstützung für Tool-Aufrufe. Claude- und GPT-Modelle, die Sie in den obigen Anbietereinstellungen hinzugefügt haben, unterstützen Tool-Aufrufe. Aktivieren Sie gemäß der Empfehlung der Dokumentation zunächst jeweils nur einen Server und prüfen Sie seine Funktion. Bei Tools, die Schreibvorgänge oder Kosten verursachen, sollten Sie die Einstellung beibehalten, die eine Genehmigung verlangt. Prüfen Sie auch bei Installationen über „Integrierte Server“ oder den „Marktplatz“ den Inhalt von Befehlen und Umgebungsvariablen.

Hinweise und Zahlung bei der Verwendung von Kunavo

• Umfang der Prüfung. Diese Konfiguration wurde anhand des Cherry-Studio-Quellcodes und der offiziellen Dokumentation erstellt; Kunavo wurde nicht tatsächlich mit Cherry Studio an einen eigenen Endpunkt angeschlossen und getestet. Testen Sie, ohne einen derzeit funktionierenden Pfad zu entfernen.
• Kunavos Pfade gelten nur für Chat und Bilder. Da keine Embedding-Modelle verfügbar sind, benötigen Sie für die Vektorsuche in einer Wissensdatenbank einen anderen Anbieter oder ein lokales Embedding-Modell (die Dokumentation erklärt, dass es auch ohne Embeddings mit einer BM25-Schlüsselwortsuche funktioniert).
• Zahlung. Prepaid-Aufladung ohne monatliche Gebühr; der Betrag wird tokenweise vom Guthaben abgezogen. Die Mindestaufladung beträgt $10, und beim Stripe-Checkout können Karten (Visa, Mastercard, American Express, JCB), Apple Pay, Google Pay und Link verwendet werden. Lesen Sie die Abrechnungshinweise, erstellen Sie ein Konto und stellen Sie einen Schlüssel aus. Die englische Einstellungsseite ist der Cherry Studio integration guide.

Häufig gestellte Fragen

Geprüft am 1. Oktober 2026: GitHub API (CherryHQ/cherry-studio, v2.1.4), japanische UI-Zeichenfolgen von v2.1.4 (ja-jp.json), Quellcode des Dialogs zum Hinzufügen eines Anbieters und die MCP-Seite der offiziellen Cherry-Studio-Dokumentation. Kunavo hat Cherry Studio nicht gegen einen eigenen Endpunkt ausgeführt.