1. 为什么要在 Cherry Studio 里接 Filesystem MCP Server
Cherry Studio 是一款面向国内用户的桌面 AI 客户端，支持多模型调度、知识库管理、AI 绘画、翻译等功能，所有使用数据都保存在本地，不会上传到第三方服务器。它内置了 300+ 预设助手，覆盖编程、写作、翻译等场景，也支持通过 MCP 服务器扩展能力。Filesystem MCP Server 则是 MCP 官方仓库里的一个服务端实现，把文件系统操作（读文件、写文件、建目录、搜索文件等）暴露成 MCP 协议定义的标准接口，让遵守 MCP 协议的模型能安全地和本地文件系统交互。
把这两者拼在一起，你得到的就是一个「个人智能文件助手」：用自然语言说「我桌面下有哪些文件」「帮我在桌面建一个 report.txt」「把这段回答写进 report.txt」，模型识别意图后通过 MCP 服务端真正去操作本地文件。整个过程不需要你手动敲命令，也不需要把文件上传到任何云端。
但实际搭起来的时候，很多人会卡在两个地方。第一是 MCP 服务端的配置格式，JSON 里 command、args 写错一个字符就连不上；第二是模型调用链路，Cherry Studio 默认走的是各家云服务商的 API，如果你想让所有模型请求统一走一个通道，就得把 endpoint 改到 TaoToken 的 API 地址上。这篇就按「MCP 服务声明 → 工具权限 → 模型调用链路」的顺序，把每一步拆开讲清楚，配置片段可以直接复制。
适合谁看：已经装了 Cherry Studio、想用自然语言管本地文件的人；想把 MCP 工具调用和统一 API 通道串起来的人；以及配了 MCP 但发现模型不调用工具、或者报 401 的人。下面从环境准备开始，一步步来。
2. TaoToken 前置：统一 Key 与 API 通道怎么准备
在 Cherry Studio 里，模型服务是单独配置的。你可以给每个供应商填各自的 API Key，也可以把所有请求统一指向一个兼容 OpenAI 协议的 endpoint。后者在管理多个模型、多个助手的时候更省事，因为 Key 和 Base URL 只需要维护一份。TaoToken 就是这样一个统一通道，它提供兼容 OpenAI 格式的 API，你拿到一个 Key，就能在 Cherry Studio 里调用它支持的模型。
先拿 Key。打开 https://taotoken.net/api-keys ，登录后创建一个 API Key，复制出来。这个 Key 后面要填到 Cherry Studio 的模型服务配置里。注意 Key 只在创建时完整显示一次，先存到安全的地方。
然后是 Base URL。TaoToken 的 API 地址是 https://taotoken.net/api ，注意这里不带任何查询参数，直接填这个就行。Cherry Studio 在配置 OpenAI 兼容服务商时，会要求填「API 地址」和「API 密钥」两项，分别对应这两个值。
模型 ID 这块，你需要填 TaoToken 支持的模型标识。比如你想用某个通用对话模型，就在「模型」字段里填对应的 Model ID。具体有哪些模型可用，可以在 https://taotoken.net/doc 的文档里查，或者在 https://taotoken.net/console 的控制台里看可用模型列表。填的时候注意大小写和连字符，Model ID 写错会直接报模型不存在。
如果你后面打算长期用这个助手做编码或者 Agent 类任务，可以了解一下 Coding Plan，地址是 https://taotoken.net/coding-plan 。它面向的是持续性的编码场景，和单次对话的计费方式不太一样。不过这篇的重点是文件助手，先用按量调用的方式把链路跑通就行。
准备工作就这三样：API Key、Base URL（https://taotoken.net/api）、Model ID。拿到之后，先别急着配 MCP，先把模型服务配好，确认能正常对话，再去接 Filesystem MCP Server。顺序反了的话，出了问题不好定位是模型通道的问题还是 MCP 的问题。
3. 可复制配置：MCP 服务声明与模型通道填写
这一节给两份配置，一份是 Cherry Studio 的模型服务配置（走 TaoToken 通道），一份是 Filesystem MCP Server 的声明。两份都配好，链路才算通。
先说模型服务。打开 Cherry Studio，点左下角设置，选「模型服务」。在供应商列表里选一个支持自定义 API 地址的项，比如 OpenAI 兼容类型。填入：
- API 地址：https://taotoken.net/api
- API 密钥：你刚才创建的 Key
- 模型：填你要用的 Model ID
填完点右上角开关启用该服务。然后到「默认模型」里，把默认助手模型选成你刚配的这个。这样对话请求就会走 TaoToken 的通道。
接下来是 MCP 服务声明。点设置里的「MCP 服务器」，点右上角「添加服务器」，选「从 JSON 导入」。把下面这段贴进去：
{ "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "C:\\Users\\你的用户名\\Desktop", "C:\\Users\\你的用户名\\Downloads" ] } } }这段配置的意思是：用 npx 拉起@modelcontextprotocol/server-filesystem这个包，后面跟的两个路径是允许该服务端访问的目录。路径要换成你自己的实际路径。Windows 下反斜杠要写成双反斜杠，macOS 或 Linux 下写成/Users/你的用户名/Desktop这种形式。允许访问的目录就是工具权限的边界，服务端只会在这两个目录里读写，超出范围的路径会被拒绝。
如果你本机没装 Node.js，npx 会跑不起来。先去 https://nodejs.org/zh-cn 下载安装包，装完在终端执行node --version，能打印出版本号就说明装好了。我这边实测是 v22.17.0，正常。
保存 JSON 后，Cherry Studio 会创建这个 MCP 服务器。你可以在列表里看到 filesystem 这一项，状态应该是已连接。如果显示未连接，先检查 Node.js 是否可用、路径是否存在、JSON 有没有语法错误。
然后创建助手。点「添加助手」，可以选一个预设助手作为基础，比如「默认助手」，重命名为「智能文件助手」。在助手的系统提示词里，明确写出允许访问的目录路径，比如「你可以访问我的桌面和下载目录，桌面路径是 C:\Users\你的用户名\Desktop，下载目录是 C:\Users\你的用户名\Downloads」。这样模型在调用工具时更容易填对路径。
最后在助手设置里，把模型选成走 TaoToken 通道的那个，并在 MCP 服务器那一栏勾选 filesystem。到这里，模型通道和 MCP 工具就都挂上了。
4. 验证请求：一次文件检索与写入的完整动作
配置完别急着下复杂指令，先用两个动作验证工具调用是否真的生效。第一个是检索，第二个是写入。
打开「智能文件助手」的对话窗口，输入：
我的桌面下有哪些文件？正常情况下，模型会识别出这需要调用 filesystem 的list_directory工具，然后在回复里列出桌面下的文件和目录，并用[FILE]或[DIR]标记类型。如果你看到的是模型直接编了一段回答、没有真正列目录，说明工具没被调用，回到上一节检查 MCP 是否勾选、服务是否已连接。
第二个动作，创建并写入文件。输入：
在我的桌面上创建一个文件，文件名为 report.txt模型会调用write_file或create_directory相关工具，在桌面生成 report.txt。你可以直接去桌面看，文件应该已经出现了。
接着验证写入内容：
为什么天空是蓝色的？把这个问题的回答保存到桌面上的 report.txt这一步会触发模型先回答内容，再调用write_file把内容写进 report.txt。打开文件确认，里面应该有完整的回答文本。
这两个动作跑通，说明整条链路是通的：Cherry Studio 把自然语言发给模型，模型通过 TaoToken 通道返回工具调用意图，Cherry Studio 再把这个意图转给 Filesystem MCP Server，服务端在允许的目录里执行操作，结果回传给模型，模型组织成自然语言回复。任何一环断了，你都会看到异常。
如果你想更直观地确认工具调用，可以在对话里观察是否有工具调用的折叠块或者状态提示。Cherry Studio 在模型调用 MCP 工具时会有相应的展示，点开能看到调用了哪个工具、传了什么参数、返回了什么结果。这个对排障很有用。
5. 常见错排查：401、local proxy failed、reading choices、OAuth
配 MCP 和统一通道的时候，报错基本集中在几类。下面按真实报错对照着排。
401 Unauthorized。这个几乎都是 Key 的问题。检查三处：Key 有没有复制完整（前后有没有多空格）、Key 有没有被禁用或删除、Base URL 是不是填成了 https://taotoken.net/api 而不是别的地址。如果 Key 是对的但还报 401，去 https://taotoken.net/console 看下这个 Key 的状态和额度。另外注意，模型服务配置里的 Key 和 MCP 服务声明是两回事，MCP 的 JSON 里不需要填 Key，别把 Key 塞进 mcpServers 的 args 里。
local proxy failed / connection refused。这个通常出现在模型服务这一侧，说明 Cherry Studio 连不上你填的 API 地址。先确认 Base URL 写的是 https://taotoken.net/api ，没有多余路径。再确认本机网络能正常访问这个地址。如果你在 Cherry Studio 里开了代理相关的设置，先关掉再试。MCP 服务端本身是本地进程，不走网络，所以这个报错一般和 MCP 无关。
reading 'choices' / Cannot read properties of undefined (reading 'choices')。这个报错说明 Cherry Studio 收到了响应，但响应结构里没有choices字段，它按 OpenAI 格式去解析就崩了。常见原因是 Base URL 填错，请求打到了非兼容 OpenAI 格式的地址上，返回了 HTML 或者别的结构。确认地址是 https://taotoken.net/api ，并且模型 ID 填的是通道支持的模型。如果模型 ID 不存在，有些实现会返回错误结构，也会触发这个报错。
OAuth / authentication failed。如果你在 MCP 服务声明里用了需要 OAuth 的第三方服务端，可能会遇到这个。Filesystem MCP Server 是本地进程，不需要 OAuth，所以这个报错一般和你接的其他 MCP 服务有关。检查那个服务端的配置，确认认证方式填对了。如果你同时挂了多个 MCP 服务器，先只留 filesystem，确认它能用，再逐个加回来。
工具不调用 / 模型说它没有文件访问能力。这个不是报错，但很常见。原因通常是助手没有勾选 filesystem 这个 MCP 服务器，或者系统提示词里没写清楚允许访问的路径。回到助手设置，确认 MCP 那一栏 filesystem 是勾上的，系统提示词里把目录路径写明确。
路径被拒绝 / access denied。Filesystem MCP Server 只允许访问配置里列出的目录。如果你让它操作桌面和下载目录之外的文件，会被拒绝。这是设计上的权限边界，不是 bug。要访问别的目录，就在 MCP 配置的 args 里加上对应路径，保存后重启服务。
排障的时候，建议按「模型通道 → MCP 连接 → 工具调用」的顺序逐层确认。先确保模型能正常对话（不涉及文件），再确保 MCP 服务显示已连接，最后再测工具调用。这样出问题能快速定位到是哪一层。
6. 把链路固定下来：日常使用与后续扩展
链路跑通之后，日常用起来就很直接了。你可以把「智能文件助手」固定成一个常用助手，需要整理文件、批量重命名、搜索内容的时候直接切过去。比如「把下载目录里所有 .zip 文件列出来」「在桌面建一个 projects 目录」「读一下 report.txt 的内容」，这些都是 Filesystem MCP Server 已经暴露的工具能覆盖的。
如果你想让这个助手更顺手，可以在系统提示词里把常用目录和操作习惯写清楚，减少模型猜路径的次数。也可以给不同的用途建不同的助手，比如一个专门管下载目录的、一个专门管项目文档的，各自勾选对应的 MCP 配置。
后续想扩展的话，Cherry Studio 支持添加多个 MCP 服务器。你可以在同一个助手下面挂 filesystem 和其他 MCP 服务，让模型按需调用。每加一个服务，记得回到「工具权限」这个思路：这个服务能访问什么、边界在哪、会不会碰到不该碰的数据。Filesystem 的边界就是配置里的目录列表，其他服务各有各的权限模型，加之前先看清楚。
模型通道这边，如果你后面要换模型或者加模型，只需要在 TaoToken 的模型服务配置里改 Model ID，MCP 那边的配置不用动。这也是把模型通道和工具通道分开配的好处：换模型不影响工具，加工具不影响模型。需要查可用模型和文档的时候，去 https://taotoken.net/doc ；要管理 Key 和看用量，去 https://taotoken.net/console 。想直接试模型对话效果，可以用 https://taotoken.net/model-chat 。长期做编码类任务的话，Coding Plan 在 https://taotoken.net/coding-plan 。
最后提醒一句：Filesystem MCP Server 的写操作是真实的，write_file会覆盖同名文件。测试的时候先用不重要的目录，确认行为符合预期再放到常用目录上。允许访问的目录列表也别图省事写成整个用户目录，按需给，够用就行。
