> ## Documentation Index
> Fetch the complete documentation index at: https://startai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 致 Claude 桌面版用户

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

在本教程中，您将扩展 [Claude 桌面版](https://claude.ai/download)，使其能够读取您计算机的文件系统、写入新文件、移动文件，甚至搜索文件。

<Frame>
  <img src="https://mintcdn.com/startai/kcnYHWUolkPHxvpx/images/quickstart-filesystem.png?fit=max&auto=format&n=kcnYHWUolkPHxvpx&q=85&s=fe332a9447e8d8f60a3770c7ce7e5b13" width="1732" height="2060" data-path="images/quickstart-filesystem.png" />
</Frame>

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

## 1. 下载 Claude 桌面版

首先下载 [Claude 桌面版](https://claude.ai/download)，选择 macOS 或 Windows 版本。（Claude 桌面版尚不支持 Linux。）

按照安装说明进行操作。

如果您已经安装了 Claude 桌面版，请确保它是最新版本，方法是单击计算机上的 Claude 菜单并选择“检查更新...”

<Accordion title="为什么选择 Claude 桌面版而不是 Claude.ai？">
  因为服务器是本地运行的，MCP 目前仅支持桌面主机。远程主机正在积极开发中。
</Accordion>

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

要添加此文件系统功能，我们将向 Claude 桌面版安装一个预构建的 [文件系统 MCP 服务器](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem)。这是 Anthropic 和社区创建的数十个 [服务器](https://github.com/modelcontextprotocol/servers/tree/main) 之一。

首先打开计算机上的 Claude 菜单并选择“设置...”请注意，这些不是在应用程序窗口本身中找到的 Claude 帐户设置。

在 Mac 上它应该看起来像这样：

<Frame style={{ textAlign: 'center' }}>
  <img src="https://mintcdn.com/startai/kcnYHWUolkPHxvpx/images/quickstart-menu.png?fit=max&auto=format&n=kcnYHWUolkPHxvpx&q=85&s=063ef08c00cacfc04545bcf4451ed511" width="400" data-path="images/quickstart-menu.png" />
</Frame>

在“设置”窗格的左侧栏中单击“开发者”，然后单击“编辑配置”：

<Frame>
  <img src="https://mintcdn.com/startai/kcnYHWUolkPHxvpx/images/quickstart-developer.png?fit=max&auto=format&n=kcnYHWUolkPHxvpx&q=85&s=eba36747d8a9a32d66df373a3c604747" width="1688" height="534" data-path="images/quickstart-developer.png" />
</Frame>

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

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

如果您还没有配置文件，它将创建并显示在您的文件系统中。

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

<Tabs>
  <Tab title="MacOS/Linux">
    ```json theme={null}
    {
      "mcpServers": {
        "filesystem": {
          "command": "npx",
          "args": [
            "-y",
            "@modelcontextprotocol/server-filesystem",
            "/Users/username/Desktop",
            "/Users/username/Downloads"
          ]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Windows">
    ```json theme={null}
    {
      "mcpServers": {
        "filesystem": {
          "command": "npx",
          "args": [
            "-y",
            "@modelcontextprotocol/server-filesystem",
            "C:\\Users\\username\\Desktop",
            "C:\\Users\\username\\Downloads"
          ]
        }
      }
    }
    ```
  </Tab>
</Tabs>

请确保将 `username` 替换为您计算机的用户名。路径应指向您希望 Claude 能够访问和修改的有效目录。它已设置为适用于桌面和下载文件夹，但您也可以添加更多路径。

您还需要在计算机上安装 [Node.js](https://nodejs.org) 才能正常运行。要验证您是否已安装 Node，请打开计算机的命令行。

* 在 macOS 上，从“应用程序”文件夹中打开“终端”
* 在 Windows 上，按 Windows + R，键入“cmd”，然后按 Enter

进入命令行后，通过输入以下命令验证您是否已安装 Node：

```bash theme={null}
node --version
```

如果您收到错误消息“command not found”或“node is not recognized”，请从 [nodejs.org](https://nodejs.org/) 下载 Node。

<Tip>
  **配置文件如何工作？**

  此配置文件告诉 Claude 桌面版每次启动应用程序时要启动哪些 MCP 服务器。在这种情况下，我们添加了一个名为“filesystem”的服务器，它将使用 Node `npx` 命令来安装和运行 `@modelcontextprotocol/server-filesystem`。此服务器（在此处[描述](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem)）将允许您在 Claude 桌面版中访问您的文件系统。
</Tip>

<Warning>
  **命令权限**

  Claude 桌面版将使用您的用户帐户权限运行配置文件中的命令，并访问您的本地文件。仅在您理解并信任来源的情况下添加命令。
</Warning>

## 3. 重启 Claude

更新配置文件后，您需要重新启动 Claude 桌面版。

重新启动后，您应该在输入框的右下角看到一个锤子 <img src="https://mintcdn.com/startai/kcnYHWUolkPHxvpx/images/claude-desktop-mcp-hammer-icon.svg?fit=max&auto=format&n=kcnYHWUolkPHxvpx&q=85&s=e050ecae01ce5b5b8b694ec5749ab3d5" style={{display: 'inline', margin: 0, height: '1.3em'}} width="32" height="32" data-path="images/claude-desktop-mcp-hammer-icon.svg" /> 图标：

<Frame>
  <img src="https://mintcdn.com/startai/kcnYHWUolkPHxvpx/images/quickstart-hammer.png?fit=max&auto=format&n=kcnYHWUolkPHxvpx&q=85&s=f8c4b7ac5f5d09fd19a33d04c708598b" width="1476" height="570" data-path="images/quickstart-hammer.png" />
</Frame>

单击锤子图标后，您应该会看到文件系统 MCP 服务器附带的工具：

<Frame style={{ textAlign: 'center' }}>
  <img src="https://mintcdn.com/startai/kcnYHWUolkPHxvpx/images/quickstart-tools.png?fit=max&auto=format&n=kcnYHWUolkPHxvpx&q=85&s=fd0843c6d14894e29aa2ee5c32e64791" width="400" data-path="images/quickstart-tools.png" />
</Frame>

如果 Claude 桌面版未检测到您的服务器，请转到[故障排除](#troubleshooting)部分获取调试提示。

## 4. 试一试！

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

您可以尝试问 Claude：

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

根据需要，Claude 将调用相关工具并在执行操作前征求您的批准：

<Frame style={{ textAlign: 'center' }}>
  <img src="https://mintcdn.com/startai/kcnYHWUolkPHxvpx/images/quickstart-approve.png?fit=max&auto=format&n=kcnYHWUolkPHxvpx&q=85&s=155eecd21762842fc020110a51ca3e45" width="500" data-path="images/quickstart-approve.png" />
</Frame>

## 故障排除

<AccordionGroup>
  <Accordion title="服务器未在 Claude 中显示/缺少锤子图标">
    1. 完全重启 Claude 桌面版
    2. 检查您的 `claude_desktop_config.json` 文件语法
    3. 确保 `claude_desktop_config.json` 中包含的文件路径有效，并且它们是绝对路径而不是相对路径
    4. 查看[日志](#getting-logs-from-claude-for-desktop)以了解服务器未连接的原因
    5. 在命令行中，尝试手动运行服务器（像在 `claude_desktop_config.json` 中那样替换 `username`）以查看是否出现任何错误：

    <Tabs>
      <Tab title="MacOS/Linux">
        ```bash theme={null}
        npx -y @modelcontextprotocol/server-filesystem /Users/username/Desktop /Users/username/Downloads
        ```
      </Tab>

      <Tab title="Windows">
        ```bash theme={null}
        npx -y @modelcontextprotocol/server-filesystem C:\Users\username\Desktop C:\Users\username\Downloads
        ```
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="从 Claude 桌面版获取日志">
    与 MCP 相关的 Claude.app 日志记录写入以下位置的日志文件：

    * macOS: `~/Library/Logs/Claude`

    * Windows: `%APPDATA%\Claude\logs`

    * `mcp.log` 将包含有关 MCP 连接和连接失败的常规日志记录。

    * 名为 `mcp-server-SERVERNAME.log` 的文件将包含来自指定服务器的错误 (stderr) 日志记录。

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

    <Tabs>
      <Tab title="MacOS/Linux">
        ```bash theme={null}
        # 检查 Claude 的日志以查找错误
        tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
        ```
      </Tab>

      <Tab title="Windows">
        ```bash theme={null}
        type "%APPDATA%\Claude\logs\mcp*.log"
        ```
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="工具调用静默失败">
    如果 Claude 尝试使用工具但失败了：

    1. 检查 Claude 的日志以查找错误
    2. 验证您的服务器构建和运行没有错误
    3. 尝试重新启动 Claude 桌面版
  </Accordion>

  <Accordion title="这些都不起作用。我该怎么办？">
    请参阅我们的[调试指南](/docs/tools/debugging)以获取更好的调试工具和更详细的指导。
  </Accordion>

  <Accordion title="Windows 上出现 ENOENT 错误和路径中的 `${APPDATA}`">
    如果配置的服务器无法加载，并且您在其日志中看到引用路径中 `${APPDATA}` 的错误，您可能需要将 `%APPDATA%` 的扩展值添加到 `claude_desktop_config.json` 中的 `env` 键：

    ```json theme={null}
    {
      "brave-search": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-brave-search"],
        "env": {
          "APPDATA": "C:\\Users\\user\\AppData\\Roaming\\",
          "BRAVE_API_KEY": "..."
        }
      }
    }
    ```

    完成此更改后，再次启动 Claude 桌面版。

    <Warning>
      **NPM 应全局安装**

      如果您尚未全局安装 NPM，`npx` 命令可能会继续失败。如果已全局安装 NPM，您将在系统上找到 `%APPDATA%\npm`。如果没有，您可以通过运行以下命令全局安装 NPM：

      ```bash theme={null}
      npm install -g npm
      ```
    </Warning>
  </Accordion>
</AccordionGroup>

## 后续步骤

<CardGroup cols={2}>
  <Card title="探索其他服务器" icon="grid" href="/examples">
    查看我们的官方 MCP 服务器和实现库
  </Card>

  <Card title="构建您自己的服务器" icon="code" href="/quickstart/server">
    现在构建您自己的自定义服务器以在 Claude 桌面版和其他客户端中使用
  </Card>
</CardGroup>