MCP 与扩展能力 · Trae 橙皮书

一、MCP 是什么（一句话讲清楚）

MCP（Model Context Protocol，模型上下文协议）= AI 工具的"USB 接口"。

我们用一个类比：

你有一台电脑。
你想接一个打印机、一个相机、一个 U 盘。
如果每个外设都有自己的接口，你的电脑就要长 100 个孔。
后来有了 USB——统一的标准接口，所有外设都用 USB 连，电脑只要长几个 USB 口就行。

AI 工具也一样：

一个 AI 工具想对接 Notion、Figma、飞书、邮件、日历……
如果每个对接都要单独写代码，AI 工具会变成一团糟。
有了 MCP——统一的标准协议，所有外部工具都按 MCP 协议对接，AI 工具只要支持 MCP 就能"用"所有工具。

MCP 是 Anthropic（Claude 母公司）2024 年底提出的标准，2025 年迅速被 Cursor、Trae、Continue 等所有主流 AI IDE 采纳，成为事实上的行业标准。

二、MCP 能让 Trae 多做什么

没装 MCP 时 Trae 能做：

读你电脑文件
跑命令
抓网页（#Web）

装上 MCP 之后，Trae 还能做：

MCP	Trae 能干嘛
Notion MCP	读你的 Notion 数据库、新建页面、查任务
Figma MCP	读你的 Figma 设计稿、把设计转成代码
飞书 MCP	读飞书文档、查群消息、发飞书消息
钉钉 MCP	读钉钉考勤、发钉钉通知
GitHub MCP	读你的仓库、提 PR、查 Issue
Google Drive MCP	读云端文档、新建文件
PostgreSQL/MySQL MCP	直接查你的数据库
Filesystem MCP	跨多个文件夹高级操作
Browser MCP	模拟用户操作浏览器（点按钮、填表单）
Brave/Tavily 搜索 MCP	比 #Web 更强的实时搜索

举几个让你眼睛发亮的例子：

装上 Notion MCP，对 Trae 说"把我 Notion 的'2026 OKR'数据库里所有未完成项做成一份周报 HTML"——Trae 自己读 Notion、做出周报。
装上 Figma MCP，对 Trae 说"这是我设计稿的链接 figma.com/xxx，按设计稿做出可运行的 React 网页"——Trae 自己读 Figma、生成代码。
装上飞书 MCP，对 Trae 说"把我今天 6 个群里聊天总结成一份'今日重点'，发到我的'每日重点'飞书文档"——Trae 自己读群、写文档。

三、MCP 的架构（看一眼就行，不用细学）

MCP 有三个角色：

┌──────────┐         ┌──────────┐         ┌──────────┐
│  AI 工具  │ <─────> │ MCP 协议  │ <─────> │ MCP 服务  │
│  (Trae)  │         │  (USB)   │         │  (外部)   │
└──────────┘         └──────────┘         └──────────┘
                                              │
                                              ▼
                                          外部世界
                                       （Notion / Figma /
                                          数据库 / API 等）

AI 工具（MCP Client）：Trae 是 client，它向 MCP Server 发请求。
MCP Server：每个外部工具有自己的 server（比如 Notion 有 "Notion MCP Server"），它把外部工具的能力"包装"成 MCP 协议接口。
协议本身：JSON-RPC 风格的标准请求/响应。

普通用户不用懂底层——你只要会"装一个 MCP Server、配一个 API Key、Trae 自动调用"就行。

四、Trae 怎么装 MCP

Trae 装 MCP 有三种方式，从易到难：

4.1 方式一：MCP 市场（最推荐）

Trae 内置了一个"MCP 市场"，里面有几百个常用 MCP，一键安装。

操作：

打开 Trae，右上角点"AI 功能管理" → "MCP"。
进入"MCP 市场"标签页。
搜索你想要的 MCP（比如 "Notion"、"Figma"）。
看到喜欢的，点"安装"。
弹窗让你填配置（一般是 API Token）。
填完点"启用"。

完成。 立刻在 Trae 对话里就能用。

带"轻松配置"小标志的 MCP 只需要填 API Key 就行，不用装什么环境。

4.2 方式二：手动配置（中等难度）

如果某个 MCP 不在市场里，你可以手动配。

找到 MCP 的 GitHub 页面（比如 github.com/modelcontextprotocol/servers）。
看 README 里的"How to use with Trae"或"How to use with Cursor"章节（Trae 兼容 Cursor 的配置）。
复制一段配置 JSON，粘贴到 Trae 的"AI 功能管理 → MCP → 编辑配置"里。

