在 Claude Desktop 中配置 MCP

在 Claude Desktop 中配置 MCP

基础概念

Claude Desktop 是 Anthropic 官方的桌面客户端（macOS / Windows），也是最早支持 MCP 的 Host 之一。它内置了完整的 MCP Client 实现，你只需要在一个 JSON 配置文件里写几行，就能让 Claude 连上各种 MCP Server——读写文件、查 GitHub、搜索网页、操作数据库，全部在对话框里完成。

整个过程可以用一句话概括：编辑配置文件 → 重启 Claude Desktop → 开始对话。不需要写代码，不需要部署服务。

核心要素

从配置到运行的完整流程

基础用法

第一步：检查前置条件

第二步：找到配置文件

配置文件路径因操作系统而异：

快捷打开方式：在 Claude Desktop 里点菜单栏 Claude → Settings → Developer → Edit Config，会自动打开配置文件（如果不存在会自动创建）。

第三步：写配置

下面是一个最简单的配置——挂载官方 Filesystem Server，让 Claude 能读写你桌面和下载文件夹的文件：

macOS 版本：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/你的用户名/Desktop",
        "/Users/你的用户名/Downloads"
      ]
    }
  }
}

Windows 版本：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\你的用户名\\Desktop",
        "C:\\Users\\你的用户名\\Downloads"
      ]
    }
  }
}

每个字段的含义：

• "filesystem"：你给这个 Server 起的名字，随便写，方便自己识别就行
• "command": "npx"：启动命令，用 Node.js 的 npx 来运行
• "-y"：自动确认安装 npm 包，不需要手动输 yes
• "@modelcontextprotocol/server-filesystem"：Server 的 npm 包名
• 后面的路径：这个 Server 被允许访问的目录，只配了桌面和下载，其他目录 Server 读不到

安全提醒：只授权你确实想让 Claude 访问的目录。Server 以你的系统账户权限运行，可以对授权目录进行读写操作。

第四步：重启并验证

1. 完全退出 Claude Desktop（不是最小化，是 Quit/退出）
2. 重新打开 Claude Desktop
3. 看对话输入框右下角，应该出现一个 MCP 图标（锤子/滑块样式）
4. 点击这个图标，能看到 Filesystem Server 暴露的工具列表（如 read_file、write_file、list_directory、search_files 等）

如果图标没出现，跳到下面的"常见排查"部分。

第五步：试一下

在对话框里输入：

帮我看一下桌面上有哪些文件？

Claude 会请求调用 list_directory 工具，弹出确认框让你批准。点击"Allow"后，Claude 就能列出你桌面的文件了。

进阶：配置多个 Server + 环境变量

实际使用中你往往会同时挂多个 Server。下面是一个配了 3 个 Server 的完整示例：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/me/projects"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "BSAxxxxxxxxxxxxxxxx"
      }
    }
  }
}

几个要点：

• env 字段：用来传环境变量。很多 Server 需要 API Key，通过 env 传入比写命令行参数更安全
• 多个 Server 互不干扰：Claude Desktop 会为每个 Server 创建独立的 Client 实例，一个 Server 崩了不影响其他的
• 工具自动合并：Claude 在对话中看到的是所有 Server 的工具合集。当你说"帮我在 GitHub 上搜一下 xxx 项目的 README，下载到本地"，Claude 可能会先调 GitHub Server 再调 Filesystem Server，跨 Server 协作

日志排查

出问题时，先看日志：

• mcp.log：MCP 连接的总日志（连接成功/失败）
• mcp-server-<名字>.log：某个 Server 的 stderr 输出（报错信息在这里）

macOS 上快速查看最近日志：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

常见配置问题速查

终极排查法：在终端手动运行 Server 命令，看它是否能正常启动：

# macOS / Linux
npx -y @modelcontextprotocol/server-filesystem /Users/你的用户名/Desktop

# Windows（PowerShell）
npx -y @modelcontextprotocol/server-filesystem C:\Users\你的用户名\Desktop

如果这条命令本身就报错，说明是 Server 或 Node.js 的问题，不是 Claude Desktop 的问题。

同类工具对比

Claude Desktop 不是唯一支持 MCP 的客户端，下面是几个主流选择：

核心区别：

• Claude Desktop：最完整的 MCP 支持（Tools + Resources + Prompts + Sampling 全覆盖），适合非开发者和日常使用
• Claude Code：开发者首选，在终端里用 claude mcp add <name> <command> 一行命令配 Server，不需要手动编辑 JSON
• Cursor / VS Code：专注代码场景，MCP 支持主要服务于编程工作流

常见误区

优劣势分析

思考题

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "你的 Brave API Key"
      }
    }
  }
}

参考资料

1. 官方本地 Server 连接指南：https://modelcontextprotocol.io/docs/develop/connect-local-servers（查询日期 2026-04-11）
2. Claude 帮助中心 - MCP 入门：https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop
3. 官方 MCP 客户端列表：https://modelcontextprotocol.io/clients
4. Filesystem Server 源码：https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem
5. Claude Desktop 下载：https://claude.ai/download
6. MCP 调试工具文档：https://modelcontextprotocol.io/docs/tools/debugging