配置后看不到工具图标怎么办？

确认已完全重启（不是刷新窗口）。检查配置文件 JSON 格式是否正确，可以用 cat config.json | python -m json.tool 验证。查看日志文件获取具体错误信息。

npx 命令找不到怎么办？

确认 Node.js 已正确安装且在系统 PATH 中。在终端运行 which npx（macOS）或 where npx（Windows）确认路径。如果使用 nvm，可能需要在配置中写 npx 的完整路径。

可以同时连接多少个 MCP Server？

没有硬性限制，但每个 Server 都是独立进程，过多会占用系统资源。建议只启用当前需要的 Server。

Claude Desktop MCP 配置教程 - AI Agent 与 MCP Server 工具目录

前置条件

已安装 Claude Desktop（macOS 或 Windows）
已安装 Node.js 18 或更高版本（用于运行基于 Node.js 的 MCP Server）
了解基本的命令行操作

检查 Node.js 是否已安装：

node --version
# 应输出 v18.x.x 或更高

配置步骤

第一步：找到配置文件

Claude Desktop 的 MCP 配置文件位置：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

如果文件不存在，手动创建即可。

第二步：编辑配置文件

打开配置文件，写入以下内容（以 filesystem MCP Server 为例）：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Documents"
      ]
    }
  }
}

将 /Users/yourname/Documents 替换为你希望 Claude 访问的目录路径。

第三步：重启 Claude Desktop

完全退出 Claude Desktop（不是最小化），然后重新打开。macOS 上可以在菜单栏右键图标选择"Quit"。

第四步：验证连接

重启后，在对话输入框左侧应该能看到一个锤子图标（工具图标）。点击它可以查看已连接的 MCP Server 和可用工具列表。

添加多个 MCP Server

在 mcpServers 对象中添加多个键值对即可：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/yourname/Documents"]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

查看日志排查问题

如果 MCP Server 未正常连接，可以查看日志文件：

macOS：~/Library/Logs/Claude/mcp*.log
Windows：%APPDATA%\Claude\logs\mcp*.log

日志中会显示 Server 启动失败的具体原因。

注意事项

配置文件必须是合法的 JSON 格式，多余的逗号或缺少引号都会导致解析失败。
路径中的反斜杠（Windows）需要转义为双反斜杠，如 "C:\\Users\\name\\Documents"。
每次修改配置后都需要完全重启 Claude Desktop。
不要把包含 API Key 的配置文件提交到公开仓库。

常见问题

配置后看不到工具图标怎么办？: 确认已完全重启（不是刷新窗口）。检查配置文件 JSON 格式是否正确，可以用 cat config.json | python -m json.tool 验证。查看日志文件获取具体错误信息。
npx 命令找不到怎么办？: 确认 Node.js 已正确安装且在系统 PATH 中。在终端运行 which npx（macOS）或 where npx（Windows）确认路径。如果使用 nvm，可能需要在配置中写 npx 的完整路径。
可以同时连接多少个 MCP Server？: 没有硬性限制，但每个 Server 都是独立进程，过多会占用系统资源。建议只启用当前需要的 Server。

Claude Desktop MCP 配置教程