例子（Filesystem MCP 的配置）：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/your-name/Documents",
        "/Users/your-name/Desktop"
      ]
    }
  }
}

看不懂这段也没关系——直接告诉 Trae："帮我装 Filesystem MCP，让它能访问 ~/Documents 和 ~/Desktop"，Trae 会帮你写好配置并提示重启。

4.3 方式三：自己开发 MCP（高级，本章不展开）

如果你想做一个 MCP 让别人用——比如"我家的智能电饭煲 API"做成 MCP——那是高级用法。可以参考 modelcontextprotocol.io 官方文档。

五、装 MCP 前你需要安装的"基础环境"

很多 MCP 是用 Node.js / Python / uv 启动的。新手第一次用要先装这些"运行时"。

5.1 装 Node.js（绝大多数 MCP 都需要）

Mac：
```
brew install node
```
没装 Homebrew 的话，先去 brew.sh 一行命令装。装完后在终端运行 node -v，看到版本号就 OK。
Windows：

去 nodejs.org 下载 LTS 版本（推荐 20.x），双击安装。

5.2 装 uv / uvx（Python 类 MCP 需要）

Mac：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell 管理员）：
```
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```
装完后在终端运行 uvx --version，看到版本就 OK。

5.3 让 Trae 自己帮你装

最简单的方式：

@Builder

帮我检查我的电脑是否装了 Node.js 和 uv。
如果没装，按 macOS 的方式帮我装好。
装完后告诉我版本号。

Trae 会帮你跑命令、装好、验证。

六、10 个普通人优先装的 MCP

我们挑出最有价值的 10 个 MCP，按"价值密度"排序。

6.1 ⭐⭐⭐⭐⭐ Filesystem MCP（最该装的第一个）

作用：让 Trae 能访问你"当前项目之外"的文件夹。

为什么必装：默认 Trae 只能操作"当前打开的项目"，装了 Filesystem 后，它能跨越这个限制——

"把我桌面 photos 文件夹和下载文件夹合并整理"。
"读 Documents/合同文件夹里所有 PDF 提取关键信息"。

配置：在 MCP 市场搜 "Filesystem"，一键装。配置时指定 Trae 能访问的目录列表（一定要限制目录范围，不要给整个根目录权限）。

安全提醒：只给"你信任的目录"，不要给 /（系统根）或 /Users（整个用户目录）。

6.2 ⭐⭐⭐⭐⭐ Browser MCP（让 Trae 操作浏览器）

作用：让 Trae 能像真人一样"打开浏览器、点按钮、填表单、截图"。

典型用例：

"打开淘宝搜'佳能镜头'，截图前 5 个商品的价格"。
"登录我的 12306 账号，查明天去上海的所有高铁"（账号要自己提前在浏览器登录好）。
"自动填写我做的工具的 100 条测试数据"。

配置：MCP 市场搜 "Playwright" 或 "Browser MCP"，一键装。

注意：Browser MCP 让 AI 能"看见"和"点击"你电脑的浏览器，只在自己的私人电脑上用，不要在公司电脑用。

6.3 ⭐⭐⭐⭐⭐ Notion MCP（笔记爱好者必装）

作用：连通你的 Notion 工作区。

典型用例：

"把我 Notion '2026 OKR' 数据库里所有未完成项做成周报 HTML"。
"新建一个 Notion 页面叫'本周读书笔记'，把我桌面这些 .md 文件汇总进去"。
"查我 Notion '联系人'数据库里所有'A 类客户'，列出本月还没联系的"。

配置：

去 notion.so/my-integrations 创建一个 Integration，拿到 Token。
把你的工作区分享给这个 Integration（在 Notion 页面右上"Share" → "Add Connections"）。
在 Trae MCP 市场搜 "Notion"，安装，填 Token。

6.4 ⭐⭐⭐⭐ Figma MCP（设计师 / 前端必装）

作用：让 Trae 读你的 Figma 设计稿，把设计转成可运行代码。

典型用例：

"这是设计稿链接 figma.com/file/xxx，做出 React 版本"——准确率官方公布 91%。
"对比这个设计稿和我现有的页面，哪些地方没还原？"

配置：

Figma → Settings → 开发者 Token → 创建。
Trae MCP 市场搜 "Figma"，装，填 Token。

6.5 ⭐⭐⭐⭐ GitHub MCP（程序员 + 准程序员）

作用：让 Trae 操作你的 GitHub 仓库——读代码、查 Issue、提 PR、看 Action 状态。

典型用例：

