trae中mcp服务调用失败的首要原因是mcp host未激活或服务端未正确启动。需先检查设置中“mcp host is active”绿色提示，若无则升级至2.4.0+并清缓存重启；再确保终端能直接运行配置的command命令，路径、参数、环境变量须严格匹配文档要求，且filesystem等服务需将args路径设为实际工作区根目录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在Trae编辑器里右键菜单找不到MCP工具项，或AI调用时提示“tool not found”，说明MCP协议通道未建立或服务端未被正确识别。这通常不是插件没装，而是服务启动失败、配置路径错误或权限限制导致的静默中断。
确认MCP Host是否激活
打开Trae → 设置 → AI Management → MCP选项卡，检查顶部是否有绿色提示“MCP Host is active”。没有该提示，说明Trae内置MCP运行时未启用，需升级至2.4.0+稳定版并重启应用。
若显示“Not available”，直接退出Trae，删除%APPDATA%RoamingTraecache目录后重开——旧缓存可能阻塞Host初始化。
验证MCP Server命令能否手动执行
这是最关键的一步。终端中直接运行Trae配置里写的启动命令，例如：
npx -y @modelcontextprotocol/server-filesystem "G:/workspace"
如果报错command not found或spawn ENOENT，说明对应MCP服务端未安装，或系统找不到可执行文件。
【必须确保命令在终端能成功运行，Trae才可能调用它】。不要跳过这步直接改配置。
常见失败原因：Windows下命令缺.exe后缀（如uvx应为uvx.exe），或npm全局bin目录未加入PATH。
检查MCP Servers配置路径与参数
进入Trae设置 → MCP → 已配置的MCP Servers → 编辑对应服务（如MySQL_Server或filesystem）。
重点核对以下三项：
• command字段：不能写成mysql_mcp_server，而应是完整可执行路径，如node或npx或python；
• args数组：路径参数必须用正斜杠/（即使Windows也认G:/workspace），且多个目录需按服务端文档支持方式传入；
• env环境变量：MySQL类服务需显式注入MYSQL_PWD或WEREAD_COOKIE等敏感凭据，不能只靠系统环境变量。
排查filesystem工具的目录白名单限制
如果你尝试读取G:workspaceprojectsrcmain.java却失败，错误提示path outside allowed directories，说明filesystem服务只被授权访问桌面路径。
打开Trae的MCP Servers配置，找到filesystem条目，将args中唯一路径从"C:\Users\lenovo\Desktop"改为你的实际工作区路径，例如"G:/workspace"。
注意：路径末尾不加斜杠，多个目录暂不支持，必须选一个根目录覆盖全部子路径。
启用verbose日志定位卡点
在终端中以调试模式启动Trae：
trae --verbose
观察输出中是否出现MCP server initialized。如果没有，说明卡在模块加载阶段；如果出现但后续无工具注册日志，说明@mcp.tool()函数未被扫描到——检查该函数是否位于__main__.py或tools/子目录下，且文件名不含特殊字符或空格。
