记录 Claude Code MCP 路径识别机制、注册方法及当前运行清单。最后更新：2026-06-01

---

一、核心结论：MCP 配置文件的真实路径识别

1.1 文件优先级

文件路径	作用域	是否自动加载
~\.mcp.json	全局	⚠️ 不可靠，当前版本不被识别
~\.claude.json	全局（用户级）	✅ 通过 claude mcp add --scope user 写入，自动加载
<project>\.mcp.json	项目级	✅ 启动时提示审批后方可连接
<project>\.claude\settings.local.json	项目本地	✅ 通过 claude mcp add -s local 写入

1.2 已验证的事实

• ~\.mcp.json（C:\Users\用户名\.mcp.json）在当前版本中不被读取。即使其中配置了 3 个 MCP 服务器（chrome-devtools、playwright、camoufox），claude mcp list 也看不到它们。
• 正确的用户级注册方式是 claude mcp add --scope user，配置写入 C:\Users\用户名\.claude.json 的 mcpServers 字段。
• 项目级 D:\ClaudeCode\.mcp.json 如果写空 {}，不会影响全局配置，但也不会合并。

---

二、MCP 服务器注册方法

2.1 命令行注册（推荐）

# 注册用户级 MCP（所有项目可用）
claude mcp add --scope user <名称> -- <命令> [参数...]

# 注册项目级 MCP（仅当前项目）
claude mcp add --scope project <名称> -- <命令> [参数...]

# 注册项目本地 MCP（仅当前机器当前项目，不提交 git）
claude mcp add -s local <名称> -- <命令> [参数...]

# 带环境变量
claude mcp add --scope user <名称> -e KEY=value -- <命令> [参数...]

2.2 查看已注册服务器

claude mcp list           # 列出所有 + 健康检查
claude mcp get <名称>      # 查看单个服务器详情

2.3 移除服务器

claude mcp remove <名称>              # 移除项目级
claude mcp remove <名称> -s user      # 移除用户级
claude mcp remove <名称> -s local     # 移除本地

2.4 ~\.claude.json 中 mcpServers 的结构

{
  "mcpServers": {
    "chrome-devtools": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest", "--chromeArg=--proxy-pac-url=data:application/x-ns-proxy-autoconfig;base64,<PAC_BASE64>"],
      "env": {}
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"],
      "env": {}
    },
    "camoufox": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "camoufox-mcp-server@latest"],
      "env": {}
    }
  }
}

---

三、当前 MCP 服务器清单

3.1 已注册且正常运行（4 个）

chrome-devtools

范围：User config (available in all your projects)
状态：✓ Connected
Type: stdio
命令：npx
参数：-y chrome-devtools-mcp@latest --chromeArg=--proxy-pac-url=data:application/x-ns-proxy-autoconfig;base64,...

移除：claude mcp remove "chrome-devtools" -s user

playwright

范围：User config (available in all your projects)
状态：✓ Connected
Type: stdio
命令：npx
参数：-y @playwright/mcp@latest

移除：claude mcp remove "playwright" -s user

camoufox

范围：User config (available in all your projects)
状态：✓ Connected
Type: stdio
命令：npx
参数：-y camoufox-mcp-server@latest

移除：claude mcp remove "camoufox" -s user

obsidian

范围：Local config (private to you in this project)
状态：✓ Connected
Type: stdio
命令：npx
参数：-y @istrejo/obsidian-mcp
Environment:
  OBSIDIAN_VAULT_PATH=D:\笔记目录\Note

移除：claude mcp remove "obsidian" -s local

3.2 汇总表

名称	作用域	说明
chrome-devtools	User	所有项目可用，PAC 分流（国内直连，境外走代理）
playwright	User	所有项目可用
camoufox	User	所有项目可用
obsidian	Local	仅本机当前项目，关联 vault D:\笔记目录\Note

关键区别：前 3 个作用域为 User → 注册在 ~\.claude.json → 任意项目/新对话均自动加载。 obsidian 作用域为 Local → 注册在本项目的 .claude\settings.local.json → 仅本机当前项目可见，不提交 git。

3.3 功能对照

服务器	用途	核心能力
chrome-devtools	Chrome 浏览器自动化	页面导航、截图、点击、表单填写、JS 执行、网络抓包、性能追踪、Lighthouse 审计（45+ 个工具）
playwright	跨浏览器自动化	多浏览器支持（Chromium/Firefox/WebKit）、无头模式、移动端仿真、网络拦截
camoufox	反检测浏览器自动化	基于 Firefox，指纹伪装，适合反爬/反检测场景
obsidian	Obsidian 笔记管理	创建/读取/更新/删除笔记、全文搜索、标签搜索、图谱关系、反链查询

3.4 内置/插件 MCP（无需配置，自动加载）

服务器	工具数	用途
ccd_directory	1	授权访问工作目录外的文件夹
ccd_session	2	会话章节标记、后台任务生成
ccd_session_mgmt	3	会话列表/搜索/归档
Claude_in_Chrome	~22	富交互浏览器自动化（桌面端）
Claude_Preview	~13	本地开发服务器预览 + 浏览器调试
scheduled-tasks	3	定时/一次性任务调度

---

四、运行方法

4.1 正常启动（自动连接）

cd <工作目录>
claude

启动后，所有 ~\.claude.json 中注册的 MCP 服务器自动连接。项目级 .mcp.json 中的服务器会显示 ⏸ 待审批，首次需确认。

4.2 命令行健康检查

# 持续检查某个服务器状态
while true; do claude mcp get chrome-devtools 2>&1; sleep 5; done

4.3 验证 MCP 工具在新对话中可用

在 Claude Code 中输入：列出当前可用的 MCP 工具

预期出现 mcp__chrome-devtools__*、mcp__playwright__*、mcp__camoufox__* 等前缀的工具。

---

五、故障排查

现象	可能原因	解决
claude mcp list 看不到某服务器	注册到了错误的作用域/文件	claude mcp get <名称> 确认，必要时重新 add --scope user
状态显示 ✗ 而非 ✓	npx 下载失败或命令执行出错	手动运行命令验证：npx -y <包名> --help
新对话中工具未出现	MCP 启动超时	重启 Claude Code，观察终端日志
~\.mcp.json 配置不生效	当前版本不读取该路径	改用 claude mcp add --scope user

---

六、相关文章

文章	内容摘要
IDA Pro MCP 服务测试报告	IDA Pro MCP 功能验证（2025 年 10 月 19 日）
IDA Pro MCP 配置指南	IDA Pro MCP 安装、环境准备、常见问题
Chrome DevTools MCP 操作手册	Chrome DevTools MCP 配置、代理、测试方法、操作示例
Claude Desktop 0Q0LSP1 错误排查与修复手册	Claude Desktop 0Q0LSP1 错误根因分析