Skip to main content
在本教程中，你将扩展 Claude for Desktop，使其可以从你计算机的文件系统中读取、写入新文件、移动文件，甚至搜索文件。
别担心 — 在执行这些操作之前，它会询问你的权限！

​
1. 下载 Claude for Desktop

首先下载 Claude for Desktop，选择 macOS 或 Windows。（Claude for Desktop 尚未支持 Linux。） 按照安装说明进行操作。 如果你已经有了 Claude for Desktop，请通过单击你计算机上的 Claude 菜单并选择“检查更新…”来确保它已更新到最新版本。
由于 servers 在本地运行，MCP 目前仅支持桌面 hosts。 远程 hosts 正在积极开发中。

​
2. 添加 Filesystem MCP Server

要添加此文件系统功能，我们将把预构建的 Filesystem MCP Server 安装到 Claude for Desktop。这是 Anthropic 和社区创建的众多 servers 之一。 首先，打开你计算机上的 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”，然后按 Enter
进入命令行后，通过输入以下命令来验证你是否安装了 Node： 
node --version
如果你收到一个错误，提示“找不到命令”或“未识别 node”，请从 nodejs.org 下载 Node。
配置文件如何工作？此配置文件告诉 Claude for Desktop 每次启动应用程序时启动哪些 MCP servers。 在这种情况下，我们添加了一个名为“filesystem”的 server，它将使用 Node 的 npx 命令来安装和运行 @modelcontextprotocol/server-filesystem。 此 server 在此处 进行了描述，它将让你在 Claude for Desktop 中访问你的文件系统。
命令权限Claude for Desktop 将使用你的用户帐户的权限运行配置文件中的命令，并访问你的本地文件。 仅添加你理解并信任来源的命令。

​
3. 重新启动 Claude

更新配置文件后，你需要重新启动 Claude for Desktop。 重新启动后，你应该在输入框的右下角看到一个锤子 图标：
单击锤子图标后，你应该会看到 Filesystem MCP Server 附带的 tools：
如果你的 server 没有被 Claude for Desktop 选中，请转到 故障排除 部分，以获取调试提示。

​
4. 试一试！

你现在可以与 Claude 交谈，并询问它关于你的文件系统的情况。 它应该知道何时调用相关的工具。 你可能尝试询问 Claude 的事情：
  • 你可以写一首诗并将其保存到我的桌面上吗？
  • 我的下载文件夹中有什么与工作相关的文件？
  • 你可以将桌面上的所有图像移动到一个名为“图像”的新文件夹中吗？
根据需要，Claude 将调用相关工具，并在采取操作之前征得你的同意：

​
故障排除

  1. 完全重新启动 Claude for Desktop
  2. 检查你的 claude_desktop_config.json 文件的语法
  3. 确保 claude_desktop_config.json 中包含的文件路径有效，并且它们是绝对路径而不是相对路径
  4. 查看 logs 以查看 server 未连接的原因
  5. 在你的命令行中，尝试手动运行 server（替换 username，就像你在 claude_desktop_config.json 中所做的那样），看看是否出现任何错误：
  • 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 的文件将包含来自命名 server 的错误 (stderr) 日志记录。
你可以运行以下命令来列出最近的日志并跟踪任何新的日志（在 Windows 上，它将仅显示最近的日志）：
  • MacOS/Linux
  • Windows
# 检查 Claude 的日志中是否有错误
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
如果 Claude 试图使用工具但失败了：
  1. 检查 Claude 的日志中是否有错误
  2. 验证你的 server 构建并运行，没有错误
  3. 尝试重新启动 Claude for Desktop
请参阅我们的 debug 指南，以获得更好的调试工具和更详细的指导。
如果你的配置的 server 无法加载，并且你在其日志中看到一个引用路径中 ${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 Desktop。
NPM 应该全局安装如果你尚未全局安装 NPM，则 npx 命令可能会继续失败。 如果 NPM 已经全局安装，你将找到 %APPDATA%\npm 存在于你的系统中。 如果没有，你可以通过运行以下命令全局安装 NPM：
npm install -g npm

​
后续步骤

探索其他 servers

查看我们官方 MCP servers 和实现的画廊

构建你自己的 server

现在构建你自己的自定义 server，以在 Claude for Desktop 和其他客户端中使用
⌘I