在 Cherry Studio 的“设置”中，大多数人要找的是两项：使用自己的 API 密钥调用模型的提供方设置，以及连接外部工具的 MCP 服务器设置。前者通过 设置 → 模型提供方 → 添加提供方，后者通过 设置 → MCP 服务器 完成。本页面以 2026年9月30日发布的 v2.1.4 为基准，按照界面中的日文原文说明两套步骤。由于 v2 中添加提供方的界面发生了较大变化，v1 时代选择“类型：OpenAI”的说明已不再与界面一致。
对象是 CherryHQ/cherry-studio 的桌面版（AGPL-3.0，Windows、macOS、Linux）。截至 2026年10月1日，该仓库尚未归档，最新版本为 v2.1.4。App Store 中同名的应用由其他开发者开发，与此无关，请注意。要将界面切换为日文，请在设置的语言中选择日文（UI 支持包括日文在内的 13 种语言）。
提供方设置：使用自己的 API 密钥调用模型
以下是完整流程。标签采用 v2.1.4 日文 UI 中的原文。
設定 → モデルプロバイダー → プロバイダーを追加
（ダイアログ名：カスタムプロバイダーを追加）
プロバイダー名 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 空欄のまま
→ 保存 → モデル一覧で「モデルを同期」→ 使うモデルを追加 → 「チェック」- 打开设置 → 模型提供方，点击添加提供方。打开的对话框标题为“添加自定义提供方”。如果你希望基于现有提供方配置 Coding Plan 类服务、多个账户或项目隔离等，也可以使用顶部的“从预设开始（可选）”。
- 输入提供方名称和 API 密钥。
- 在端点设置中，默认会并列显示 OpenAI 和 Anthropic 消息 两个字段。至少需要一个文本端点。两者都填写后，不仅聊天功能，在 Agent 或使用 Anthropic 格式的功能中也可以选择模型。
- 展开其他选项后，可以看到 OpenAI 响应、Google Gemini、图像生成基础 URL、图像编辑基础 URL 等字段。不使用的字段可以留空。
- 保存后，在提供方页面确认是否处于启用状态。根据官方文档，即使已经配置，如果仍处于停用状态，模型也不会出现在选项中。“密钥无效”最常见的原因就是这一点。
- 在模型列表中通过同步模型导入模型，添加要使用的模型，然后用检查确认其中一个能正常运行。
地址写法：只填写根地址
在 v2.1.4 的源代码中，如果各字段输入的根地址不包含版本部分，就会添加 /v1（已有时不会重复添加），然后再附加各字段对应的路径。每个字段下方都会以“请求路径”显示最终 URL，因此保存前查看那里即可确认。
| 字段 | Cherry Studio 添加的路径 | Kunavo |
|---|---|---|
| OpenAI | /chat/completions | 支持 |
| Anthropic 消息 | /messages | 支持 |
| OpenAI 响应（其他选项） | /responses | 支持 |
| 图像生成基础 URL（其他选项） | /images/generations | 支持 |
| 图像编辑基础 URL（其他选项） | /images/edits | 支持 |
| Google Gemini（其他选项） | /models/{model}:generateContent | 不支持 — 保持空白 |
有两件事不要做。粘贴包含 /chat/completions 或 /messages 的完整 URL，会导致路径重复并返回 404。末尾的 # 按照界面提示，是用于“禁用自动添加的 API 版本”的符号；将其添加到标准端点时，会缺少 /v1。
设置默认模型以避免浪费费用
Cherry Studio 不仅用于聊天，也会在后台调用模型。快速模型按照界面说明用于“主题命名、提取搜索关键词等简单任务”，提示中还写着“请选择轻量模型，避免使用推理模型”。这里只需设置一个便宜模型，就能避免每次对话都运行昂贵模型。翻译模型也可以单独设置。还要记住，同时选择多个模型并提问时，会按模型数量产生多个独立请求（= 多笔费用）。应用内使用量统计中的金额是根据公开价格得出的估算值，在存在折扣的路径上会高于实际费用。在模型设置中将单价改为自己的费率即可匹配。详情请参阅英文版 Cherry Studio API cost。
MCP 服务器设置：连接外部工具
MCP 是一种连接方式，用于让模型（Agent）使用外部工具或数据。官方文档中的步骤是 设置 → MCP → MCP 服务器 → 添加。在添加页面的“快速创建”中只需输入连接信息即可创建服务器，其余内容可以稍后调整。
| 类型（界面显示） | 使用场景 | 输入内容 |
|---|---|---|
| 标准输入/输出 (stdio) | 通过本地命令运行的服务器 | 命令、参数、环境变量 |
| 服务器发送事件 (sse) | 提供 SSE URL 的远程服务 | URL（如有需要则填写身份验证） |
| 可流式传输的 HTTP | 提供 Streamable HTTP URL 的远程服务 | URL（如有需要则填写身份验证） |
種類 標準入力/出力 (stdio)
コマンド npx
引数 -y @modelcontextprotocol/server-filesystem /Users/you/notes
環境変数 （サーバーが求めるものだけ）- 根据提供方说明的连接方式选择类型。文档也要求“不要从名称推测，而要按照提供方的设置输入”。
- 保存并启用服务器，等待状态变为正常。在详情的“工具”“提示”“资源”选项卡中确认其提供的内容。
- 在工作 → Agent 菜单 → 编辑 → MCP中启用该服务器。服务器不会自动附加到所有 Agent。
- 也可以从输入栏的“+”中插入服务器提供的 MCP 提示或 MCP 资源。
实际调用 MCP 工具的是模型，因此请选择支持工具调用的模型。通过上面的提供方设置添加的 Claude 或 GPT 模型支持工具调用。按照文档建议，开始时应逐个启用并确认运行情况；对于会产生写入或费用的工具，保持要求批准的设置更安全。即使从 MCP 的“内置服务器”或“市场”安装，也请确认命令和环境变量的内容。
使用 Kunavo 时的注意事项与支付
- 验证范围。此设置根据 Cherry Studio 的源代码和官方文档编写，并非 Kunavo 实际将 Cherry Studio 连接到自有端点后运行的验证结果。请在保留当前可用路径的情况下进行测试。
- Kunavo 的路径仅支持聊天和图像。由于没有嵌入模型，知识库的向量搜索需要其他提供方或本地嵌入模型（文档说明，即使没有嵌入，也可以通过 BM25 关键词搜索运行）。
- 付款。采用预付充值模式，无月费，按 token 从余额中扣款。最低充值金额为 $10；Stripe 结账支持银行卡（Visa、Mastercard、American Express、JCB）、Apple Pay、Google Pay 和 Link。请查看账单说明，创建账户并获取密钥。英文设置页面为 Cherry Studio integration guide。
常见问题
如何在 Cherry Studio 中设置自己的 API 密钥？
在 设置 → 模型提供商 → 添加提供商 中打开“添加自定义提供商”对话框，输入提供商名称和 API 密钥，并在端点设置中的 OpenAI 和 Anthropic 消息字段里填入根地址，然后保存。接着在模型列表中选择“同步模型”导入模型，添加要使用的模型，并通过“检查”确认其中一个能正常运行。还请注意，提供商必须启用后才会出现在模型选择中。
Cherry Studio 的 API 地址需要 /v1 吗？
两种方式都可以。在 v2.1.4 的源代码中，如果输入的根地址没有版本部分（/v1），系统会自动添加；如果已经存在，则原样使用。之后会根据字段追加相应路径（OpenAI 为 /chat/completions，Anthropic 为 /messages）。应避免粘贴已经包含 /chat/completions 的完整 URL，否则路径会重复并导致 404。末尾的 # 是阻止自动添加版本号的符号，因此不要将其添加到标准端点。可以在各字段下方显示的“请求路径”中确认最终 URL。
Cherry Studio 的 MCP 服务器在哪里设置？
官方文档中的步骤是 设置 → MCP → MCP 服务器 → 添加。对于本地命令，通常使用标准输入/输出（stdio）；对于远程服务，通常使用 SSE 或 Streamable HTTP，并按照提供方的设置输入。保存后启用服务器，在详情的“工具”选项卡中确认提供的工具，然后在 工作 → Agent 菜单 → 编辑 → MCP 中启用该服务器。调用工具的是模型，因此请选择支持工具调用的模型。
Cherry Studio 是免费的吗？
桌面版（社区版）采用 AGPL-3.0 开源许可且免费。需要付费的是所配置提供方的模型使用费。Cherry Studio Enterprise 是按报价收费的独立产品，内置的 CherryAI 免费，但模型配置和上限尚未公开。
“同步模型”没有显示任何内容时怎么办？
此按钮会使用输入的地址和密钥获取提供方的模型列表（/v1/models），因此为空时应先检查地址或密钥。确认没有粘贴完整 URL，也没有在末尾添加 #，然后使用 curl 测试相同的组合。如果返回 JSON，则是应用端问题；如果返回 401，则是密钥问题。
2026年10月1日确认：GitHub API（CherryHQ/cherry-studio、v2.1.4）、v2.1.4 的日文 UI 字符串（ja-jp.json）和添加提供方页面的源代码、Cherry Studio 官方文档的 MCP 页面。Kunavo 未针对自有端点运行 Cherry Studio。