Cherry Studio 設定——API 金鑰與 MCP 伺服器

Q: 如何在 Cherry Studio 中設定自己的 API 金鑰？

前往 設定 → 模型提供者 → 新增提供者，開啟「新增自訂提供者」對話方塊，輸入提供者名稱、API 金鑰，並在端點設定的 OpenAI 與 Anthropic 訊息欄位中填入根網址，然後儲存。接著在模型清單中使用「同步模型」匯入模型，新增要使用的模型，再以「檢查」確認其中一個。另請注意，提供者必須啟用，否則不會出現在模型選擇中。

Q: Cherry Studio 的 MCP 伺服器在哪裡設定？

官方文件的步驟是 設定 → MCP → MCP 伺服器 → 新增。本機命令通常使用標準輸入／輸出（stdio），遠端服務則使用 SSE 或 Streamable HTTP，並依提供者的設定輸入。儲存後啟用伺服器，在詳細資訊的「工具」分頁確認提供的工具，再前往 工作 → Agent 選單 → 編輯 → MCP，啟用該伺服器。由模型呼叫工具，因此請選擇支援工具呼叫的模型。

在 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 的標示。

Cherry Studio 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           空欄のまま

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

開啟 設定 → 模型提供者，按下新增提供者。開啟的對話方塊標題為「新增自訂提供者」。如果你要使用既有提供者作為基礎，例如 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（必要時包含驗證資訊）

MCP 伺服器範例（本機）

種類      標準入力/出力 (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 的路徑只有聊天與影像。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。