> ## Documentation Index
> Fetch the complete documentation index at: https://mcp.vyagent.com/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/merge-303ecc93/ffqKi5viJXDD3MiT/images/quickstart-filesystem.png?fit=max&auto=format&n=ffqKi5viJXDD3MiT&q=85&s=52f0984f7d8ff91ae044be3c37b36a15" 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/merge-303ecc93/ffqKi5viJXDD3MiT/images/quickstart-menu.png?fit=max&auto=format&n=ffqKi5viJXDD3MiT&q=85&s=368ea5dd8ac4ab09a5f9c5fda07a20f3" width="400" data-path="images/quickstart-menu.png" />
</Frame>

点击设置窗格左侧栏的"开发者",然后点击"编辑配置":

<Frame>
  <img src="https://mintcdn.com/merge-303ecc93/ffqKi5viJXDD3MiT/images/quickstart-developer.png?fit=max&auto=format&n=ffqKi5viJXDD3MiT&q=85&s=6c44195102e5ba3b488b50d6245a3026" 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",然后按回车

在命令行中,输入以下命令验证是否已安装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/merge-303ecc93/ffqKi5viJXDD3MiT/images/claude-desktop-mcp-hammer-icon.svg?fit=max&auto=format&n=ffqKi5viJXDD3MiT&q=85&s=a2fdaf7d0a80cdc8f0054975dafeeee9" 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/merge-303ecc93/ffqKi5viJXDD3MiT/images/quickstart-hammer.png?fit=max&auto=format&n=ffqKi5viJXDD3MiT&q=85&s=ddfca8b491ddb6bf937ceef296c80a56" width="1476" height="570" data-path="images/quickstart-hammer.png" />
</Frame>

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

<Frame style={{ textAlign: 'center' }}>
  <img src="https://mintcdn.com/merge-303ecc93/ffqKi5viJXDD3MiT/images/quickstart-tools.png?fit=max&auto=format&n=ffqKi5viJXDD3MiT&q=85&s=73b959b6a17f2b33294c4f85df5bb180" 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/merge-303ecc93/ffqKi5viJXDD3MiT/images/quickstart-approve.png?fit=max&auto=format&n=ffqKi5viJXDD3MiT&q=85&s=411bf6b6df95e739b258058497d36f99" 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}`相关的错误,你可能需要在`claude_desktop_config.json`的`env`键中添加`%APPDATA%`的展开值:

    ```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>