Cherry Studio 接入中转站并调用 MCP 配置指南

# CherryStudio 接入中转站并调用 MCP 教程

> 适用对象：CherryStudio 桌面客户端（Windows / macOS / Linux）  
> 中转站地址：`https://api.zaimod.com`  
> 目标：让 CherryStudio 通过中转站使用 Claude 模型，并在对话中真正调起 MCP 工具（读文件、抓网页等）

---

## 一、开始之前

### 1.1 准备清单

| 项目      | 应该填什么                       | 说明                                                          |
| ------- | --------------------------- | ----------------------------------------------------------- |
| 提供商类型   | **Anthropic**               | 决定客户端走 `/v1/messages` 协议，不是 OpenAI 的 `/v1/chat/completions` |
| API 密钥  | `sk-` 开头的令牌                 | 中转站控制台「API 令牌」页新建                                           |
| API 地址  | `https://api.zaimod.com`     | 只写到域名，不带 `/v1`                                              |
| 模型 ID   | 如 `claude-sonnet-4-5`       | 以控制台模型列表的实际 ID 为准                                           |
| MCP 服务器 | 至少一个，如 `@cherry/filesystem` | 需先在「设置 → MCP 服务器」里添加                                        |

### 1.2 两件容易搞混的事

**① CherryStudio 会自动补路径，不要再手写 `/v1`**

不同提供商类型的默认拼接规则不同：

| 提供商类型         | 客户端实际请求的路径                 |
| ------------- | -------------------------- |
| OpenAI        | `<地址>/v1/chat/completions` |
| **Anthropic** | `<地址>/v1/messages`         |

所以 API 地址只填 `https://api.zaimod.com` 就行。写成 `https://api.zaimod.com/v1` 会变成 `/v1/v1/messages`，直接 404。

CherryStudio 的地址栏还支持两个后缀约定（填完地址后，下方灰字会提示当前拼接结果）：

- 地址**以 `/` 结尾** → 忽略默认的版本段
- 地址**以 `#` 结尾** → 强制完全按你输入的内容请求，不做任何拼接

正常情况用不到这两个技巧，只在遇到版本段重复时才需要。

**② MCP 和「能聊天」是两回事**

模型能回复 ≠ MCP 能用。MCP 工具调用要求：模型本身支持工具调用（Claude 全系支持）+ 客户端已配好 MCP 服务器 + 当前会话里把该服务器勾选上。三者缺一，就会出现「问了文件，AI 却只讲理论」的情况。

---

## 二、安装与准备 MCP 服务器

### 步骤 1 · 安装 CherryStudio

下载地址（官方）：`https://docs.cherry-ai.com/cherry-studio/download`

按系统选对应安装包，装完直接打开。

### 步骤 2 · 添加 MCP 服务器

原文这里只给了一个官方文档链接，没有写具体操作。实际路径是：

**设置（左下角齿轮）→ MCP 服务器 → 添加服务器**

- 有内置市场的版本：在「市场」里搜 `filesystem`、`fetch` 等，点安装即可，客户端会自己写好启动命令。
- 没有市场的老版本：手动填写命令，例如文件系统服务

```json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:\\"]
    }
  }
}
```

> `C:\\` 是该服务被**允许访问**的目录，可自行改成工作目录。范围给得越小越安全。  
> 官方 MCP 说明：`https://docs.cherry-ai.com/advanced-basic/mcp`

配好后在 MCP 服务器列表里应能看到它，状态为可用。

---

## 三、配置中转站

### 步骤 3 · 添加 Anthropic 类型提供商

左下角点 **设置（齿轮）** → 左侧「模型服务」区 → 滚到最下面点 **「+ 添加」**。

弹窗里填两项：

| 字段    | 填什么                 |
| ----- | ------------------- |
| 提供商名称 | 随便填，如 `cxhao`，只是显示名 |
| 提供商类型 | 下拉选 **Anthropic**   |

点 **确定**。

![](/uploads/editor/20261031/img_6ae5f09079d9e2.02897225.png)

*① 设置 → ② 底部「+ 添加」→ ③ 名称随意 + 类型选 Anthropic → 确定*

> 类型必须选 **Anthropic**。选成 OpenAI 也能填地址和密钥，但请求会走 `/v1/chat/completions`，Claude 模型在这条路径上的工具调用行为不一致，后面的 MCP 步骤容易失败。

### 步骤 4 · 填密钥与地址

新增的提供商出现在列表里，点进去配置：