"查我 GitHub 仓库 trae-book 最近 10 个 Issue，做一份'优先级排序'"。
"给我的 my-portfolio 仓库提一个 PR，把首页头图换掉"。

配置：去 GitHub Settings → Developer settings → Personal access token 创建，填到 MCP 配置里。

6.6 ⭐⭐⭐⭐ 飞书 MCP（中国用户工作必备）

作用：连通飞书生态——读文档、查群消息、发消息、改日历。

典型用例：

"把今天 3 个群的聊天总结成 '今日重点'，发到我的飞书云文档 '每日重点'"。
"找到我下周的所有日程，做一份桌面待办清单"。

配置：

在飞书开放平台创建"自建应用"，拿 App ID + Secret。
给应用授权"消息读写""文档读写""日历读写"等权限。
Trae MCP 市场搜 "Lark" 或 "飞书"，装，填配置。

6.7 ⭐⭐⭐ 钉钉 MCP

作用：连通钉钉——读考勤、发审批、推送通知。

典型用例：

"导出我团队 30 人本月考勤，做成 Excel"。
"通过钉钉机器人发一条'晚 8 点开会'到团队群"。

配置：钉钉开放平台创建应用 → 拿 AppKey/AppSecret → 配置到 Trae。

6.8 ⭐⭐⭐ PostgreSQL / MySQL MCP（数据库爱好者）

作用：让 Trae 直接查你的数据库——不用打开 Navicat / DBeaver。

典型用例：

"查我数据库 users 表，统计本月新增用户数，按地区分组"。
"找到 orders 表里金额最高的 10 单，关联用户信息"。

配置：在 MCP 市场搜对应数据库类型，填连接字符串（host/port/user/password）。

安全提醒：绝对不要连生产数据库——给 AI 一个只读账号，连开发库或测试库。

6.9 ⭐⭐⭐ Tavily / Brave Search MCP

作用：实时联网搜索。比 #Web（只能抓你给的链接）更强——它能让 AI"自主搜索一个主题"。

典型用例：

"搜一下 2026 年最受欢迎的 10 个 AI 产品，做一份对比表"。
"调研 DeepSeek 的最新动态，给我做一份摘要"。

配置：

Tavily：去 tavily.com 注册免费账号拿 API Key，每月免费 1000 次。
Brave Search：去 brave.com/search/api 拿 Key，免费 2000 次/月。

6.10 ⭐⭐⭐ Google Drive / OneDrive MCP

作用：连通你的云盘——读云文档、写云文件、备份。

典型用例：

"把我 Google Drive 上 2025 年所有合同 PDF 列出来"。
"把这份网页生成的报告自动备份到我的 OneDrive '2026 报告' 文件夹"。

配置：OAuth 授权，第一次会跳转浏览器登录。

七、装 MCP 之后怎么"在对话里调用"

装好之后，MCP 工具会自动对 Trae 可见。你不需要"启用"它——只要你的提问需要某个 MCP，Trae 自己会调。

例子：

@Builder

【用到 Notion MCP】
查我 Notion '2026 OKR' 数据库，做一份未完成项的周报 HTML。

Trae 收到这个请求，会：

识别需要 Notion MCP。
调用 Notion MCP 的"查询数据库"接口。
拿到数据。
生成 HTML。

整个过程对你透明——你只看到结果。

如果你想"明确指定用某个 MCP"，可以这样写：

@Builder

请使用 Notion MCP 查询...

八、MCP 的安全治理（必读）

MCP 给 Trae 强大能力的同时，也带来了风险。新手必须注意。

8.1 三大风险

凭据泄露——你给 MCP 的 API Token / 数据库密码，如果配置文件被偷或同步到公共仓库，泄露后果严重。
越权操作——AI 可能"自作主张"地干你没让它干的事，比如"删除 Notion 的某个数据库"。
Prompt Injection——网页内容、数据库内容里可能藏着恶意指令，让 AI 偏离你的意图。

8.2 安全配置 7 条铁律

API Token 用环境变量，不要硬编码到 mcp.json——配置示例：

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_API_KEY": "${NOTION_API_KEY}"
      }
    }
  }
}

Filesystem MCP 严格限制目录——只给你信任的目录，绝对不要给 /、/Users、~。
数据库给"只读账号"——专门为 AI 创建一个只能 SELECT 的账号，不允许 UPDATE/DELETE。
写敏感操作前 Plan→Act——任何会"删 / 改 / 发"的操作，让 AI 先输出方案，你确认。
重要数据先备份——"操作前 5 分钟先 Git commit / 先复制一份到 backup/"。
不要把 mcp.json 提交到 Git——把它加到 .gitignore。本地保留。
定期 review 已装的 MCP——每月看一次 MCP 列表，删掉不用的。

