Claude Desktop MCP 配置指南：扩展、配置文件与连接器

在 Claude Desktop 中添加 MCP 服务器的三种方式

Claude Desktop 有三种方式连接 MCP 服务器：桌面扩展（在 Settings → Extensions 中一键安装的 .mcpb 包）、claude_desktop_config.json 配置文件（手动配置的本地 stdio 服务器），以及自定义连接器（在 Customize → Connectors 中通过 URL 添加的远程 MCP 服务器）。有现成扩展就用扩展，其他本地运行的服务器用配置文件，托管服务器用连接器。

本指南对照了 Anthropic 的本地 MCP 服务器帮助文章、自定义连接器文档以及 MCP 项目的 Claude Desktop 教程。还没选好服务器？先看看 MCP 服务器目录。

该用哪种方式？

实际区别在于：扩展和配置文件是在你的电脑上以你的用户权限运行服务器，因此可以访问本地文件和应用；连接器调用的是互联网上的服务器，而且同一个连接器在网页版 Claude 中也能用。

方式一：桌面扩展（.mcpb）

桌面扩展是打包成单个文件、附带 manifest 的本地 MCP 服务器。这个格式最初叫 DXT（.dxt 文件），后来项目更名为 MCPB（MCP Bundles），新的包使用 .mcpb 扩展名。

从目录安装：

1. 打开 Settings，进入 Extensions。
2. 点击 Browse extensions，选择一个经过 Anthropic 审核的扩展。
3. 点击 Install，填写所需设置，例如 API Key。

从 .mcpb 文件安装： 进入 Settings → Extensions，把文件拖到页面上；Claude 会显示预览，点击 Install 并确认即可。Anthropic 帮助中心还介绍了另一条路径：Advanced settings，然后在 Extension Developer 区域点击 Install Extension...。

为什么扩展是最省事的方式：

• Claude Desktop 内置了 Node.js 运行时，你无需另外安装 Node。也支持 Python 和二进制服务器。
• 标记为敏感的字段（API Key）会存进操作系统的安全存储：macOS 上是钥匙串（Keychain），Windows 上是凭据管理器（Credential Manager）。
• 目录中的扩展会自动更新；私下分发的 .mcpb 文件需要手动重新安装才能更新。

在 Team 和 Enterprise 套餐中，Owner 可以对公共扩展设置白名单或屏蔽，并上传自定义扩展。如果你的设置里没有 Extensions，说明组织已将其关闭。

想打包自己的扩展，安装 CLI 后在服务器目录下运行两条命令：

npm install -g @anthropic-ai/mcpb
mcpb init   # creates manifest.json
mcpb pack   # builds the .mcpb file

方式二：claude_desktop_config.json

对于没有扩展的服务器，直接编辑配置文件。

claude_desktop_config.json 在哪里？

不必手动去找。在系统菜单栏中打开 Claude 菜单（不是聊天窗口里的设置），选择 Settings...，切到 Developer 标签页，点击 Edit Config。如果文件不存在，它会自动创建并打开。

添加服务器

每个服务器放在 mcpServers 下，包含 command、args 和可选的 env。下面的例子运行 Filesystem MCP 服务器，允许访问两个文件夹：

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

在 Windows 上，路径要用转义的反斜杠，例如 "C:\\Users\\username\\Desktop"。服务器只能访问 args 中列出的目录，所以列表越精简越好。

添加更多服务器和 API Key

在 filesystem 旁边继续添加键即可。密钥放在 env 中：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop"
      ]
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    },
    "my-api": {
      "command": "npx",
      "args": ["-y", "some-mcp-package"],
      "env": {
        "API_KEY": "your-key-here"
      }
    }
  }
}

第二个条目是 Memory MCP 服务器，一个 Claude 可以跨对话写入的本地知识图谱。与扩展不同，这个文件里的密钥是明文保存的，所以不要同步或分享它。

重启并验证

彻底退出 Claude Desktop（不只是关闭窗口）再重新打开——应用只在启动时读取配置。然后点击输入框左下角的 + 按钮（"Add files, connectors, and more"），把鼠标移到 Connectors 上，点击 Manage connectors。你的服务器应该连同它的工具一起出现在列表中。Claude 在运行每个工具前都会请求你的批准。

方式三：把远程服务器添加为自定义连接器

托管的 MCP 服务器（Notion、Linear、Sentry，或你自己部署的服务）通过 URL 添加，而不是写进配置文件：

1. 进入 Customize → Connectors。
2. 点击 Add custom connector。
3. 输入服务器 URL，例如 Notion MCP 服务器的 https://mcp.notion.com/mcp。
4. 如有需要，打开 Advanced settings 填写 OAuth Client ID 和 Secret，然后点击 Add。
5. 点击 Connect，通过服务器的 OAuth 页面登录。

Anthropic 文档中的几点说明：

• 自定义连接器支持 Free、Pro、Max、Team 和 Enterprise 套餐；Free 套餐只能添加一个自定义连接器。
• 在 Team 和 Enterprise 套餐中，由 Owner 在 Organization settings → Connectors 中添加连接器，成员再点击 Connect。
• 以 /sse 结尾的 URL 会使用较老的 SSE 传输，否则使用 Streamable HTTP。
• 连接器添加后无法修改认证设置，只能删除后重新添加。
• 可以在 + 菜单的 Connectors 中按对话开关连接器，也可以在连接器设置中屏蔽单个工具。

由于连接是从 Anthropic 的服务器发起的，URL 必须能从互联网访问，localhost 不行。如果某个托管服务器只能和本地客户端对话，可以用社区项目 mcp-remote 作为桥接，把它作为本地 stdio 条目写进配置：

{
  "mcpServers": {
    "remote-example": {
      "command": "npx",
      "args": ["mcp-remote", "https://remote.mcp.server/mcp"]
    }
  }
}

登录流程的原理见我们的 MCP 认证指南，托管服务器的整体情况见远程 MCP 服务器指南。

日志：Claude Desktop 把 MCP 错误写在哪里

• mcp.log 记录 MCP 连接的整体情况和失败信息。
• mcp-server-SERVERNAME.log 保存每个服务器的 stderr 输出（很多 stdio 服务器把所有日志都写到这里，不只是错误）。

在 macOS 上实时跟踪：

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

在 Windows 上，type "%APPDATA%\Claude\logs\mcp*.log" 可以查看最近的记录。对于扩展，在设置中开启调试日志，然后在 Extensions 面板中查看该扩展的日志。

Claude Desktop MCP 故障排查

如果日志不够用，就把同一个服务器接到 MCP Inspector 上测试。如果在那里能用，问题出在你的 Claude 配置；如果不能用，问题出在服务器本身。

在 Claude Code 中复用配置

已经在 Claude Desktop 里配好了服务器？在 macOS 和 WSL 上，Claude Code 可以用 claude mcp add-from-claude-desktop 直接导入。其余内容见我们的 Claude Code MCP 指南。

下一步

• 在 MCP 服务器目录中挑选服务器：常见的首选有 Filesystem、GitHub 和 Notion。
• 给任何服务器写入权限之前，先读一读 MCP 安全最佳实践。
• 想发布自己的服务器？从构建 MCP 服务器开始。