MCP学习

Claude 桌面应用MCP使用指南

使用 Claude for Desktop 中的预构建服务器快速入门在本教程中，您将扩展 Claude for Desktop，使其可以读取您计算机的文件系统、写入新文件、移动文件，甚至搜索文件。

为什么叫QQ？

17 1月 2025 • 6 min read

使用 Claude for Desktop 中的预构建服务器快速入门

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

别担心——在执行这些操作之前，它会先征得您的同意！

1. 下载 Claude for Desktop

从 Claude 官网下载 Claude for Desktop，选择 macOS 或 Windows。（目前 Linux 尚未支持 Claude for Desktop。）

按照安装说明进行操作。

如果您已经安装了 Claude for Desktop，请确保它是最新版本。点击 Claude 菜单，选择“检查更新（Check for Updates）”。

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

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

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

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

开始操作：

打开 Claude 菜单，选择“设置（Settings）”。
请注意，这里的设置不是应用窗口中的“Claude 账户设置（Claude Account Settings）”。

在 Mac 上，界面如下所示：

点击左侧栏中的“开发者（Developer）”，然后点击“编辑配置（Edit Config）”：

此操作会在以下位置创建一个配置文件：

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"
      ]
    }
  }
}

Windows 示例

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

请将 username 替换为您计算机的用户名。路径应指向您希望 Claude 访问和修改的有效目录。默认设置为 Desktop 和 Downloads，您也可以添加其他路径。

此外，您需要在计算机上安装 Node.js。验证是否已安装 Node.js，请打开命令行：

macOS：从“应用程序”文件夹中打开 Terminal。
Windows：按 Windows+R，输入“cmd”，然后按 Enter。

在命令行中，输入以下命令：

node --version

如果收到“command not found”或“node is not recognized”的错误消息，请从 Node.js 官网下载并安装。

最好设置下国内的npm源：

npm config set registry https://registry.npmmirror.com/

不然启动 Claude 桌面应用启动 MCP 服务因为网络问题，可能会注册失败。

配置文件如何工作？

此配置文件告诉 Claude for Desktop 每次启动应用程序时需要启动哪些 MCP 服务器。在本例中，我们添加了一个名为“filesystem”的服务器，使用 Node 的 npx 命令来安装并运行 @modelcontextprotocol/server-filesystem。

该服务器的更多描述请参见此处。

命令权限

Claude for Desktop 将以您的用户账户权限运行配置文件中的命令，并访问您的本地文件。只有在理解并信任来源的情况下才添加命令。

3. 重启 Claude

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

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

点击锤子图标后，您应该能看到 Filesystem MCP Server 提供的工具：

如果服务器未被 Claude for Desktop 识别，请参阅故障排查。

4. 试用功能！

您现在可以与 Claude 对话，让它访问您的文件系统。它会根据需要调用相关工具。

试试以下内容：

“能否写一首诗并保存到我的桌面上？”
“我的下载文件夹中有哪些与工作相关的文件？”
“能否将桌面上的所有图片移动到一个名为‘Images’的新文件夹中？”

Claude 会在执行操作前征求您的许可：

故障排查

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

完全重新启动 Claude for Desktop。
检查 claude_desktop_config.json 文件的语法是否正确。
确保 claude_desktop_config.json 中的路径有效且为绝对路径。
查看日志了解服务器连接问题。
在命令行中手动运行服务器（将 username 替换为您的用户名）：

macOS/Linux

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

Windows

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

从 Claude for Desktop 获取日志

Claude 应用与 MCP 相关的日志文件存储在以下位置：

macOS：~/Library/Logs/Claude
Windows：%APPDATA%\Claude\logs

日志文件包括：

mcp.log：包含 MCP 连接和连接失败的常规日志。
名为 mcp-server-SERVERNAME.log 的文件：包含特定服务器的错误日志。

查看最近日志：

macOS/Linux

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

Windows

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

工具调用失败

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

检查 Claude 的日志文件。
确认服务器可以正常构建和运行。
尝试重新启动 Claude for Desktop。

无法解决？

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