8.3 一份"安全的"`mcp.json` 示范

{
  "mcpServers": {
    "filesystem-safe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/me/Documents/safe-zone",
        "/Users/me/Desktop/work"
      ]
    },
    "notion-readonly": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_API_KEY": "${NOTION_API_KEY}",
        "NOTION_PERMISSION": "read"
      }
    },
    "tavily": {
      "command": "npx",
      "args": ["-y", "tavily-mcp"],
      "env": {
        "TAVILY_API_KEY": "${TAVILY_API_KEY}"
      }
    }
  }
}

注意：

所有 Token 用 ${VAR_NAME} 引用环境变量。
Filesystem 只给两个明确目录。
Notion 只给读权限（在 Notion 后台配）。

九、给不同人群推荐的"MCP 套餐"

9.1 「文字工作者套餐」

⭐ Filesystem
⭐ Notion
⭐ Tavily Search
⭐ Google Drive

做什么：写文章、整理资料、跨平台搬运、调研。

9.2 「设计师套餐」

⭐ Filesystem
⭐ Figma
⭐ Browser MCP
⭐ Notion

做什么：设计稿转代码、Figma 资源管理、跟进项目。

9.3 「销售 / 商务套餐」

⭐ Filesystem
⭐ 飞书 / 钉钉 MCP
⭐ Browser MCP
⭐ Tavily Search

做什么：跟单、客户调研、自动化报表、群消息总结。

9.4 「程序员套餐」

⭐ Filesystem
⭐ GitHub MCP
⭐ PostgreSQL/MySQL MCP
⭐ Browser MCP
⭐ Tavily Search

做什么：跨仓库操作、查数据库、E2E 测试、技术调研。

9.5 「生活类套餐」

⭐ Filesystem
⭐ Browser MCP

够了——生活类需求一般在本地完成，少数联网用 #Web 即可。

十、MCP 实战：3 个让你眼睛发亮的例子

10.1 用 Notion MCP + DeepSeek-V3 做"周报自动化"

@Builder

【已装 Notion MCP】

每周日 19:00 帮我做一份周报：

1. 查我 Notion 数据库 "Tasks"，筛选本周（周一到周日）状态为"完成"的所有任务。
2. 按"项目"分组。
3. 每个任务用 STAR 模型润色（情境-任务-行动-结果）。
4. 输出 weekly-report.html，配色 #FF6B35 + 白。
5. 发到飞书机器人 webhook（URL 我配置在 .env）。

请帮我把这个流程做成一个脚本 weekly_report.py，
我会用 cron 定时跑。

10.2 用 Figma MCP + DeepSeek-V3 做"设计还原"

@Builder

【已装 Figma MCP】

这是我的 Figma 设计稿链接：
https://www.figma.com/file/abc123/Landing-Page

请：
1. 读取设计稿。
2. 分析布局结构（Hero、特性、CTA、Footer）。
3. 用 React + TailwindCSS 实现。
4. 严格按设计稿的颜色、字号、间距。
5. 移动端适配。
6. 输出到 src/ 目录。

【先告诉我方案，我确认后再写】

10.3 用 Browser MCP + Tavily 做"竞品调研报告"

@Builder

【已装 Browser MCP + Tavily MCP】

我要做一份"国内 AI IDE 竞品调研"，对象是：Trae、Cursor 中国版、CodeBuddy、通义灵码。

请：
1. 用 Tavily 搜每个产品的最新动态、价格、用户评价。
2. 用 Browser MCP 访问每个产品的官网，截图首页、价格页。
3. 整理成对比表（功能 / 价格 / 模型 / 用户量 / 优势 / 劣势）。
4. 输出到 competitive-analysis.html，含截图和数据来源链接。

【先告诉我方案，我确认后再写】

十一、本章一图回顾（文字版）

MCP 是什么？
    │
    └─ AI 工具的"USB 接口"，让 Trae 能对接外部世界

装 MCP 三种方式
    │
    ├─ MCP 市场（一键装，最推荐）
    ├─ 手动配置（复制 JSON）
    └─ 自己开发（高级）

