Skip to main content
在本教程中,你将扩展Claude桌面版的功能,使其能够读取计算机的文件系统、写入新文件、移动文件,甚至搜索文件。
别担心 — 在执行这些操作之前,它会征求你的许可!

​
1. 下载Claude桌面版

首先下载Claude桌面版,选择macOS或Windows版本。(目前Claude桌面版尚不支持Linux系统。) 按照安装说明进行安装。 如果你已经安装了Claude桌面版,请确保它是最新版本 — 点击电脑上的Claude菜单并选择”检查更新…”。
因为服务器是本地运行的,MCP目前仅支持桌面主机。远程主机功能正在积极开发中。

​
2. 添加文件系统MCP服务器

为了添加这个文件系统功能,我们将在Claude桌面版中安装一个预构建的文件系统MCP服务器。这是由Anthropic和社区创建的数十个服务器之一。 首先,打开电脑上的Claude菜单并选择”设置…”。请注意,这不是应用程序窗口中的Claude账户设置。 在Mac上应该是这样的:
点击设置窗格左侧栏的”开发者”,然后点击”编辑配置”:
如果你还没有配置文件,这将在以下位置创建一个配置文件:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
并在你的文件系统中显示该文件。 用任意文本编辑器打开配置文件。将文件内容替换为:
  • MacOS/Linux
  • Windows
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}
确保将username替换为你的计算机用户名。这些路径应指向你希望Claude能够访问和修改的有效目录。默认设置为桌面和下载文件夹,但你也可以添加更多路径。 你还需要在计算机上安装Node.js才能正常运行。要验证是否已安装Node,请打开计算机的命令行。
  • 在macOS上,从应用程序文件夹打开终端
  • 在Windows上,按Windows + R,输入”cmd”,然后按回车
在命令行中,输入以下命令验证是否已安装Node: 
node --version
如果出现”command not found”或”node is not recognized”错误,请从nodejs.org下载Node。
配置文件是如何工作的?这个配置文件告诉Claude桌面版在每次启动应用程序时要启动哪些MCP服务器。在这个例子中,我们添加了一个名为”filesystem”的服务器,它将使用Node的npx命令来安装和运行@modelcontextprotocol/server-filesystem。这个服务器(在这里有详细说明)将让你在Claude桌面版中访问文件系统。
命令权限Claude桌面版将使用你的用户账户权限运行配置文件中的命令,并可以访问你的本地文件。只有在你理解并信任来源的情况下才添加命令。

​
3. 重启Claude

更新配置文件后,你需要重启Claude桌面版。 重启后,你应该会在输入框的右下角看到一个锤子图标:
点击锤子图标后,你应该能看到文件系统MCP服务器提供的工具:
如果你的服务器没有被Claude桌面版识别,请查看故障排除部分获取调试提示。

​
4. 试一试!

现在你可以与Claude对话并询问有关文件系统的问题。它会知道何时调用相关工具。 你可以尝试问Claude这些问题:
  • 能帮我写一首诗并保存到桌面吗?
  • 我的下载文件夹里有哪些工作相关的文件?
  • 能把我桌面上的所有图片都移动到一个名为”Images”的新文件夹吗?
根据需要,Claude会调用相关工具并在采取行动前征求你的批准:

​
故障排除

  1. 完全重启Claude桌面版
  2. 检查claude_desktop_config.json文件语法
  3. 确保claude_desktop_config.json中包含的文件路径有效,且是绝对路径而不是相对路径
  4. 查看日志以了解服务器未连接的原因
  5. 在命令行中,尝试手动运行服务器(像在claude_desktop_config.json中那样替换username)看是否有错误:
  • MacOS/Linux
  • Windows
npx -y @modelcontextprotocol/server-filesystem /Users/username/Desktop /Users/username/Downloads
与MCP相关的Claude.app日志文件位于:
  • macOS: ~/Library/Logs/Claude
  • Windows: %APPDATA%\Claude\logs
  • mcp.log包含有关MCP连接和连接失败的常规日志。
  • 名为mcp-server-SERVERNAME.log的文件包含来自指定服务器的错误(stderr)日志。
你可以运行以下命令列出最近的日志并跟踪新日志(在Windows上,它只会显示最近的日志):
  • MacOS/Linux
  • Windows
# 检查Claude的错误日志
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
如果Claude尝试使用工具但失败:
  1. 检查Claude的日志是否有错误
  2. 验证你的服务器是否能正常构建和运行
  3. 尝试重启Claude桌面版
请参考我们的调试指南获取更好的调试工具和更详细的指导。
如果你配置的服务器无法加载,并且在其日志中看到与路径中的${APPDATA}相关的错误,你可能需要在claude_desktop_config.json的env键中添加%APPDATA%的展开值:
{
  "brave-search": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-brave-search"],
    "env": {
      "APPDATA": "C:\\Users\\user\\AppData\\Roaming\\",
      "BRAVE_API_KEY": "..."
    }
  }
}
完成这些更改后,再次启动Claude桌面版。
NPM应该全局安装如果你没有全局安装NPM,npx命令可能会继续失败。如果已经全局安装了NPM,你的系统上会存在%APPDATA%\npm。如果没有,你可以通过运行以下命令全局安装NPM:
npm install -g npm

​
下一步

探索其他服务器

查看我们的官方MCP服务器和实现示例库

构建你自己的服务器

现在开始构建你自己的自定义服务器,以在Claude桌面版和其他客户端中使用