1. 右上角**开关打开**（绿色为启用）
2. **API 密钥**：粘贴你的 `sk-` 令牌
3. **API 地址**：填 `https://api.zaimod.com`

![](/uploads/editor/20261031/img_6ae5f09b488247.14770081.png)

*红字处填中转地址；下方灰字是客户端实时提示的最终请求路径*

填完可以点密钥右侧的 **「检测」** 按钮试一下连通性。检测通过只代表密钥与地址能通，**不代表模型名正确**，模型仍要以步骤 5 的 ID 为准。

---

## 四、添加模型

### 步骤 5 · 逐个添加模型

在提供商配置页下方找到 **「模型」** 区域，点 **「+ 添加」**，弹窗三个字段：

| 字段    | 填什么            | 说明                  |
| ----- | -------------- | ------------------- |
| 模型 ID | 中转站里的**准确**模型名 | 必填，写错就 404          |
| 模型名称  | 一般与 ID 相同      | 聊天界面顶部显示的名字，可自定义    |
| 分组名称  | 如 `claude-3`   | 仅用于客户端内归类，**不影响请求** |

![](/uploads/editor/20261031/img_6ae5f0a7eb5726.70106097.png)

*添加模型：模型 ID 必须与中转站模型列表一致*

![](/uploads/editor/20261031/img_6ae5f0b21e5a05.21294258.png)

*同一分组下可以继续添加多个模型，各自有独立 ID*

> 原文示例用的是 `claude-3-5-sonnet-20241022`、`claude-3-7-sonnet-20250219`，都属于较早的型号。**实际请打开中转站控制台的模型列表，复制当前可用的名称**，不要照抄示例。

### 步骤 6 · 确认模型已挂到提供商下

添加完成后，提供商页的模型区会按分组列出刚加的两个模型，每个后面带编辑与删除按钮。

![](/uploads/editor/20261031/img_6ae5f0bf8f3771.07475926.png)

*配置完成后的样子：密钥、地址、claude-3 分组下的两个模型*

---

## 五、配置 MCP 并验证

### 步骤 7 · 在对话页选择模型

回到聊天界面，点顶部中间当前的模型名，在列表里选中刚添加的 Claude 模型。

![](/uploads/editor/20261031/img_6ae5f0c9aa30f1.04939253.png)

*① 顶部选模型 → 底部工具栏打开 MCP 列表 → 勾选允许 AI 调用的服务*

### 步骤 8 · 勾选本次允许调用的 MCP 服务器

点输入框下方工具栏里的 **MCP 图标**（图中第三个方框图标），弹出服务器列表，里面是你在步骤 2 配好的服务（如 `fetch-server`、`@cherry/filesystem`）。

**选中要用的那个**。选中后图标会**亮起**（变成绿色高亮），表示本轮对话已授权该工具。

![](/uploads/editor/20261031/img_6ae5f0d8001c60.95447843.png)

*选中后图标亮起，是「已启用」的唯一视觉标志*

> 这一步是原文「6.开启mcp」真正对应的动作。没点亮就发问，模型看不到任何工具，只会回你一段"我无法直接访问你的磁盘"。

### 步骤 9 · 发送问题并判断是否真的调用了工具

输入需要工具才能完成的问题，例如：

```
看看我 C 盘都有哪些文件？
```

发送后，回复里会出现**工具调用卡片**，每张卡片带工具名和「已完成 ✓」状态：

![](/uploads/editor/20261031/img_6ae5f0e33fcb95.98057626.png)

*成功标志：出现 list_allowed_directories、list_directory 等工具卡片，且状态为「已完成」*

**判断标准（原文只写了「mcp调用成功」，这里给可核对的依据）：**

- ✅ 回复中出现了带工具名（`list_directory`、`list_allowed_directories` 等）的卡片，状态「已完成」→ MCP 真的被调用了
- ✅ 卡片里能看到 `response.content` 的结构化返回，例如允许访问的目录 `C:\`
- ❌ 只有纯文字回答、没有任何卡片 → 工具未启用或模型不支持工具调用

---

## 六、配置速查表

| 配置项      | 值                                 |
| -------- | --------------------------------- |
| 提供商类型    | **Anthropic**                     |
| API 密钥   | `sk-...`                          |
| API 地址   | `https://api.zaimod.com`（不带 `/v1`） |
| 模型 ID    | 控制台模型列表里的准确名称                     |
| 分组名称     | 任意（仅界面归类）                         |
| 请求路径（自动） | `/v1/messages`                    |
| MCP 启用位置 | 聊天页输入框下方 MCP 图标，选中后高亮             |
| 成功标志     | 回复中出现工具调用卡片且状态「已完成」               |