10 个推荐 MCP
    │
    ├─ ⭐⭐⭐⭐⭐ Filesystem (跨目录)
    ├─ ⭐⭐⭐⭐⭐ Browser (操作浏览器)
    ├─ ⭐⭐⭐⭐⭐ Notion (笔记)
    ├─ ⭐⭐⭐⭐ Figma (设计稿转代码)
    ├─ ⭐⭐⭐⭐ GitHub (代码仓库)
    ├─ ⭐⭐⭐⭐ 飞书 (国内办公)
    ├─ ⭐⭐⭐ 钉钉
    ├─ ⭐⭐⭐ PostgreSQL/MySQL
    ├─ ⭐⭐⭐ Tavily/Brave Search
    └─ ⭐⭐⭐ Google Drive

安全 7 铁律
    │
    ├─ Token 用环境变量
    ├─ Filesystem 限目录
    ├─ 数据库给只读账号
    ├─ 敏感操作 Plan→Act
    ├─ 重要数据先备份
    ├─ mcp.json 不提交 Git
    └─ 定期 review

十二、本章常见的疑问

Q1：装 MCP 收钱吗？

MCP 本身免费。但有些 MCP 对接的"外部服务"可能要付费（比如 Tavily 超过免费额度）。

Q2：MCP 装多了 Trae 会变慢吗？

会一点点。每个 MCP Server 占一点资源。新手装 3-5 个就够，不要一次装 30 个。

Q3：我能让我自己做的工具变成 MCP 让别人用吗？

能。MCP 是开放协议，去 modelcontextprotocol.io 看官方教程。

Q4：装 MCP 之后我的 Token 会被字节看到吗？

MCP 配置文件在你本机。Token 不会上传到字节——MCP Server 在你本机跑，调外部 API 也是从你本机出去。

Q5：用 MCP 调用外部 API 算 Token 费吗？

用 MCP 调用本身免费。Trae 给你回答的过程会消耗对应模型的 Token 额度——国内版免费、国际版按订阅。

Q6：我的电脑装 MCP 之后，电脑被远程攻击的风险大吗？

只装"知名 MCP"（市场里的、modelcontextprotocol 官方的），风险极低。不要装来源不明的 MCP——这才是真正的风险。

下一章第十章自定义智能体与 AI 团队，我们学习创建你自己的"AI 员工团队"——前端工程师、文案策划、数据分析师、设计师，让它们配合干活。

第九章 MCP 与扩展能力

一、MCP 是什么（一句话讲清楚）

二、MCP 能让 Trae 多做什么

三、MCP 的架构（看一眼就行，不用细学）

四、Trae 怎么装 MCP

4.1 方式一：MCP 市场（最推荐）

4.2 方式二：手动配置（中等难度）

4.3 方式三：自己开发 MCP（高级，本章不展开）

五、装 MCP 前你需要安装的"基础环境"

5.1 装 Node.js（绝大多数 MCP 都需要）

5.2 装 uv / uvx（Python 类 MCP 需要）

5.3 让 Trae 自己帮你装

六、10 个普通人优先装的 MCP

6.1 ⭐⭐⭐⭐⭐ Filesystem MCP（最该装的第一个）

6.2 ⭐⭐⭐⭐⭐ Browser MCP（让 Trae 操作浏览器）

6.3 ⭐⭐⭐⭐⭐ Notion MCP（笔记爱好者必装）

6.4 ⭐⭐⭐⭐ Figma MCP（设计师 / 前端必装）

6.5 ⭐⭐⭐⭐ GitHub MCP（程序员 + 准程序员）

6.6 ⭐⭐⭐⭐ 飞书 MCP（中国用户工作必备）

6.7 ⭐⭐⭐ 钉钉 MCP

6.8 ⭐⭐⭐ PostgreSQL / MySQL MCP（数据库爱好者）

6.9 ⭐⭐⭐ Tavily / Brave Search MCP

6.10 ⭐⭐⭐ Google Drive / OneDrive MCP

七、装 MCP 之后怎么"在对话里调用"

八、MCP 的安全治理（必读）

8.1 三大风险

8.2 安全配置 7 条铁律

8.3 一份"安全的"mcp.json 示范

九、给不同人群推荐的"MCP 套餐"

9.1 「文字工作者套餐」

9.2 「设计师套餐」

9.3 「销售 / 商务套餐」

9.4 「程序员套餐」

9.5 「生活类套餐」

十、MCP 实战：3 个让你眼睛发亮的例子

10.1 用 Notion MCP + DeepSeek-V3 做"周报自动化"

10.2 用 Figma MCP + DeepSeek-V3 做"设计还原"

10.3 用 Browser MCP + Tavily 做"竞品调研报告"

十一、本章一图回顾（文字版）

十二、本章常见的疑问

8.3 一份"安全的"`mcp.json` 示范