用途:该技能用于排查 Claude in Chrome MCP 扩展的连接与稳定性问题,主要针对 mcp__claude-in-chrome__* 工具失败或返回“Browser extension is not connected”等情况。
适用场景:浏览器自动化行为异常或超时;更新 Claude Code 或 Claude.app 之后出现问题;在 Claude Code CLI 与 Claude.app(Cowork)之间切换;原生宿主进程已在运行但 MCP 工具仍失败。
主要问题:Claude.app 的 Cowork 支持引入了与 Claude Code CLI 冲突的原生消息宿主。两者注册的配置不同(com.anthropic.claude_browser_extension.json 对应 Claude.app,com.anthropic.claude_code_browser_extension.json 对应 Claude Code),socket 格式与位置也不兼容:Claude.app 使用 /tmp/claude-mcp-browser-bridge-$USER/<PID>.sock,Claude Code 使用 $TMPDIR/claude-mcp-browser-bridge-$USER 单文件。
修复思路:二者不能同时使用,需禁用不用的那一方配置,例如用 mv 将对应 json 改名为 .json.disabled;随后重启 Chrome,必要时再重启 Claude Code。技能提供 chrome-mcp-toggle 切换脚本。
诊断方法:用 ps aux | grep chrome-native-host 查看运行的是哪个宿主;检查 socket 是否存在;用 lsof 查看连接;确认 Chrome NativeMessagingHosts 目录下哪个配置生效。完整重置流程包括更新包装脚本、清理旧 socket、重启 Chrome 与 Claude Code。
其他常见原因:多个 Chrome 配置文件、多个 Claude Code 会话、包装脚本中硬编码版本、TMPDIR 未设置。限制:仅覆盖 macOS;不处理通用 Chrome 自动化问题、Claude.app 桌面问题、网络问题或扩展安装问题,须注意 MCP 在启动时连接,修复后需重启相关进程。