TraeWork 的 MCP 支持：能接什么、在哪配、边界在哪

2026-08-17

一、什么时候你会想起 MCP 这回事

大多数人不是先看到 MCP 才想用它的。真实的顺序往往是这样：你让智能体去查一份放在内部系统里的数据，它查不到；你让它把结论写回某个第三方工具，它做不了；你把链接贴给它，它只能读到公开页面上那点东西。这时候你才会去搜「怎么让它连上我们自己的系统」，然后搜到 MCP。

TraeWork 官方文档《MCP 概述》对这件事的定位写得很直白：当你需要 AI 接入并使用外部资源或能力时，可以使用 MCP。文档同时写明，Model Context Protocol 是一种允许大型语言模型访问自定义工具和服务的协议，TraeWork 中的智能体作为 MCP 客户端，可以选择向 MCP Server 发起请求，以使用它们提供的工具；你可以自行添加 MCP Server，并添加到自定义的智能体中来使用。

这里有两句话值得单独拎出来。第一句是「作为 MCP 客户端」——也就是说 TraeWork 站在调用方那一侧，Server 是别人的。第二句是「添加到自定义的智能体中来使用」——文档把「添加 Server」和「让某个智能体用上它」写成了两个动作。至于自定义智能体那一侧的配置细节，本篇不展开。

需要先说清楚的前提是：TraeWork 是一款仍在快速迭代的产品，官方文档里能看到明确的版本分界线（例如沙箱那篇写着「自 0.1.20 版本起，TraeWork 桌面版在 macOS 上的 Work 模式采用与 Code 模式一致的沙箱策略」）。本文所有内容都是 2026-08-17 这天的文档口径，功能、字段与计费口径都可能随版本变动。

二、官方文档写明它怎么用

支持哪些传输类型

《MCP 概述》给了一张传输类型表，一共三行：

类型	传输协议	执行环境
stdio	stdio	本地
HTTP	SSE	本地 / 远程
	Streamable HTTP	本地 / 远程

读这张表要注意最右边那一列。stdio 那一行写的是「本地」，没有「远程」；《添加 MCP Server》那篇对这个类型的说明是「stdio 类型的 MCP Server 通过标准输入（stdin）和标准输出（stdout）与客户端进行通信」。两处放在一起，能确定的只有「文档给 stdio 标的执行环境只有本地这一项」，再往下的实现细节文档没有写。HTTP 类型下面挂着 SSE 与 Streamable HTTP 两种协议，执行环境都是「本地 / 远程」。

本地环境与云端环境是两套

概述页还有第二张表，讲 MCP 的运行环境，这张表比传输类型表更容易踩坑：

环境类型	适用任务	适用客户端
本地	仅对本地任务生效。	TraeWork 桌面版
云端	仅对云端任务（及从 GitHub 拉取的项目）生效。	TraeWork 网页版、桌面版

两个「仅」字是关键。配在本地环境下的 MCP Server，官方写的是仅对本地任务生效；配在云端环境下的，仅对云端任务（及从 GitHub 拉取的项目）生效。也就是说，同一个 Server 你在一边配好了，另一边并不会自动拥有它。文档没有说明两套环境之间是否存在任何同步或复用机制，这一点核不出来。

再把《TraeWork 概述》里的三端说明放在一起看：TraeWork 提供网页版、桌面版和移动版三种形态。而运行环境这张表里，「本地」那一行的适用客户端只写了桌面版。这两处放在一起，能得到的结论仅限于「文档把本地 MCP 的适用客户端限定在了桌面版」，再往下就是推断了，不写。

添加的路径与配置字段

《添加 MCP Server》那篇写明有两条路：从 TraeWork 内置的 MCP 市场添加，或者手动配置。两条路的入口是同一个：界面左下角的头像 > 设置，在左侧导航栏中选择 MCP，进入 MCP Server 管理面板；然后在「MCP Servers 管理」部分右上角，点击「创建」，再选「从市场添加」或「手动配置」。

