Cherry Studio 怎么开 MCP

Cherry Studio 是开源桌面 AI 客户端，仓库在 CherryHQ/cherry-studio。对话本身只会说话。要把文件系统、网页、GitHub、数据库这类外部能力接进去，走的是 MCP（Model Context Protocol）。下面按官方文档把「加服务器 → 启动看工具 → 绑到助手或 Agent」跑通，并记下几个常见翻车点。

官方说明：MCP 与外部工具、环境依赖。项目主页：cherry-ai.com。

先分清三件事

Cherry 里能增强 Agent 的能力有四类，别混着用：

能力	解决什么	例子
内置工具	应用自己就能做的操作	读写工作目录、网页搜索、画图、记忆
知识库	能检索哪些私有资料	产品规范、合同、团队手册
技能	按什么流程和格式干活	周报模板、代码审查清单
MCP	连哪些外部系统和第三方工具	数据库、浏览器自动化、业务 API

只是按固定格式写周报，用技能就够。只查自己丢进去的文档，绑知识库。真要连 Notion、GitHub 或公司里的只读库，再上 MCP。官方也写了：别为了「更高级」硬接一套。

环境先补齐

本地 stdio 服务通常靠 uv（Python 包）或 bun / npx（JS）。Cherry 把这些收在【设置】→【环境依赖】，可以一键装进应用目录，不必先污染系统 PATH。

报错「找不到 uv / bun / 命令不存在」时，先回这个页面看状态是不是「内置」或已安装。右上角那个按钮是检查更新，不是重装系统工具。直连 GitHub 慢，可以在高级安装设置里填镜像。

模型也要支持工具调用。Claude、GPT 系列、不少国内模型在 Cherry 里都能走 MCP。纯补全、不带 function call 的模型，服务器开了也调不起来。先用你已经验证过会调工具的那一档。

添加一台 MCP 服务器

路径：【设置】→【MCP】→【MCP 服务器】→【添加】。

Cherry 自己管服务器列表，不会去读 Claude Desktop 那种 mcp.json。从别的客户端复制来的 JSON 块没有地方可贴，得在界面里按字段填：类型、命令、参数、环境变量，或远程 URL。

选连接方式

本地命令：stdio。填命令、参数、环境变量。常见命令是 uvx 或 npx。
远程服务：SSE 或 Streamable HTTP。填 URL，有的还要授权。

按服务提供方给的配置填，不要凭名字猜传输类型。保存前看一眼：命令从哪来、能碰到哪些目录或账号。密钥只放服务器配置的环境变量字段，不要写进助手提示词、技能或截图。

先验证一台

新加完先只启用这一台。等状态正常，打开详情看它声明了哪些工具、资源和提示词。工具可以展开看参数、类型和必填标记，别只看名字就猜输入格式。

连接失败先看服务器日志。常见原因是运行时没装、包名写错，或应用继承的 PATH 里没有 npx / uvx（改成绝对路径，或回环境依赖页补一份）。

两个能直接抄的起步配置

字段以各仓库当前 README 为准，下面两台适合当「第一台」。参数在界面里每个占一行。

1. 抓网页：fetch

类型：stdio
命令：uvx
参数：mcp-server-fetch

保存并启用，详情里应能看到 fetch 相关工具。对话里让它抓一个公开页面，再看调用链里有没有真正打到工具。这台不碰本地文件，适合确认「MCP 整条链路是通的」。

2. 读本地目录：filesystem

参考实现在 modelcontextprotocol/servers。常见填法：

类型：stdio
命令：npx
参数：-y、@modelcontextprotocol/server-filesystem、再加一个你允许它访问的绝对路径

路径尽量收到项目目录，不要把整个家目录丢进去。包名如果安装失败，回到该仓库 README 抄当前命令，官方参考服务器偶尔会改包路径。

远程服务则选 SSE 或 Streamable HTTP，把提供方给的 URL 贴进地址栏。企业内部署常见这条。

绑到助手或 Agent

服务器显示「已连接」还不等于对话能用，还要绑定。

助手：编辑该助手，打开 MCP 标签，勾选服务器。
Agent：【工作】→ Agent 菜单 →【编辑】→【MCP】，启用对应服务器。未启动的服务器绑不上。

官方建议不要自动绑全部。无关工具会占上下文，也更容易误调用。一次只给当前任务需要的那几台。

改完绑定后发一条新消息，运行时才会加载新工具。正在生成的回复不会自动带上。

对话输入区的【+】面板里，还可以插入该服务器提供的 MCP 提示词和资源。较短的文本会直接进输入框，较大的文件作为引用，由支持工具调用的模型在需要时读取。看不到这两项时，先回服务器详情确认它真的提供了，再确认当前助手或 Agent 已绑定。

写入、删文件、改数据库、可能计费的调用，权限模式优先留在逐次确认。频道里给 Agent 用时更该收紧。

内置服务器和市场

【内置 MCP】里有一批可直接安装的常用能力，【服务市场】管第三方来源。内置不等于零风险：列表会标明要不要账号、API Key、目录权限，装完仍要自己配完并验证连接。

QVeris 在内置列表里，用来发现和检查外部能力，装完要配 QVERIS_API_KEY。密钥同样只放服务器环境变量。

另外，联网搜索默认还有 Exa MCP（公开端点、免密钥），那是【设置】→【网络搜索】里的搜索服务商，和上面自己加的 MCP 服务器不是同一处开关。对话输入框点地球图标走的是联网搜索，不是你刚加的 filesystem。

常见翻车

现象	先查
服务器加上就退出	`uv` / `bun` 有没有装；命令和参数有没有抄错；`npx` 改成绝对路径试试
终端里能跑，Cherry 里不行	应用没吃到登录 shell 的 PATH；用环境依赖页的副本，或填绝对路径
显示已连接，Agent 找不到工具	有没有绑到这个 Agent；工具是不是被关掉；权限请求是不是还待确认；发一条新消息
模型说它没工具	当前对话用的模型支不支持工具调用；助手 MCP 开关开了没
同时开一堆全红	先全停，只留一台验证

MCP 和 API 网关不要搞反：MCP 是把外部工具接进 Cherry；API 网关是把 Cherry 的模型能力提供给别的程序。数据流方向相反。

小结

Cherry 开 MCP 就三步：环境依赖里把 uv / bun 补齐，设置里加并启动服务器，再绑到具体助手或 Agent。一次只验证一台，密钥只放环境变量。配置、绑定和排错以 MCP 与外部工具为准。