---

## 七、常见问题

| 现象                      | 原因                                  | 处理                                |
| ----------------------- | ----------------------------------- | --------------------------------- |
| 聊天报 404                 | API 地址带了 `/v1`，成了 `/v1/v1/messages` | 改成纯域名 `https://api.zaimod.com`     |
| 聊天报 401 / Invalid token | 密钥错、已删除，或复制时带了空格                    | 重新复制令牌，注意去掉首尾空格                   |
| 提示模型不存在                 | 模型 ID 与中转站列表不一致                     | 从控制台复制准确 ID，重新添加模型                |
| 问了文件，AI 说无法访问           | 本会话没勾选 MCP 服务器，或根本没添加过              | 回到步骤 2 添加，再在步骤 8 勾选并确认图标亮起        |
| MCP 列表里是空的              | 尚未添加任何 MCP 服务器                      | 设置 → MCP 服务器 → 添加                 |
| 工具卡片出现但报错               | 被访问目录不在 MCP 服务的允许范围内                | 修改服务器启动参数里的目录，如把 `C:\` 换成具体工作目录   |
| 检测通过但对话失败               | 「检测」只验连通性，不校验模型名                    | 重点核对模型 ID                         |
| 换模型后 MCP 失效             | 新模型不支持工具调用，或提供商类型不对                 | 用 Claude 系列模型，并确认提供商类型为 Anthropic |

---

## 附录 A · 原文勘误

这篇原文全长 795 字符，只有 6 个标题 + 8 张截图，问题集中在「缺步骤」和「截图来源不一致」：

1. **标题拼写错误**：`CherryStudio调用cluade MCP`，「cluade」应为「Claude」；且正文实际覆盖的是「接入中转站 + 调用 MCP」两件事，标题只提了后者。
2. **第 2 步只给链接，没有操作**：原文「2.mcp 配置教程」只有一条外链，读者不知道要在客户端哪里添加服务器。已补步骤 2 的具体路径与示例配置。
3. **第 4 步截图来自另一篇教程**：该图路径是 `plugins/5987397/551402.png`，与其他 7 张（`plugins/6458685/`）不同源。图里灰字显示的是 **`/v1/chat/completions`**，而第 3 步选的是 **Anthropic** 类型（应走 `/v1/messages`），两者对不上。本文按 Anthropic 类型说明，并解释了 CherryStudio 的 `/`、`#` 后缀约定。
4. **「3.配置中转」「4.配置key」实为同一步**：都在同一个提供商配置页完成，原文拆成两节还插入了一张不同来源的图，已合并为步骤 4。
5. **模型示例已过时**：`claude-3-5-sonnet-20241022`、`claude-3-7-sonnet-20250219` 是旧型号，照抄容易报模型不存在。已改为「以控制台列表为准」并给出核对方法。
6. **「分组名称」未解释**：容易误以为是中转站的计费分组。实际只是 CherryStudio 界面里的模型归类，已注明不影响请求。
7. **「6.开启mcp」没有说明操作对象**：原文只有两张图，未指出要点的是输入框下方的 MCP 图标、选中后图标会高亮。这是本章最关键的动作，已补文字说明。
8. **成功判据过于笼统**：原文只有一句「mcp调用成功」。已补充可核对的依据——回复中出现工具调用卡片且状态为「已完成」。
9. **地址写成带星号的文本**：原文该行是 `***API地址填写： …***`，而在 Markdown 中 `***` 是加粗斜体标记，导致这一行渲染错乱、域名可能被吃进格式里。已改为正文说明。

---

## 附录 B · 地址变更对照

| 位置              | 原地址                                    | 现地址                     |
| --------------- | -------------------------------------- | ----------------------- |
| 提供商配置页 → API 地址 | `https://api.zaimod.com`（原文被 `***` 包裹） | `https://api.zaimod.com` |
| 控制台入口（获取令牌）     | 原主站域名                                  | `https://api.zaimod.com` |

除域名外，路径拼接规则、提供商类型、参数均未改动。**旧平台令牌不能沿用**，需在新平台重新生成。

上一篇：Claude Code 中转站安装与配置指南{else}上一篇：没有了下一篇：Cherry Studio桌面端API基础配置教程{else}下一篇：没有了