TRAE MCP 配置与故障排查

先选择正确的配置范围

中国区官方文档支持市场安装、手动配置和项目级 .trae/mcp.json。地区客户端可能不同，请核对已安装版本的实际选项。只为可信工作区在设置中启用项目 MCP。

最小项目配置文件

这是有效的空配置，并非可用的集成。请加入服务端官方维护者提供的配置块，将命令与参数分开，并避免在共享项目文件中保存凭据。

{
  "mcpServers": {}
}

示例：使用 Playwright MCP 测试本地网页

微软的 Playwright MCP 仓库提供基于 npx 的服务端配置。下方示例采用 TRAE 文档中的 mcpServers 结构。先安装受支持的 Node.js 版本，再将配置写入 .trae/mcp.json 并启用项目 MCP。-y 参数允许 npx 无需交互确认即可安装软件包。这是依据文档编写的模板，我们尚未在 TRAE 客户端内实际运行。

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}

启动本地开发服务器。
先让 Agent 打开本地网址并报告页面标题，再进行修改。
服务端无法启动时，检查日志以及 IDE 能找到的 Node.js 可执行文件。
团队需要可复现配置时，请在验证后固定软件包版本。

定位出错的层级

启用多个集成之前，先测试一个服务端和一次无害的读取操作。

JSON：删除注释和末尾多余的逗号，并验证文件格式。
本地进程：确认已安装 npx 或 uvx，并且 IDE 进程可以找到它。
可执行文件：command 填写程序，args 填写其参数。
认证：核对服务端文档要求的凭据与权限。
连接：修改超时设置前，先从 MCP 服务端日志查看实际错误。

按任务选择集成

代码仓库先从只读代码或问题查询开始；数据库先使用受限查询账号；浏览器测试先使用本地开发页面。服务出现在市场中，不代表应给予无限制访问权限。