trae mcp环境变量错误需先验证系统工具路径有效性,再通过settings.json的trae.environment字段手动注入绝对路径,windows下uvx需额外创建uvx.cmd映射文件,最后重启trae并检查mcp服务状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Trae MCP运行时提示环境变量错误,说明插件依赖的外部工具(如Git、Node.js、Chrome、uvx等)在Trae进程启动时无法被正确识别,尽管这些工具在系统命令行中能正常调用。
确认环境变量是否真缺失
打开系统终端(cmd或PowerShell),依次执行:git --version、node -v、npm -v、where chrome(Windows)或which chrome(macOS/Linux)。如果全部返回有效输出,说明系统级环境变量配置无误——Trae未继承这些变量,是典型IDE沙箱隔离行为,【不能直接修改系统PATH来强推给Trae】。
这一步必须做,否则后续所有配置都可能白费。很多用户跳过验证,直接改setting.json,结果发现Git路径写错了却反复试错。
在Trae中手动注入环境变量路径
Trae不自动同步系统PATH,需通过其内部配置显式声明关键路径。操作路径如下:
① 按 Ctrl + , 打开设置界面 → 左上角搜索框输入 environment → 点击「Edit in settings.json」链接;
② 在打开的 settings.json 文件中,找到或新建 "trae.environment" 字段(注意不是 "terminal.integrated.env 或其他无关字段);
③ 插入完整路径映射对象,例如:
"trae.environment": { "GIT_EXECUTABLE": "C:Program FilesGitingit.exe", "CHROME_PATH": "C:Program FilesGoogleChromeApplicationchrome.exe", "UVX_PATH": "C:UsersYourName.trae-cn oolsuvlatestuvx.exe"}
⚠️ 注意:路径必须是可执行文件的**绝对路径**,且反斜杠要双写(Windows)或改用正斜杠;macOS/Linux用户请用/Applications/Google Chrome.app/Contents/MacOS/Google Chrome格式。
针对uvx ENOENT问题的特殊处理
当MCP报错 spawn uvx ENOENT 时,本质是Trae调用命令未带.exe后缀,而Windows要求显式声明。此时不能只改UVX_PATH,必须创建映射文件:
方法一:在uvx.exe所在目录(如C:UsersYourName.trae-cn oolsuvlatest)新建文本文件,重命名为uvx.cmd,内容仅一行:@echo off & "%~dp0uvx.exe" %*;
方法二:若该目录权限受限,可将uvx.exe复制到C:WindowsSystem32(需管理员权限),再在settings.json中设"UVX_PATH": "C:\Windows\System32\uvx.exe"。
这一步绕过了Trae对命令后缀的硬编码限制,是Windows平台唯一可靠解法。
重启Trae并验证MCP服务状态
关闭所有Trae窗口 → 任务管理器中结束残留进程(名称含trae或electron)→ 重新启动Trae → 打开命令面板(Ctrl+Shift+P)→ 输入MCP: Show Server Status → 查看输出是否显示active及对应端口监听状态。
如果仍显示fetch failed或service not started,立即打开开发者工具(Ctrl+Shift+I)→ 切换到Console标签页 → 复制最新报错信息,重点观察是否仍有Cannot find XXX executable字样。











