-NoNewline

Claude Desktop MCP 配置教程

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

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

What This Is

Claude Desktop 是 Anthropic 官方的桌面客户端,支持通过 MCP 协议接入外部工具和服务。配置 MCP 后,Claude 可以调用这些工具来辅助回答问题、完成任务。Claude Desktop 的 MCP 配置存储在 JSON 文件中,通过 mcpServers 字段定义每个 MCP Server 的启动方式和凭证。

Check Steps

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

Common Errors

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

Security / Billing / Permission Risks

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

When to Use AI API Doctor

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

When to Use LinkAI for Small Tests

在 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 的日志输出获取详细错误信息。

Not sure if your API works? Test before wiring it into production.

Check Base URL, API Key, model permissions, and usage signals first. Then use a small test budget to verify Claude Code, Cursor, or Cline before committing.