这条路径里有一句限定条件，是本篇最值得你记住的一条：文档在两处步骤里都用括号标了「(仅 TraeWork 桌面版) 选择 MCP Server 的运行环境：本地 / 云端」。也就是说，运行环境这个选择动作，官方文档只写在桌面版上有。网页版怎么处理这一步，文档里我们没有找到对应说明。

从市场添加时，文档有一条提示：配置内容中的 env 信息（例如 API Key、Token、Access Key 等字段）须替换为真实信息。手动配置那条路径下另有一条提示，原文写的是「优先使用 NPX 或 UVX 配置，因为它们支持在无需全局安装的情况下直接运行 MCP Server，并自动完成依赖获取与版本解析，从而简化配置流程并降低环境冲突风险」——这是文档自述的理由，不是我们的判断。

配置说明部分列了字段表。stdio 类型三个字段：

command（必填）：用于启动 MCP Server 的可执行命令，该命令必须位于系统 PATH 中，或使用可执行文件的完整路径。文档专门加了「注意」：命令中不能包含空格，否则会导致解析错误。
args（选填）：启动命令的参数列表，每个参数必须为字符串类型。
env（选填）：传递给 MCP Server 的环境变量，每个环境变量的值必须为字符串。

HTTP 类型两个字段：url（必填，需为合法的 HTTP 或 HTTPS URL）、headers（选填，用于携带鉴权信息等额外信息）。

超时这一块的写法有点反直觉，值得单记：stdio 类型通过 env 字段设置超时，HTTP 类型通过 headers 字段设置，两个变量名相同——START_MCP_TIMEOUT_MS（启动 MCP Server 的超时时间，单位 ms）与 RUN_MCP_TIMEOUT_MS（调用 MCP Server tools 的超时时间，单位 ms）。文档示例里两个值都写成 "60000"；这是示例中出现的值，文档没有写明不配置时的默认超时是多少。

变量引用部分写得很克制：MCP Server 的配置支持使用变量，目前仅支持 ${workspaceFolder}，在 MCP Server 启动时会被自动替换为当前项目的实际根目录路径。只有这一个变量，别按别的编辑器的习惯去写其它变量名。

三、边界在哪：这一段才是重点

官方把责任划得很清楚

《MCP 概述》正文里有一整段免责声明，原文写明：MCP Server 由第三方构建和维护，TraeWork 不审查或认可这些服务器，并且不对其行为、任何 MCP Server 调用失败或它们返回的数据承担任何责任；部分 MCP Server 也可能因相关法律法规、网络限制、或服务器自身的访问策略，在你所在的国家或地区无法访问或使用，TraeWork 无法控制这些因素，亦无法保证可用性或功能性。

这段话的实际含义是：市场里出现过的 Server，不等于官方替你审过。 调用失败、返回脏数据、某天连不上，按文档口径都不在产品的承诺范围内。要接内部系统或者带密钥的第三方服务，这段声明应该先给决定要不要接的那个人看一遍。

默认要审批，而且开关不止一个

MCP 工具调用在 TraeWork 里是被权限体系管着的，散落在三处文档里，拼起来才完整。

其一，《自定义权限模式配置参考》的场景规则表里有一行 mcpToolApproval，类型 bool，默认值 true，描述是：MCP 工具调用默认是否需要审批；设为 true 时，所有未被全局权限配置中的 customProfiles.defaultCustomProfile.approval.mcpRules 字段显式配置的 MCP 工具调用都需要经过审批。

其二，《自定义全局权限配置参考》里的 mcpRules，用于按 MCP Server 或 MCP 工具配置审批与执行策略。key 是匹配模式，支持三种写法：精确匹配 mcpserver__mcptool、Server 通配 mcpserver__* 或直接写 mcpserver（匹配该 Server 下所有工具）。value 里的 approval 取 allow（直接放行）、ask（触发审批确认）、deny（直接拒绝）。文档示例里就有 "github__*": {"approval": "ask"} 这样的写法。

