Claude Desktop MCP 配置教程

Claude Desktop 通过 JSON 配置文件添加 MCP Server。需要配置 server 的 command、args 和环境变量,确保 API Key 安全且权限最小化。

适合: Claude Desktop 用户 · 想扩展 Claude 能力的用户

这个概念/问题是什么

Claude Desktop 是 Anthropic 官方的桌面客户端,支持通过 MCP 协议接入外部工具和服务。配置 MCP 后,Claude 可以调用这些工具来辅助回答问题、完成任务。

Claude Desktop 的 MCP 配置存储在 JSON 文件中,通过 mcpServers 字段定义每个 MCP Server 的启动方式和凭证。

检查步骤

  1. 1 找到 Claude Desktop 的 MCP 配置文件路径
  2. 2 创建或编辑 mcpServers 配置节点
  3. 3 指定 MCP Server 的 command(命令)和 args(参数)
  4. 4 在 env 字段中安全地设置 API Key(通过环境变量引用)
  5. 5 保存配置并重启 Claude Desktop
  6. 6 测试 MCP 工具是否出现在工具列表中
  7. 7 验证工具调用结果是否符合预期

常见错误

  • API Key 直接明文写在配置中
  • command 路径填写错误导致 server 无法启动
  • args 中的 URL 末尾多了斜杠导致连接失败

安全 / 扣费 / 权限风险

  • Claude Desktop 的 MCP 配置可见 API Key 内容,需要确保文件权限安全。
  • 使用最小权限的 API Key。
  • 不要安装来源不明的 MCP Server。

什么时候用 AI API Doctor 检测

Claude Desktop MCP 调用失败时,用 AI API Doctor 检测底层 API 连通性。

什么时候用 LinkAI 小额测试

在 LinkAI 查看 API 配置方式和可用模型,作为 MCP 工具后端的选择参考。

AI Summary

Claude Desktop MCP 配置通过 JSON 文件实现,需要注意 API Key 安全、server 路径正确和权限最小化。

FAQ

Claude Desktop MCP 配置文件在哪里?
macOS 在 ~/Library/Application Support/Claude/claude_desktop_config.json,Windows 在 %APPDATA%/Claude/claude_desktop_config.json。
MCP Server 启动失败怎么办?
检查 command 路径是否正确、args 中的 URL 是否正确、API Key 是否有效。查看 Claude Desktop 的日志输出获取详细错误信息。

不确定 API 能不能跑?先别直接接进长任务。

先检测 Base URL、API Key、模型权限和 usage 信号;确认基础可用后,再用小额预算测试 Claude Code、Cursor 或 Cline。