ORANGE BOOK · MCP

第五章：第一次配置 MCP（Claude Desktop 实操）

预计耗时：20–30 分钟。

一、目标

我们要做一件具体且有成就感的事：

让 Claude 自己帮你把桌面上的图片，移动到一个叫 Images 的新文件夹里。

成功之后你会有一种"卧槽 AI 真的能动手"的真实感—— 这是 MCP 入门的关键体验，请务必跑通。

二、整体流程一览

flowchart TB
    classDef step fill:transparent,stroke-width:2px;
    A[1 找到 claude_desktop_config.json]:::step
    B[2 写入 filesystem MCP 配置]:::step
    C[3 完全退出并重启 Claude]:::step
    D[4 验证看到工具图标]:::step
    E[5 第一次让 Claude 动手]:::step
    A-->B-->C-->D-->E

跟着五步走，一步一停，不要跳。

三、Step 1：找到 Claude 的配置文件

方法一（推荐）：让 Claude Desktop 自己帮你建

  1. 打开 Claude Desktop；
  2. 顶部菜单：Claude → 设置（Settings）；
  3. 切到 「开发者」（Developer） 选项卡；
  4. 点击 「编辑配置」（Edit Config） 按钮；
  5. Claude 会自动给你创建一个文件并用默认编辑器打开。

如果没有自动创建，你要手动找。位置如下：

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

路径打不开的小提示：

  • Mac 上 ~/Library 是隐藏目录，可以在 Finder 里按 Shift + Cmd + . 显示隐藏文件；
  • Windows 上把 %APPDATA% 直接复制进资源管理器地址栏。

方法二：自己在终端建文件

如果"开发者"按钮没有反应，也可以手动来。

Mac/Linux：

mkdir -p ~/Library/Application\ Support/Claude
touch ~/Library/Application\ Support/Claude/claude_desktop_config.json
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows（PowerShell）：

$path = "$env:APPDATA\Claude\claude_desktop_config.json"
if (-not (Test-Path $path)) { New-Item $path -Force }
notepad $path

打开后通常是空白文件。OK，准备写内容。

四、Step 2：写入 filesystem MCP 配置

macOS / Linux 版

把下面这段完整复制到 claude_desktop_config.json， 然后把 username 改成你自己的用户名：

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

Windows 版

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

关键说明：

  1. mcpServers 是顶级键，所有 MCP 都挂在它下面；
  2. "filesystem" 是这个 MCP 在 Claude 里显示的"昵称"，可以随便起；
  3. command 是启动它的命令，这里用 Node 自带的 npx；
  4. args 数组里，-y 表示自动同意安装提示；
  5. 后面跟着的 /Users/...、C:\... 是允许 AI 访问的目录列表，至少给一个； 建议至少包含你之前建的 mcp-sandbox，再加上 Desktop / Downloads。

常见错误

  • JSON 多了/少了逗号 → Claude 会启动失败。建议复制后用 jsonlint.com 校验。
  • Windows 的反斜杠没转义 → 必须写 C:\\Users\\... 不是 C:\Users\...。
  • 路径不存在 → 提前把 mcp-sandbox 建好。

五、Step 3：完全退出并重启 Claude

不是关闭窗口！是完全退出。

  • Mac：菜单栏 → Claude → Quit Claude（或 Cmd + Q）；
  • Windows：右键托盘图标 → Exit；如果托盘没有，用任务管理器结束 Claude 进程。

退出后，重新打开 Claude Desktop。

六、Step 4：验证 MCP 已经"活了"

打开 Claude，新建一个对话。在输入框右下角，你应该能看到：

  • 一个工具/锤子图标（不同版本图标样式略有不同）；
  • 鼠标悬停或点开，能看到 filesystem 这个服务器；
  • 展开能看到 read_file、write_file、list_directory、move_file 等工具列表。

如果没看到？做这 5 件事

  1. 再退出一次再开（系统托盘里可能还没完全退干净）；
  2. 检查 JSON 语法：贴到 jsonlint.com 看是否合法；
  3. 检查 Node：终端里 npx -y @modelcontextprotocol/server-filesystem /tmp 能不能跑；
  4. 看日志：
    • macOS：~/Library/Logs/Claude/
    • Windows：%APPDATA%\Claude\logs\
  5. 看路径权限：写到 args 里的目录必须存在且可访问。