这两处配置都在同一个文件里——《权限审批概览》写明，资源授权、规则和自定义权限模式配置通过 ~/.trae-cn/permission/global.json 文件管理。同一篇还有一条提示很容易被忽略：如果使用 Remote SSH 或 WSL 连接到远端设备，需要单独为该设备配置自定义配置，无法复用本机的自定义配置。

其三，《对话流设置》里有一个叫「自动运行 MCP」的设置项，描述是「开启后，在使用智能体时将自动运行 MCP Server 及其内部的工具。使用该功能需要考虑安全性问题」——安全性那句话是官方文档自己写的。同一篇开头还标了一条前提：仅 TraeWork 桌面端支持对话流设置。

权限体系本身也有适用范围

《权限审批概览》第一节就写明：「权限与审批」功能仅作用于 TraeWork 中的本地任务，云端任务皆运行于隔离的云端环境，无需配置权限模式。另外，预设的三种权限模式里，「完全访问」那一档文档写的是：沙箱关闭，命令直接在宿主机执行，文件系统完全读写，所有安全检查已禁用，不会触发审批。这一档配上「自动运行 MCP」意味着什么，文档没有替你算，我们也不替你算——但这是一条需要你自己评估的高权限组合。

文档没有说明的部分

按这批文档能核到的范围，下面这些一个字都写不出来，只能照实说：

MCP 市场里一共收录了多少个 Server、按什么标准收录——官方文档没有说明这一点。
单个环境下能添加多少个 MCP Server、有没有数量上限——官方文档没有说明这一点。
MCP 工具调用是否单独消耗积分、按什么口径计——我们没有在这批文档里找到对应说明。TraeWork 的计费口径请以官方最新公告与定价页为准。
不配置 START_MCP_TIMEOUT_MS / RUN_MCP_TIMEOUT_MS 时的默认超时值——文档只在示例里给了 "60000"，没有写明默认值。
云端环境下的 MCP Server 用什么方式拉起、${workspaceFolder} 在云端解析成什么——官方文档没有说明这一点。

四、什么情况下你会用到它，什么情况下不必开

会用到的情况其实很集中：智能体需要读写一个它天然够不着的系统，而那个系统已经有现成的 MCP Server。文档里出现过的一个具体例子是设计相关的场景——《TraeWork 必装的 14 个 Skill》那篇写明，在使用 figma 技能前，你需要从 TraeWork 的 MCP 市场添加「Figma AI Bridge」这一 MCP Server。这是文档里少有的把「某个能力依赖某个具体 Server」写死的地方，也说明有些技能不是装上就能跑。

不必开的情况也很清楚。如果你要做的事在本地文件和终端命令的范围内，MCP 只是多引入一个第三方进程或远程服务，多一层出错面。如果你的任务主要跑在云端，而 Server 只配在了本地环境，按文档口径它对云端任务不生效，配了也是白配——反过来同理。

真要接，有三件事建议按顺序确认：先确认这个 Server 该配在本地还是云端环境，因为它决定了对哪类任务生效；再确认 env 里那些 API Key、Token 的来源与保管方式，文档只说了「须替换为真实信息」，怎么保管是你自己的事；最后确认 mcpToolApproval 与 mcpRules 的当前取值，别在不知情的状态下让一批工具处于直接放行的状态。

以上关于配置顺序的建议属于通用做法，不是 TraeWork 官方文档的内容；文档里的字段名、默认值与限制条件才是本文的依据来源。

本文依据 TraeWork 官方文档（docs.trae.cn）于 2026-08-17 的公开内容整理。 我们没有开通付费账号，也没有实际操作过该产品，因此不涉及界面外观、操作手感与生成质量的任何描述。该产品仍在快速迭代，功能与计费口径随版本变动，文中涉及积分与套餐的表述均为复述官方文档原文，请以官方最新公告与定价页为准。

安全与合规相关做法请结合自身环境评估，本文不构成安全方案建议。