Claude 桌面版用户指南

开始在 Claude 桌面版中使用预构建的服务器

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

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

1. 下载 Claude 桌面版

首先下载 Claude 桌面版，选择 macOS 或 Windows 版本（目前暂不支持 Linux）。

按照安装说明进行操作。

如果您已经安装了 Claude 桌面版，请通过点击计算机上的 Claude 菜单并选择”检查更新…”来确保它是最新版本。

为什么选择 Claude 桌面版而不是 Claude.ai？

因为服务器是在本地运行的，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

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\username\\Desktop",
        "C:\\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：

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

根据需要，Claude 会调用相关工具并在采取行动前寻求您的批准：

故障排除

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

1. 完全重启 Claude 桌面版
2. 检查 claude_desktop_config.json 文件的语法
3. 确保 claude_desktop_config.json 中包含的文件路径有效，并且是绝对路径而不是相对路径
4. 查看日志以了解服务器为什么无法连接
5. 在命令行中，尝试手动运行服务器（替换 username 为您在 claude_desktop_config.json 中使用的用户名）看是否有任何错误：

MacOS/Linux

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

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

npx -y @modelcontextprotocol/server-filesystem C:\Users\username\Desktop C:\Users\username\Downloads

获取 Claude 桌面版的日志

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

• macOS: ~/Library/Logs/Claude

• Windows: %APPDATA%\Claude\logs

• mcp.log 将包含有关 MCP 连接和连接失败的常规日志

• 名为 mcp-server-SERVERNAME.log 的文件将包含来自指定服务器的错误（stderr）日志

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

MacOS/Linux

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

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

type "%APPDATA%\Claude\logs\mcp*.log"

工具调用静默失败

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

1. 检查 Claude 的日志是否有错误
2. 验证您的服务器是否能正常构建和运行
3. 尝试重启 Claude 桌面版

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

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

Windows 上的 ENOENT 错误和路径中的 ${APPDATA}

如果您配置的服务器无法加载，并且在其日志中看到路径中包含 ${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 桌面版和其他客户端中使用

助手

Responses are generated using AI and may contain mistakes.