按这个顺序排查，95% 的问题都能解决。

七、Step 5：第一次让 Claude 动手

打开新对话，输入：

我桌面上有哪些文件？

Claude 会问你「是否允许调用 filesystem 服务器的 list_directory 工具？」 点"允许（Allow）"。

它会列出桌面上的文件名。

到这里——恭喜，你已经成功跑通了人生第一次 MCP 调用！ 现在的对话，是你历史上第一次"AI 真的看到了你电脑里的东西"。

接着挑战难度更大的一题：

请把我桌面上所有 .png、.jpg、.jpeg 的图片，移动到一个叫 Images 的新文件夹（如果没有就创建）。完成后告诉我移动了多少张。

Claude 会：

  1. 调用 list_directory 列出桌面；
  2. 筛出图片文件；
  3. 调用 create_directory 建 Images 文件夹（如果还没有的话）；
  4. 调用 move_file 一张张移过去；
  5. 回复你："已移动 X 张图片到桌面 / Images。"

每一步它都会停下来征求你同意——这是 MCP 的安全机制，你随时可以拒绝。

八、第一次"动手"成功的检查清单

  • 看到了对话框右下角的工具图标；
  • Claude 能列出桌面文件；
  • Claude 创建了 Images 文件夹；
  • 桌面图片确实被移动了；
  • Claude 回复里告诉你移动了多少张。

全部打勾 → 你已经站在了 MCP 的门里。

九、加装第二个 MCP：Brave Search（让 AI 真的能上网）

为了让你立刻体会到 MCP 的"组合威力"，我们再加一个搜索 MCP。

1. 申请 Brave Search API Key（免费）

  1. 去 brave.com/search/api；
  2. 注册账号（免费层每月 2000 次查询，完全够个人用）；
  3. 申请一个 API Key。

2. 修改配置文件

把刚才的 JSON 改成：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/mcp-sandbox"
      ]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "你的key贴这里"
      }
    }
  }
}

注意 mcpServers 下面是个对象，每加一个服务器就在花括号里加一个 key， 加 key 要加逗号！

3. 重启 Claude

现在你可以问：

搜一下 2026 年 4 月最热门的 MCP 服务器有哪些，把结果总结成一份清单写到桌面 mcp-trends.md 里。

Claude 会同时调用 brave-search 和 filesystem 两个 MCP， 搜结果 → 总结 → 写文件。

——这就是"AI 长出手脚 + 长出眼睛"之后的样子。

十、把 MCP 关掉、删掉、临时禁用

临时禁用某个 MCP

在配置文件里把它的 key 改个名字加前缀，比如：

"_disabled_filesystem": { ... }

下次启动就不会加载它。要恢复，去掉前缀即可。

永久删除某个 MCP

直接删掉对应的 JSON 块。 注意保持 JSON 语法完整（删完别留多余逗号）。

一键关掉所有 MCP

最简单的办法：把 claude_desktop_config.json 改名为 claude_desktop_config.json.bak。 重启 Claude 就完全不带 MCP 启动。 要恢复时改回名字。

十一、本章小结

  1. 找到 claude_desktop_config.json；
  2. 写入 filesystem MCP 配置（注意路径和 JSON 语法）；
  3. 完全退出再重启 Claude；
  4. 验证工具图标出现 + 跑通"整理桌面"任务；
  5. 加上 Brave Search MCP，让 AI 能"看资料 + 写文件"；
  6. 学会临时禁用、永久删除、一键关掉 MCP。

十二、动手任务（30 分钟）

完成"三连击"：

  1. 装 filesystem，让 Claude 把桌面图片整理到 Images；
  2. 装 Brave Search，让 Claude 帮你搜一个你最近感兴趣的话题，把结果写成 markdown 存到桌面；
  3. 故意写错一个 JSON 逗号，看会出什么错，然后改回来——这是你和 MCP 真正"建立信任"的一步。

完成这 3 件，下一章我们就升级到"零代码图形化安装"——告别手写 JSON 的人生。