古法编程

解决 Claude Chrome MCP 插件连接失效与冲突问题

解决 Claude MCP 工具调用失败（如报错 “Browser extension is not connected”）的问题，重点处理 Claude Code CLI 与 Claude.app (Cowork) 之间 Native Host 的配置冲突。

为什么需要这个技能

当你使用 mcp__claude-in-chrome__* 系列工具进行浏览器自动化时，可能会遇到连接不稳定、超时或直接提示未连接的情况。

在 macOS 上，最常见的原因是 Claude.app (Cowork) 和 Claude Code CLI 争抢同一个原生消息主机（Native Messaging Host）的控制权。两者虽然都使用 Chrome 扩展，但其二进制文件路径、Socket 格式和配置文件截然不同。如果两者同时激活，Chrome 会调用错误的二进制文件，导致 MCP 客户端无法在预期位置找到 Socket 链接，从而导致连接失败。

适用场景

  • 使用 mcp__claude-in-chrome__* 工具时提示 “Browser extension is not connected”。
  • 浏览器自动化运行异常或频繁超时。
  • 在 Claude Code CLI 和 Claude.app 之间切换使用后，功能失效。
  • 升级 Claude Code 版本后，原生主机路径失效。
  • 注意：本技能仅适用于 macOS，不适用于 Windows 或 Linux。

核心工作流

1. 诊断冲突

通过以下命令确认当前运行的二进制文件和 Socket 状态：

# 检查运行的是哪个原生主机
ps aux | grep chrome-native-host | grep -v grep

# 检查 Claude Code 的 Socket 文件是否存在
ls -la "$(getconf DARWIN_USER_TEMP_DIR)/claude-mcp-browser-bridge-$USER" 2>&1

2. 解决配置冲突 (二选一)

你不能同时使用 Claude Code CLI 和 Claude.app 的浏览器自动化。

  • 如果你倾向于使用 Claude Code CLI： 禁用 Claude.app 的配置文件：

    mv ~/Library/Application\ Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_browser_extension.json \
   ~/Library/Application\ Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_browser_extension.json.disabled

  • 如果你倾向于使用 Claude.app (Cowork)： 禁用 Claude Code 的配置文件：

    mv ~/Library/Application\ Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json \
   ~/Library/Application\ Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json.disabled

3. 完整重置步骤 (针对 Claude Code CLI)

如果简单的切换无效，请执行全量重置：

  1. 确保正确的 .json 配置文件处于激活状态（未被 .disabled）。
  2. 更新动态版本包装脚本：
    cat > ~/.claude/chrome/chrome-native-host << 'EOF'
#!/bin/bash
LATEST=$(ls -t ~/.local/share/claude/versions/ 2>/dev/null | head -1)
exec "$HOME/.local/share/claude/versions/$LATEST" --chrome-native-host
EOF
chmod +x ~/.claude/chrome/chrome-native-host
  3. 强杀现有进程并清理 Socket：
    pkill -f chrome-native-host
rm -rf /tmp/claude-mcp-browser-bridge-$USER/
rm -f "$(getconf DARWIN_USER_TEMP_DIR)/claude-mcp-browser-bridge-$USER"
  4. 重启 Chrome → 点击插件图标 → 重启 Claude Code。

下载和安装

下载 claude-in-chrome-troubleshooting 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要

暂无推荐