TraeWork 的远程 MCP Server：跟本地 MCP 的区别在哪
一、先说清楚你为什么会撞上这个问题
会翻到这一页的人，处境通常是两种之一。
第一种：你在桌面版里配好了一个 MCP Server，用得好好的，换个场景（比如网页版，或者一个从 GitHub 拉下来的项目）再让 AI 干同样的活，工具就不在了。你会本能地怀疑是配置没保存，或者是权限没给。
第二种：你要接的东西根本不在本机上——公司内部的一个 HTTP 服务、一个团队自己搭的 MCP 网关，它有地址、有鉴权头，但没有任何可以在你电脑上跑起来的可执行命令。
这两种处境对应的是 TraeWork 官方文档里两个完全不同的概念，偏偏它们用的词都叫「本地」和「远程 / 云端」。把它们混成一件事，是这一块最容易踩的坑。
先说一个容易迷惑人的细节：官方这篇文档的网址里写着 remote-mcp-server，但页面标题是「添加 MCP Server」；「远程 MCP Server」这个说法在正文里只出现在 url 字段的描述中（「远程 MCP Server 的访问地址」），并没有被单独定义成一类东西。真正的区别被拆在《MCP 概述》那一页的两张表里——一张叫「传输类型」，一张叫「MCP 的运行环境」。
二、官方文档写明它怎么用
两张表，两个维度
《MCP 概述》里的第一张表讲传输类型，也就是 MCP Server 本身怎么跟客户端通信、跑在哪：
| 类型 | 传输协议 | 执行环境 |
|---|---|---|
| stdio | stdio | 本地 |
| HTTP | SSE | 本地 / 远程 |
| Streamable HTTP | 本地 / 远程 |
第二张表讲 MCP 的运行环境，也就是这条配置对哪类任务生效：
| 环境类型 | 适用任务 | 适用客户端 |
|---|---|---|
| 本地 | 仅对本地任务生效 | TraeWork 桌面版 |
| 云端 | 仅对云端任务（及从 GitHub 拉取的项目）生效 | TraeWork 网页版、桌面版 |
这两张表里各有一个「本地」，指的不是一回事。前一张说的是 MCP Server 这个进程在哪里被拉起来（stdio 类型只能在本地），后一张说的是 TraeWork 这边的任务在哪里跑、因而哪一份 MCP 配置会被带上。文档把它们分成两节写，也没有说明两者如何组合。开头那个「换个场景工具就不在了」的现象，对得上的正是第二张表里那句「仅对本地任务生效 / 仅对云端任务生效」——两套配置是分开的。
添加入口
官方文档给出的路径是：头像 > 设置，再选 MCP，进入 MCP Server 管理面板。文档在这里特别标了一句括号——「仅 TraeWork 桌面版」才有选择运行环境（本地 / 云端）这一步。之后在「MCP Servers 管理」部分走 创建，有两条路：从市场添加（TraeWork 内置的 MCP 市场，文档称其中提供社区中热门的 MCP Server）和手动配置。
从市场添加时，文档提示配置内容中的 env 信息（例如 API Key、Token、Access Key 等字段）须替换为真实信息——也就是说，密钥是落在这份 MCP 配置里的，不是别的地方。
两类配置的字段
手动配置用 JSON。stdio 类型三个字段：
| 字段 | 是否必填 | 描述 |
|---|---|---|
command | 是 | 启动 MCP Server 的可执行命令，必须位于系统 PATH 中，或使用可执行文件的完整路径 |
args | 否 | 启动命令的参数列表，每个参数必须为字符串类型 |
env | 否 | 传递给 MCP Server 的环境变量，每个环境变量的值必须为字符串 |
command 那一行还挂了一条注意：命令中不能包含空格，否则会导致解析错误。这条值得单独记一下——Windows 上带空格的安装路径非常常见，一旦你把完整路径填进 command，这条限制就直接咬人。
HTTP 类型两个字段：url（必填，需为合法的 HTTP 或 HTTPS URL）、headers（可选，自定义 HTTP 请求头，用于携带额外信息如鉴权信息）。文档给的示例里 headers 放的就是 Authorization。
至于该选哪一种，文档只在手动配置那一步写了一句提示：优先使用 NPX 或 UVX 配置，理由是文档自述「支持在无需全局安装的情况下直接运行 MCP Server，并自动完成依赖获取与版本解析，从而简化配置流程并降低环境冲突风险」。这句针对的是 stdio 那一支。
超时怎么写：这里反直觉
两类 MCP Server 都能设超时，参数名相同——START_MCP_TIMEOUT_MS（启动 MCP Server 的超时时间）和 RUN_MCP_TIMEOUT_MS（调用 MCP Server tools 的超时时间），单位都是毫秒。但放的位置不同：stdio 类型写在 env 里，HTTP 类型写在 headers 里。
也就是说，在 HTTP 这一侧，你要把两个纯客户端行为的超时值当成 HTTP 请求头发出去。文档就是这么写的，没有解释为什么这么设计，我们也不去猜。你只需要记住：照抄位置，别把它们塞进 env，HTTP 类型的配置字段表里根本没有 env 这一项。
变量引用只有一个
配置支持使用变量，但文档写得很死：目前仅支持 ${workspaceFolder}，在 MCP Server 启动时被自动替换为当前项目的实际根目录路径。示例里它出现在 args 中，用来拼一个项目内脚本的路径。文档把这一节写在通用的「变量引用」标题下，但给的例子是 stdio 的 args；HTTP 类型的 url 或 headers 里是否同样会被替换，官方文档没有说明这一点。
三、边界在哪
这一段是本篇的重点，全部来自官方文档白纸黑字的表述。
第一，第三方 MCP Server 的一切后果由你自己担。 《MCP 概述》里有一段独立的免责声明，原话意思是：MCP Server 由第三方构建和维护，TraeWork 不审查或认可这些服务器，并且不对其行为、任何 MCP Server 调用失败或它们返回的数据承担任何责任。这不是一句客套话——它同时意味着市场里列出的那些 MCP Server 并不等于被官方审核过。
第二，可用性本身不被保证。 同一段声明还写明：部分 MCP Server 可能因相关法律法规、网络限制、或服务器自身的访问策略，在你所在的国家或地区无法访问或使用；TraeWork 无法控制这些因素，亦无法保证可用性或功能性；使用时应自行确保遵守当地法律法规。对远程 HTTP 类型来说，这句话的分量比 stdio 那一支重得多——你依赖的是别人服务器的连通性。
第三，运行环境的选择只在桌面版有。 文档在添加流程里两次标了「仅 TraeWork 桌面版」这个括号。网页版没有这一步选择，对应到运行环境表里那句「TraeWork 网页版中的任务皆在云端环境中运行」（这句出自《云端运行环境》一文）。
第四，云端那一侧还叠着另一层限制。 如果你的 MCP 是要在云端任务里用，《云端运行环境》文档里几条硬限制会一起生效：自定义云端运行环境只能在 Code 模式中使用；桌面版走云端环境的前提是打开一个从 GitHub 拉取的远程项目；容器镜像方面文档明写暂不支持由用户自定义容器镜像；网络方面明写暂不支持由用户自定义网络策略，出站流量走固定模式的白名单，允许访问的常用依赖源文档列了 10 个：npm、pypi、maven、goproxy、rubygems、packagist、crates、docker、github、gitlab。这几条限定的是云端运行环境自身的出站范围；至于云端任务里的 MCP 调用是否也受同一份网络策略约束，官方文档没有说明这一点，我们核不出来。
第五，密钥的存放位置要分清。 MCP 的 env / headers 是一处，《云端运行环境》里的「敏感变量」是另一处，两者是不同的配置面板。后者文档写明用 KMS 加密存储、API 仅返回 key 列表不返回值、最多 50 个（对照的普通环境变量是明文 JSON 存储、最多 100 个）。MCP 配置里的 env 与 headers 是否有同等的加密与数量约束，官方文档没有说明这一点。（以下为通用做法、非该产品官方文档内容：涉及长期有效的凭据时，先按可轮换、最小权限的思路准备，具体请结合自身环境评估。）
第六，没写的就是没写。 MCP Server 的数量上限、单个工具返回内容的大小限制、失败后是否重试、云端环境里 MCP 进程的生命周期——这些我们在官方文档里都没有找到对应说明。
另外提醒一句口径问题：TraeWork 仍在快速迭代，官方文档里挂着「以积分为核心的计费模式正式上线」的更新公告，功能与计费口径都可能随版本变动，上面这些字段名和限制请以官方最新文档为准。
四、什么时候你会用到它，什么时候不必开
会用到远程（HTTP / Streamable HTTP）这一支的情形：你要接的能力压根没有本地可执行文件，只有一个 URL 加一套鉴权头；或者你主要在网页版工作，而 stdio 类型按文档只能在本地执行环境跑；再或者同一套工具要给多人用，你不希望每个人本机都装一遍依赖。
继续用 stdio 的情形：工具需要读写你本机的文件，尤其是需要 ${workspaceFolder} 拼出项目内路径的那类——目前唯一支持的变量就是它，而它的示例场景正是 stdio 的 args。
不必开的情形：如果你要做的事产品自带能力已经覆盖，先别急着加 MCP。每加一个第三方 MCP Server，你就把「不审查、不认可、不对调用失败与返回数据负责」这段免责声明的风险接到自己头上，还要多管一份密钥。以及，如果你是桌面版用户又主要跑本地任务，云端那一侧的配置加了也不生效——它按文档「仅对云端任务（及从 GitHub 拉取的项目）生效」。
最后回到开头那个现象：配置好好的、换个地方工具就不见了。先别怀疑自己手抖，去看看当时选的运行环境是本地还是云端，以及这个任务本身跑在哪一侧。这两张表对不上，工具就不会出现。
本文依据 TraeWork 官方文档（docs.trae.cn）于 2026-08-17 的公开内容整理。
我们没有开通付费账号，也没有实际操作过该产品，因此不涉及界面外观、操作手感与生成质量的任何描述。
该产品仍在快速迭代，功能与计费口径随版本变动，文中涉及积分与套餐的表述均为复述官方文档原文，
请以官方最新公告与定价页为准。
安全与合规相关做法请结合自身环境评估，本文不构成安全方案建议。