Trong «Cài đặt» của Cherry Studio, có hai mục mà nhiều người tìm kiếm: dùng mô hình bằng khóa API của mình trong phần Cài đặt nhà cung cấp, và kết nối công cụ bên ngoài trong Cài đặt máy chủ MCP. Phần đầu thực hiện qua Cài đặt → Nhà cung cấp mô hình → Thêm nhà cung cấp; phần sau qua Cài đặt → Máy chủ MCP.Trang này hướng dẫn cả hai quy trình theo đúng cách hiển thị tiếng Nhật trên giao diện, dựa trên v2.1.4 được phát hành ngày 30 tháng 9 năm 2026. Vì màn hình thêm nhà cung cấp đã thay đổi lớn trong v2, các hướng dẫn từ thời v1 yêu cầu chọn «Loại: OpenAI» không còn khớp với giao diện nữa.
Đối tượng là phiên bản máy tính để bàn của CherryHQ/cherry-studio (AGPL-3.0, Windows, macOS và Linux). Tính đến ngày 1 tháng 10 năm 2026, kho lưu trữ chưa bị lưu trữ và phiên bản mới nhất là v2.1.4. Hãy lưu ý rằng ứng dụng cùng tên trên App Store là một ứng dụng không liên quan của nhà phát triển khác. Để chuyển giao diện sang tiếng Nhật, chọn tiếng Nhật trong phần ngôn ngữ của Cài đặt (UI hỗ trợ 13 ngôn ngữ, bao gồm tiếng Nhật).
Cài đặt nhà cung cấp: dùng mô hình bằng khóa API của bạn
Đây là tổng quan quy trình. Các nhãn là cách hiển thị trên UI tiếng Nhật của 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 空欄のまま
→ 保存 → モデル一覧で「モデルを同期」→ 使うモデルを追加 → 「チェック」- Mở Cài đặt → Nhà cung cấp mô hình rồi nhấn Thêm nhà cung cấp. Tiêu đề hộp thoại mở ra là «Thêm nhà cung cấp tùy chỉnh». Nếu muốn dựa trên một nhà cung cấp hiện có, chẳng hạn cho các dịch vụ Coding Plan, nhiều tài khoản hoặc tách biệt dự án, bạn cũng có thể dùng «Bắt đầu từ giá trị đặt trước (tùy chọn)» ở phía trên.
- Nhập Tên nhà cung cấp và Khóa API.
- Trong Cài đặt endpoint, ban đầu có hai trường OpenAI và Tin nhắn Anthropic. Bắt buộc phải có ít nhất một endpoint văn bản. Điền cả hai sẽ cho phép chọn mô hình không chỉ trong trò chuyện mà còn trong Agent và các tính năng sử dụng định dạng Anthropic.
- Mở Tùy chọn khác sẽ có các trường OpenAI Responses, Google Gemini, URL cơ sở tạo ảnh và URL cơ sở chỉnh sửa ảnh. Bạn có thể để trống các trường không sử dụng.
- Sau khi lưu, hãy kiểm tra xem nhà cung cấp có đang ở trạng thái Bật trên màn hình nhà cung cấp hay không. Theo tài liệu chính thức, nếu vẫn bị tắt dù đã cấu hình thì mô hình sẽ không xuất hiện trong danh sách lựa chọn. Đây là nguyên nhân phổ biến nhất của lỗi «khóa không hoạt động».
- Dùng Đồng bộ mô hình trong danh sách mô hình để nhập các mô hình, thêm những mô hình muốn sử dụng, rồi dùng Kiểm tra để kiểm tra hoạt động của một mô hình.
Cách nhập địa chỉ: chỉ nhập URL gốc
Trong mã nguồn v2.1.4, nếu địa chỉ gốc nhập vào một trường chưa có phần phiên bản thì ứng dụng sẽ thêm /v1 (nếu đã có thì không thêm), sau đó bổ sung đường dẫn tương ứng với từng trường. Bên dưới mỗi trường có hiển thị URL cuối cùng dưới dạng «Đường dẫn yêu cầu», vì vậy hãy kiểm tra tại đó trước khi lưu.
| Trường | Đường dẫn Cherry Studio thêm | Kunavo |
|---|---|---|
| OpenAI | /chat/completions | Được hỗ trợ |
| Tin nhắn Anthropic | /messages | Được hỗ trợ |
| OpenAI Responses (Tùy chọn khác) | /responses | Được hỗ trợ |
| URL cơ sở tạo ảnh (Tùy chọn khác) | /images/generations | Được hỗ trợ |
| URL cơ sở chỉnh sửa ảnh (Tùy chọn khác) | /images/edits | Được hỗ trợ |
| Google Gemini (Tùy chọn khác) | /models/{model}:generateContent | Không được hỗ trợ — để trống |
Có hai điều không được làm. Nếu dán URL hoàn chỉnh bao gồm /chat/completions hoặc /messages, đường dẫn sẽ bị lặp và gây lỗi 404. Ký hiệu # ở cuối, như gợi ý trên màn hình, có tác dụng «tắt phiên bản API được tự động thêm»; nếu thêm vào endpoint tiêu chuẩn, /v1 sẽ bị thiếu.
Cấu hình mô hình mặc định để tránh lãng phí chi phí
Cherry Studio gọi mô hình ở chế độ nền cho nhiều việc ngoài trò chuyện. Mô hình nhanh được dùng cho «các tác vụ đơn giản như đặt tên chủ đề hoặc trích xuất từ khóa tìm kiếm», đúng như mô tả trên màn hình; phần gợi ý cũng yêu cầu «chọn mô hình nhẹ và tránh mô hình suy luận». Chỉ cần đặt một mô hình rẻ ở đây là bạn có thể tránh việc chạy mô hình đắt tiền trong mỗi cuộc trò chuyện. Bạn cũng có thể cấu hình riêng mô hình dịch. Hãy nhớ rằng khi chọn nhiều mô hình và hỏi đồng thời, sẽ có số yêu cầu riêng biệt bằng với số mô hình (= các khoản tính phí riêng biệt). Số tiền trong thống kê sử dụng của ứng dụng là ước tính dựa trên giá công khai, nên sẽ cao hơn thực tế đối với các tuyến có chiết khấu. Hãy thay đổi đơn giá trong phần cài đặt mô hình thành mức giá của bạn để có số liệu khớp. Xem thêm Cherry Studio API cost bằng tiếng Anh.
Cài đặt máy chủ MCP: kết nối công cụ bên ngoài
MCP là phương thức kết nối cho phép mô hình (Agent) sử dụng các công cụ hoặc dữ liệu bên ngoài. Quy trình trong tài liệu chính thức là Cài đặt → MCP → Máy chủ MCP → Thêm. Trong màn hình thêm, chỉ cần nhập thông tin kết nối ở «Tạo nhanh» là có thể tạo máy chủ; các mục còn lại có thể điều chỉnh sau.
| Loại (cách hiển thị trên màn hình) | Trường hợp sử dụng | Thông tin cần nhập |
|---|---|---|
| Đầu vào/đầu ra tiêu chuẩn (stdio) | Máy chủ chạy bằng lệnh trên máy cục bộ | Lệnh, đối số, biến môi trường |
| Sự kiện do máy chủ gửi (sse) | Dịch vụ từ xa cung cấp URL SSE | URL (và xác thực nếu cần) |
| HTTP có thể streaming | Dịch vụ từ xa cung cấp URL Streamable HTTP | URL (và xác thực nếu cần) |
種類 標準入力/出力 (stdio)
コマンド npx
引数 -y @modelcontextprotocol/server-filesystem /Users/you/notes
環境変数 （サーバーが求めるものだけ）- Chọn loại phù hợp với phương thức kết nối mà bên cung cấp hướng dẫn. Tài liệu cũng yêu cầu «nhập theo đúng cài đặt của bên cung cấp, không suy đoán từ tên».
- Lưu và bật máy chủ, rồi chờ trạng thái chuyển sang bình thường. Kiểm tra các tab «Công cụ», «Lời nhắc» và «Tài nguyên» trong phần chi tiết để xem máy chủ cung cấp những gì.
- Bật máy chủ đó tại Công việc → menu Agent → Chỉnh sửa → MCP. Máy chủ không tự động được gắn vào tất cả Agent.
- Bạn cũng có thể chèn lời nhắc MCP hoặc tài nguyên MCP mà máy chủ cung cấp từ dấu «+» trong trường nhập.
Vì mô hình là thành phần thực sự gọi công cụ MCP, hãy chọn mô hình hỗ trợ gọi công cụ. Các mô hình Claude hoặc GPT được thêm trong cài đặt nhà cung cấp ở trên đều hỗ trợ gọi công cụ. Theo khuyến nghị trong tài liệu, ban đầu hãy bật từng công cụ một để kiểm tra hoạt động; với các công cụ có thao tác ghi hoặc phát sinh phí, nên giữ nguyên cài đặt yêu cầu phê duyệt để đảm bảo an toàn. Ngay cả khi cài đặt từ «Máy chủ tích hợp» hoặc «Marketplace» của MCP, hãy kiểm tra nội dung lệnh và biến môi trường.
Lưu ý và thanh toán khi sử dụng Kunavo
- Phạm vi xác minh. Cấu hình này được xây dựng từ mã nguồn và tài liệu chính thức của Cherry Studio, không phải từ việc Kunavo thực sự kết nối Cherry Studio với endpoint của mình và kiểm thử. Hãy thử nghiệm trong khi vẫn giữ nguyên tuyến hiện đang hoạt động.
- Tuyến của Kunavo chỉ dành cho trò chuyện và hình ảnh. Vì không có mô hình embedding, tìm kiếm vector trong cơ sở tri thức cần một nhà cung cấp khác hoặc mô hình embedding cục bộ (tài liệu giải thích rằng vẫn có thể hoạt động bằng tìm kiếm từ khóa BM25 mà không cần embedding).
- Thanh toán. Nạp tiền trả trước, không có phí thuê bao hàng tháng, số dư được trừ theo token. Mức nạp tối thiểu là $10, tại trang thanh toán Stripe có thể dùng thẻ (Visa, Mastercard, American Express, JCB), Apple Pay, Google Pay và Link. Hãy xem Hướng dẫn thanh toán, tạo tài khoản và cấp khóa. Trang thiết lập bằng tiếng Anh là Cherry Studio integration guide.
Câu hỏi thường gặp
Thiết lập khóa API riêng trong Cherry Studio thế nào?
Vào Cài đặt → Nhà cung cấp mô hình → Thêm nhà cung cấp để mở hộp thoại “Thêm nhà cung cấp tùy chỉnh”, rồi nhập tên nhà cung cấp, khóa API và địa chỉ gốc vào các trường OpenAI và Anthropic Messages trong phần cấu hình endpoint, sau đó lưu. Tiếp theo, dùng “Đồng bộ mô hình” trong danh sách mô hình để nhập mô hình, thêm mô hình cần dùng và nhấn “Kiểm tra” để xác nhận một mô hình. Lưu ý rằng nhà cung cấp phải được bật thì mô hình mới xuất hiện trong lựa chọn mô hình.
Địa chỉ API của Cherry Studio có cần /v1 không?
Cả hai đều được. Trong mã nguồn v2.1.4, nếu địa chỉ gốc nhập vào chưa có phần phiên bản (/v1), hệ thống tự thêm vào; nếu đã có thì giữ nguyên. Sau đó, hệ thống thêm đường dẫn theo từng trường (OpenAI thêm /chat/completions, Anthropic thêm /messages). Không nên dán URL hoàn chỉnh có cả /chat/completions, vì đường dẫn sẽ bị lặp và gây 404. Ký tự # ở cuối ngăn tự động thêm phiên bản, nên không thêm vào endpoint tiêu chuẩn. Có thể kiểm tra URL cuối cùng trong “Đường dẫn yêu cầu” hiển thị bên dưới từng trường.
Cấu hình máy chủ MCP của Cherry Studio ở đâu?
Theo hướng dẫn chính thức, vào Cài đặt → MCP → Máy chủ MCP → Thêm. Lệnh cục bộ thường dùng đầu vào/đầu ra tiêu chuẩn (stdio), còn dịch vụ từ xa thường dùng SSE hoặc Streamable HTTP; nhập theo cấu hình của bên cung cấp. Sau khi lưu, bật máy chủ và kiểm tra các công cụ được cung cấp trong tab “Công cụ” của phần chi tiết, rồi vào Công việc → menu Agent → Chỉnh sửa → MCP để bật máy chủ đó. Vì mô hình là bên gọi công cụ, hãy chọn mô hình hỗ trợ gọi công cụ.
Cherry Studio có miễn phí không?
Phiên bản máy tính để bàn (bản cộng đồng) là phần mềm mã nguồn mở miễn phí theo AGPL-3.0. Chi phí phát sinh là phí sử dụng mô hình của nhà cung cấp mà bạn đã cấu hình. Cherry Studio Enterprise là một sản phẩm riêng, tính phí theo báo giá; CherryAI tích hợp sẵn thì miễn phí, nhưng cấu hình mô hình và hạn mức chưa được công bố.
Phải làm gì khi «Đồng bộ mô hình» không hiển thị gì?
Nút này dùng địa chỉ và khóa bạn nhập để lấy danh sách mô hình của nhà cung cấp (/v1/models), nên nếu danh sách trống, trước hết hãy nghi ngờ địa chỉ hoặc khóa. Kiểm tra xem bạn có dán URL hoàn chỉnh hay thêm # ở cuối không, rồi dùng curl thử cùng tổ hợp đó. Nếu trả về JSON thì vấn đề nằm ở ứng dụng; nếu là 401 thì khóa có vấn đề.
Đã kiểm tra ngày 1 tháng 10 năm 2026: GitHub API (CherryHQ/cherry-studio, v2.1.4), các chuỗi UI tiếng Nhật của v2.1.4 (ja-jp.json), mã nguồn màn hình thêm nhà cung cấp và trang MCP trong tài liệu chính thức của Cherry Studio. Kunavo chưa chạy Cherry Studio với endpoint của mình.