这个概念/问题是什么
Claude Desktop 是 Anthropic 官方的桌面客户端,支持通过 MCP 协议接入外部工具和服务。配置 MCP 后,Claude 可以调用这些工具来辅助回答问题、完成任务。
Claude Desktop 的 MCP 配置存储在 JSON 文件中,通过 mcpServers 字段定义每个 MCP Server 的启动方式和凭证。
检查步骤
- 1 找到 Claude Desktop 的 MCP 配置文件路径
- 2 创建或编辑 mcpServers 配置节点
- 3 指定 MCP Server 的 command(命令)和 args(参数)
- 4 在 env 字段中安全地设置 API Key(通过环境变量引用)
- 5 保存配置并重启 Claude Desktop
- 6 测试 MCP 工具是否出现在工具列表中
- 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 路径正确和权限最小化。