修改 claude_desktop_config.json 或 mcp_config.json（Antigravity）：

{
  "mcpServers": {
    "wechat-devtools": {
      "command": "uvx",
      "args": ["wechat-devtools-mcp"],
      "env": {
        "WECHAT_DEVTOOLS_CLI": "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat",
        "WECHAT_PROJECT_PATH": "D:\\Your\\Project\\Path"
      }
    }
  }
}

编辑 ~/.kiro/settings/mcp.json：

{
  "mcpServers": {
    "wechat-devtools": {
      "command": "uvx",
      "args": ["wechat-devtools-mcp"],
      "env": {
        "WECHAT_DEVTOOLS_CLI": "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat",
        "WECHAT_PROJECT_PATH": "D:\\Your\\Project\\Path",
        "PYTHONIOENCODING": "utf-8"
      },
      "autoApprove": [
        "wechat_ide", "wechat_build", "wechat_automator", "wechat_inspector",
        "wechat_screenshot", "wechat_navigate", "wechat_file"
      ]
    }
  }
}

编辑 ~/.codex/config.toml（全局）或 .codex/config.toml（项目级）：

[mcp_servers.wechat-devtools]
command = "uvx"
args = ["wechat-devtools-mcp"]

[mcp_servers.wechat-devtools.env]
WECHAT_DEVTOOLS_CLI = "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat"
WECHAT_PROJECT_PATH = "D:\\Your\\Project\\Path"

也可以通过 CLI 快速添加：

codex mcp add wechat-devtools \
  --env WECHAT_DEVTOOLS_CLI="C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat" \
  --env WECHAT_PROJECT_PATH="D:\\Your\\Project\\Path" \
  -- uvx wechat-devtools-mcp

在 MCP 控制台中添加新 Server：

• Name: wechat-devtools
• Type: command
• Command: uvx wechat-devtools-mcp
• Environment Variables: 同上添加 WECHAT_DEVTOOLS_CLI 和 WECHAT_PROJECT_PATH

Windows 下路径中的反斜杠需要转义（\\）。

如果你用 Claude Code 在小程序仓库里开发，可以建项目级 .mcp.json（自动跟随仓库、对协作者生效）。

Windows — 仓库根目录 .mcp.json：

{
  "mcpServers": {
    "wechat-devtools": {
      "command": "uvx",
      "args": ["wechat-devtools-mcp"],
      "env": {
        "WECHAT_DEVTOOLS_CLI": "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat",
        "WECHAT_PROJECT_PATH": "D:\\Your\\Project\\Path"
      }
    }
  }
}

macOS — 仓库根目录 .mcp.json：

{
  "mcpServers": {
    "wechat-devtools": {
      "command": "/opt/homebrew/bin/uvx",
      "args": ["wechat-devtools-mcp"],
      "env": {
        "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin",
        "WECHAT_DEVTOOLS_CLI": "/Applications/wechatwebdevtools.app/Contents/MacOS/cli",
        "WECHAT_PROJECT_PATH": "/Users/<you>/WeChatProjects/<project>",
        "NODE_PATH": "/opt/homebrew/bin/node"
      }
    }
  }
}

macOS 三个关键差异：

• command 必须用绝对路径 /opt/homebrew/bin/uvx（Claude Code spawn 子进程时 PATH 不含 Homebrew）
• env.PATH 必须显式注入（同时配 npx-based MCP 如 cloudbase / chrome-devtools 时尤其需要，否则 npx 的 #!/usr/bin/env node 找不到 Node）
• NODE_PATH 推荐显式指定，作为 daemon 启动时的双保险

同时配置多个 MCP（cloudbase / chrome-devtools 等）时，每个 server 都按相同模式处理 command 绝对路径与 env.PATH。

Trae v1.3.0+ 支持 MCP。AI 面板 → 右上角设置 → MCP → 添加 → 手动配置，粘贴下方 JSON 后保存。

Windows：

{
  "mcpServers": {
    "wechat-devtools": {
      "command": "uvx",
      "args": ["wechat-devtools-mcp"],
      "env": {
        "WECHAT_DEVTOOLS_CLI": "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat",
        "WECHAT_PROJECT_PATH": "D:\\Your\\Project\\Path"
      }
    }
  }
}

macOS：

{
  "mcpServers": {
    "wechat-devtools": {
      "command": "/opt/homebrew/bin/uvx",
      "args": ["wechat-devtools-mcp"],
      "env": {
        "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin",
        "WECHAT_DEVTOOLS_CLI": "/Applications/wechatwebdevtools.app/Contents/MacOS/cli",
        "WECHAT_PROJECT_PATH": "/Users/<you>/WeChatProjects/<project>",
        "NODE_PATH": "/opt/homebrew/bin/node"
      }
    }
  }
}

直接编辑配置文件也可：

• Windows: %APPDATA%\Trae\User\globalStorage\mcp.json
• macOS: ~/Library/Application Support/Trae/User/globalStorage/mcp.json

[!IMPORTANT] 聊天框必须选 「Builder with MCP」 智能体，普通智能体不调 MCP 工具。建议同时安装 wechat-devtools Skill（Step 5），让 AI 按 SOP 顺序调用。

最常见原因：微信开发者工具的"服务端口"未开启。 进入 设置 → 安全 → 服务端口，将其打开。开启后无需重启 IDE，AI 即可恢复连接。

如果手动打开了开发者工具，它可能未监听调试端口。请关闭开发者工具，让 AI 执行 wechat_ide(action='open', cdp_enabled=True) 以调试模式启动。

编辑器中的 MCP 服务仍在运行。参见 Step 1 下方的升级提示——需先终止进程再升级。

可能是 pip install 安装的旧版本优先级更高。运行 pip uninstall wechat-devtools-mcp 移除旧版本，然后通过 wechat_ide(action='status') 确认 mcp_version 字段为最新版本。

在编辑器配置的 env 中确保 WECHAT_DEVTOOLS_CLI 填入了绝对路径：

• Windows: 使用双反斜杠（如 C:\\...\\cli.bat）
• macOS: 标准路径 /Applications/wechatwebdevtools.app/Contents/MacOS/cli，斜杠无需转义

GUI 客户端（如 Claude Desktop）启动 MCP 时 PATH 可能不包含 /opt/homebrew/bin。MCP v0.9.6 起会自动尝试 Homebrew 标准路径；若仍失败，可在 env 中显式设置：

"NODE_PATH": "/opt/homebrew/bin/node"