面向 Claude Desktop 用户

在本教程中，你将扩展 Claude for Desktop 的功能，使其能够读取你计算机的文件系统、写入新文件、移动文件，甚至搜索文件。

quickstart-filesystem

别担心 — 在执行这些操作之前，它会征求你的许可！

1. 下载 Claude for Desktop

首先下载 Claude for Desktop，选择 macOS 或 Windows 版本。（Linux 目前尚不支持 Claude for Desktop。）

按照安装说明进行安装。

如果你已经安装了 Claude for Desktop，请确保它是最新版本，方法是点击电脑上的 Claude 菜单并选择"检查更新..."

为什么是 Claude for Desktop 而不是 Claude.ai？

因为服务器是在本地运行的，MCP 目前只支持桌面端。远程主机功能正在积极开发中。

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

为了添加这个文件系统功能，我们将在 Claude for Desktop 中安装一个预构建的文件系统 MCP 服务器。这是由 Anthropic 和社区创建的数十个服务器之一。

首先，打开电脑上的 Claude 菜单并选择"设置..."。请注意，这不是应用程序窗口中的 Claude 账户设置。

在 Mac 上，它应该是这样的：

点击设置面板左侧栏中的"开发者"，然后点击"编辑配置"：

quickstart-developer

这将在以下位置创建一个配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

如果你还没有这个文件，它会创建一个并在你的文件系统中显示。

在任意文本编辑器中打开配置文件。将文件内容替换为以下内容：

{
  "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 for Desktop 在每次启动应用程序时要启动哪些 MCP 服务器。在这种情况下，我们添加了一个名为"filesystem"的服务器，它将使用 Node 的 npx 命令来安装和运行 @modelcontextprotocol/server-filesystem。这个服务器（在这里有详细描述）将让你在 Claude for Desktop 中访问你的文件系统。

命令权限

Claude for Desktop 将以你的用户账户权限运行配置文件中的命令，并可以访问你的本地文件。请只添加你理解并信任来源的命令。

3. 重启 Claude

更新配置文件后，你需要重启 Claude for Desktop。

重启后，你应该会在输入框的右下角看到一个锤子图标：

quickstart-hammer

点击锤子图标后，你应该能看到文件系统 MCP 服务器提供的工具：

quickstart-tools

如果你的服务器没有被 Claude for Desktop 识别，请查看故障排除部分获取调试提示。

4. 试一试！

现在你可以与 Claude 对话并询问有关你的文件系统的问题。它会知道何时调用相关工具。

你可以尝试问 Claude 这些问题：

你能写一首诗并保存到我的桌面吗？
我的下载文件夹里有哪些工作相关的文件？
你能把我桌面上的所有图片都移动到一个名为"Images"的新文件夹中吗？

根据需要，Claude 会调用相关工具，并在采取行动之前征求你的同意：

故障排除

服务器未在 Claude 中显示 / 锤子图标丢失

Tip

完全重启 Claude for Desktop
检查你的 claude_desktop_config.json 文件语法
确保 claude_desktop_config.json 中包含的文件路径是有效的，并且是绝对路径而不是相对路径
查看日志以了解服务器为什么无法连接
在命令行中，尝试手动运行服务器（像在 claude_desktop_config.json 中那样替换 username）以查看是否有任何错误：

npx -y @modelcontextprotocol/server-filesystem /Users/username/Desktop /Users/>username/Downloads

获取 Claude for Desktop 的日志

Tip

与 MCP 相关的 Claude.app 日志写入以下位置的日志文件：

macOS: ~/Library/Logs/Claude
Windows: %APPDATA%\Claude\logs
mcp.log 将包含有关 MCP 连接和连接失败的常规日志。
名为 mcp-server-SERVERNAME.log 的文件将包含来自指定服务器的错误（stderr）日志。

你可以运行以下命令来列出最近的日志并跟踪新的日志（在 Windows 上，它只会显示最近的日志）：

# 检查 Claude 的日志是否有错误
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

工具调用静默失败

Note

如果 Claude 尝试使用工具但失败了：

检查 Claude 的日志是否有错误
验证你的服务器是否能正常构建和运行
尝试重启 Claude for Desktop

这些方法都不起作用，我该怎么办？

Tip

请参考我们的调试指南获取更好的调试工具和更详细的指导。

Windows 系统中路径出现 ENOENT 错误和 `${APPDATA}`

Tip

如果你的服务器配置无法加载，并且在日志中看到与 ${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 需要全局安装

Warning

如果你没有全局安装 NPM，npx 命令可能会持续失败。如果已经全局安装了 NPM，你的系统中应该存在 %APPDATA%\npm 目录。如果没有，你可以通过以下命令全局安装 NPM：

npm install -g npm

Previous客户端开发者指南

Next示例服务器