Dans les « 設定 » de Cherry Studio, beaucoup d’utilisateurs recherchent deux éléments : la configuration du fournisseur pour utiliser des modèles avec leur propre clé API, et la configuration des serveurs MCP pour connecter des outils externes. La première se fait dans 設定 → モデルプロバイダー → プロバイダーを追加, la seconde dans 設定 → MCP サーバー. Cette page se base sur la v2.1.4 publiée le 30 septembre 2026 et décrit les deux procédures en conservant les libellés japonais affichés à l’écran. Comme l’écran d’ajout de fournisseur a beaucoup changé en v2, les explications de l’époque de v1 qui demandent de sélectionner « タイプ：OpenAI » ne correspondent plus à l’interface actuelle.
La cible est la version de bureau de CherryHQ/cherry-studio (AGPL-3.0, Windows, macOS et Linux). Au 1er octobre 2026, le dépôt n’est pas archivé et la dernière version est v2.1.4. L’application du même nom disponible dans l’App Store, développée par un autre éditeur, n’a aucun rapport : soyez vigilant. Pour passer l’interface en japonais, sélectionnez 日本語 dans les paramètres de langue (l’interface prend en charge 13 langues, dont le japonais).
Configuration du fournisseur : utiliser des modèles avec votre propre clé API
Voici la procédure complète. Les libellés correspondent à l’interface japonaise de 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 空欄のまま
→ 保存 → モデル一覧で「モデルを同期」→ 使うモデルを追加 → 「チェック」- Ouvrez Paramètres → Fournisseurs de modèles, puis cliquez sur Ajouter un fournisseur. Le titre de la boîte de dialogue est « Ajouter un fournisseur personnalisé ». Si vous souhaitez partir d’un fournisseur existant, par exemple pour les services de type Coding Plan, les comptes multiples ou la séparation des projets, vous pouvez aussi utiliser « Commencer à partir d’un préréglage (facultatif) » en haut.
- Saisissez le nom du fournisseur et la clé API.
- Dans Configuration des endpoints, deux champs sont présents par défaut : OpenAI et Anthropic Messages. Au moins un endpoint texte est obligatoire. Remplir les deux permet de sélectionner des modèles non seulement pour le chat, mais aussi pour les Agents et les fonctions utilisant le format Anthropic.
- En ouvrant Autres options, vous trouverez les champs OpenAI Responses, Google Gemini, URL de base pour la génération d’images et URL de base pour l’édition d’images. Les champs inutilisés peuvent rester vides.
- Après l’enregistrement, vérifiez que le fournisseur est activé dans son écran. D’après la documentation officielle, un fournisseur configuré mais désactivé n’apparaît pas dans les choix de modèles. C’est la cause la plus fréquente d’une « clé qui ne fonctionne pas ».
- Importez les modèles avec Synchroniser les modèles dans la liste des modèles, ajoutez ceux que vous souhaitez utiliser et vérifiez-en un avec Tester.
Comment saisir l’adresse : uniquement la racine
Dans le code source de v2.1.4, si l’adresse racine saisie dans chaque champ ne contient pas de partie de version, /v1 est ajouté (et ne l’est pas si elle est déjà présente), puis le chemin propre au champ est ajouté. L’URL finale est affichée sous chaque champ sous « Chemin de requête » : vérifiez-la avant l’enregistrement.
| Champ | Chemin ajouté par Cherry Studio | Kunavo |
|---|---|---|
| OpenAI | /chat/completions | Pris en charge |
| Anthropic Messages | /messages | Pris en charge |
| OpenAI Responses (Autres options) | /responses | Pris en charge |
| URL de base pour la génération d’images (Autres options) | /images/generations | Pris en charge |
| URL de base pour l’édition d’images (Autres options) | /images/edits | Pris en charge |
| Google Gemini (Autres options) | /models/{model}:generateContent | Non pris en charge — laisser vide |
Deux choses sont à éviter. Si vous collez une URL complète contenant déjà /chat/completions ou /messages, le chemin sera dupliqué et provoquera une erreur 404. Comme l’indique l’aide à l’écran, le # final sert à « désactiver la version d’API ajoutée automatiquement » ; sur un endpoint standard, il supprime /v1.
Configurer un modèle par défaut qui évite de gaspiller de l’argent
Cherry Studio appelle des modèles en arrière-plan, au-delà du chat. Le modèle rapide sert, comme l’indique l’interface, aux « tâches simples telles que nommer des sujets ou extraire des mots-clés de recherche », et l’aide recommande de « sélectionner un modèle léger et d’éviter les modèles de raisonnement ». Il suffit d’y définir un modèle peu coûteux pour éviter d’exécuter un modèle cher à chaque conversation. Un modèle de traduction peut également être configuré séparément. Si vous sélectionnez plusieurs modèles et leur posez une question simultanément, le nombre de requêtes distinctes — et donc de factures distinctes — correspond au nombre de modèles. Le montant des statistiques d’utilisation intégrées à l’application est une estimation fondée sur les tarifs publics ; sur les chemins bénéficiant d’une remise, il sera supérieur au montant réel. Modifiez les tarifs unitaires dans la configuration des modèles pour les faire correspondre à vos prix. Pour plus de détails, consultez la version anglaise de Cherry Studio API cost.
Configuration des serveurs MCP : connecter des outils externes
MCP est un protocole de connexion qui permet à un modèle (Agent) d’utiliser des outils ou des données externes. La procédure de la documentation officielle est Paramètres → MCP → Serveurs MCP → Ajouter. L’écran d’ajout permet de créer un serveur en saisissant uniquement les informations de connexion dans « Création rapide » ; le reste peut être ajusté ultérieurement.
| Type (libellé de l’interface) | Cas d’utilisation | Informations à saisir |
|---|---|---|
| Entrée/sortie standard (stdio) | Serveur exécuté par une commande locale | Commande, arguments, variables d’environnement |
| Server-Sent Events (sse) | Service distant fournissant une URL SSE | URL (authentification si nécessaire) |
| HTTP interopérable en streaming | Service distant fournissant une URL Streamable HTTP | URL (authentification si nécessaire) |
種類 標準入力/出力 (stdio)
コマンド npx
引数 -y @modelcontextprotocol/server-filesystem /Users/you/notes
環境変数 （サーバーが求めるものだけ）- Choisissez le type correspondant au protocole indiqué par le fournisseur. La documentation demande également de « ne pas le déduire du nom et de saisir les informations conformément à la configuration du fournisseur ».
- Enregistrez le serveur, activez-le et attendez que son état passe à la normale. Dans les onglets détaillés « Outils », « Prompts » et « Ressources », vérifiez ce qu’il fournit.
- Activez ce serveur dans Travail → menu Agent → Modifier → MCP. Les serveurs ne sont pas automatiquement associés à tous les Agents.
- Le bouton « + » du champ de saisie permet également d’insérer les prompts MCP ou les ressources MCP fournis par le serveur.
C’est le modèle qui appelle réellement les outils MCP : choisissez donc un modèle compatible avec les appels d’outils. Les modèles Claude et GPT ajoutés dans la configuration du fournisseur ci-dessus prennent en charge les appels d’outils. Comme le recommande la documentation, activez-les d’abord un par un et vérifiez leur fonctionnement ; pour les outils qui écrivent des données ou entraînent des frais, conservez un réglage exigeant une approbation. Même lorsque vous installez un serveur depuis les « Serveurs intégrés » ou la « Marketplace » MCP, vérifiez le contenu de la commande et des variables d’environnement.
Points d’attention et paiement avec Kunavo
- Périmètre de la vérification. Cette configuration a été élaborée à partir du code source et de la documentation officielle de Cherry Studio ; elle ne constitue pas une vérification de Cherry Studio connecté et exécuté sur les endpoints propriétaires de Kunavo. Testez-la en conservant le chemin actuellement fonctionnel.
- Avec Kunavo, les chemins disponibles sont le chat et les images. Il n’y a pas de modèles d’embeddings : la recherche vectorielle d’une base de connaissances nécessite donc un autre fournisseur ou un modèle d’embeddings local (la documentation indique qu’une recherche par mots-clés BM25 fonctionne également sans embeddings).
- Paiement. Recharge prépayée sans abonnement mensuel, le solde étant débité à l’unité de token. La recharge minimale est de $10, et le paiement Stripe accepte les cartes (Visa, Mastercard, American Express, JCB), Apple Pay, Google Pay et Link. Consultez les informations de facturation, puis créez un compte pour obtenir une clé. La page de configuration en anglais est le guide d’intégration de Cherry Studio.
Questions fréquentes
Comment configurer ma clé API dans Cherry Studio ?
Dans Paramètres → Fournisseurs de modèles → Ajouter un fournisseur, ouvrez la boîte de dialogue « Ajouter un fournisseur personnalisé », puis saisissez le nom du fournisseur et la clé API. Entrez l’adresse racine dans les champs OpenAI et Anthropic Messages de la configuration des points de terminaison, puis enregistrez. Utilisez ensuite « Synchroniser les modèles » dans la liste des modèles pour les importer, ajoutez ceux que vous souhaitez utiliser et vérifiez-en un avec « Tester ». Notez également qu’un fournisseur doit être activé pour apparaître dans la sélection des modèles.
L’adresse API de Cherry Studio nécessite-t-elle /v1 ?
Les deux conviennent. Dans le code source de v2.1.4, si l’adresse racine saisie ne contient pas la partie de version (/v1), celle-ci est ajoutée automatiquement ; si elle est déjà présente, elle est conservée. Cherry Studio ajoute ensuite le chemin propre à chaque champ (/chat/completions pour OpenAI et /messages pour Anthropic). Évitez de coller une URL complète contenant déjà /chat/completions : le chemin serait dupliqué et provoquerait une erreur 404. Le caractère # final désactive l’ajout automatique de la version ; ne l’ajoutez donc pas à un endpoint standard. Le « chemin de requête » affiché sous chaque champ permet de vérifier l’URL finale.
Où configurer les serveurs MCP de Cherry Studio ?
La procédure de la documentation officielle est Paramètres → MCP → Serveurs MCP → Ajouter. Les commandes locales utilisent généralement l’entrée/sortie standard (stdio), tandis que les services distants utilisent SSE ou Streamable HTTP ; saisissez les informations conformément aux indications du fournisseur. Après l’enregistrement, activez le serveur et vérifiez les outils proposés dans l’onglet détaillé « Outils », puis activez ce serveur dans Travail → menu Agent → Modifier → MCP. C’est le modèle qui appelle les outils : choisissez donc un modèle compatible avec les appels d’outils.
Cherry Studio est-il gratuit ?
La version de bureau (édition communautaire) est gratuite et open source sous AGPL-3.0. Ce qui est payant, ce sont les frais d’utilisation des modèles des fournisseurs configurés. Cherry Studio Enterprise est un produit distinct proposé sur devis ; CherryAI intégré est gratuit, mais sa configuration de modèles et ses limites ne sont pas publiées.
Que faire si « Synchroniser les modèles » n’affiche rien ?
Ce bouton utilise l’adresse et la clé saisies pour récupérer la liste des modèles du fournisseur (/v1/models). Si elle est vide, vérifiez d’abord l’adresse ou la clé. Assurez-vous de ne pas avoir collé une URL complète ni ajouté # à la fin, puis testez la même combinaison avec curl. Si un JSON est renvoyé, le problème vient de l’application ; une réponse 401 indique un problème de clé.
Vérifié le 1er octobre 2026 : API GitHub (CherryHQ/cherry-studio, v2.1.4), chaînes de l’interface japonaise de v2.1.4 (ja-jp.json), code source de l’écran d’ajout de fournisseur et page MCP de la documentation officielle de Cherry Studio. Kunavo n’a pas exécuté Cherry Studio en le connectant à ses propres endpoints.