企业官网建设流程全解析

1. 为什么新手配 Trae 总卡在 MCP 和 Skill 这一步

刚下载 Trae 的人，十个里有八个会经历同一个流程：装完软件，打开界面，然后愣住。左侧面板有个下拉框写着 Chat，右上角有个齿轮图标，设置里翻到「MCP」和「规则与技能」两个陌生词，网上搜到的教程又全是「推荐装这几个 MCP」「这几个 Skill 必装」，却没人从头讲清楚按钮在哪、配置粘到哪、装完怎么确认它真的生效了。

这篇就是补上这一段。Trae 的 MCP 和 Skill 配置，本质上是两件事：MCP 是给 AI 接上外部工具的手，让它能读 GitHub、查文档、操作文件；Skill 是给 AI 装上领域大脑，让它按你定义的规范干活。模式选择则是决定 AI 用多大的自主权去执行任务。三件事配齐，Trae 才从「聊天玩具」变成能真正改代码的开发搭档。

适合谁看：刚接触 AI 编程、第一次用 Trae、之前只会在对话框里问问题、没碰过 MCP 配置文件和 Skill 目录结构的人。全程按步骤走，每一步都带验证动作，配完能自己确认状态，不用猜。

我试过把 MCP、Skill、模式三块拆开单独配，结果发现顺序错了会互相干扰——比如先装一堆 Skill 再配 MCP，AI 调用工具时会被 Skill 里的规则带偏。所以下面按「先模式认知 → 再 MCP → 再 Skill → 最后串起来验证」的顺序走，这个顺序踩坑最少。

在开始之前，先把环境确认一遍，这一步省掉后面全是报错。Trae 版本要 ≥ 3.3.21，低于这个版本不支持 Skill 功能，打开 Trae 左下角齿轮 → 关于，看版本号。Node.js ≥ 16.0，终端跑node -v确认；Python ≥ 3.8，跑python --version确认；npx 跟着 Node.js 自动装好，跑npx --version确认。这三个没装，MCP 和 Skill 装了也跑不起来，因为大部分 MCP Server 是靠 npx 启动的本地进程。

安装路径和项目路径都别带中文和空格，比如D:\DevTools\Trae可以，D:\我的工具\Trae不行。这个坑很隐蔽，MCP 启动时命令行解析路径会出错，报错信息还看不出是路径问题。

环境确认完，下面进入正题。

2. Trae 模式选择对照表与切换位置详解

Trae 的模式不是一个按钮切来切去，而是分成两个世界：IDE 模式和 SOLO 模式。很多人找不到模式在哪切，是因为把这两个世界混在一起找了。

IDE 模式的入口在左侧 Chat 面板。按Ctrl+L（macOS 是Cmd+L）打开 AI 面板，面板顶部有个下拉菜单，默认显示 Chat，这就是模式选择器。点开它，列表里会出现 IDE 模式下的三个智能体。

SOLO 模式的入口不在左侧面板里，在左侧导航栏的「SOLO」图标，位置在 Chat 面板下方。点进去是独立的 SOLO 界面，顶部有两个 Tab：SOLO Builder 和 SOLO Coder。

把五个智能体放一张表里对照，选起来就清楚了：

操作路径统一是：按Ctrl+L打开面板 → 点顶部模式下拉框 → 选模式 → 输入框打字回车。SOLO 则是点左侧 SOLO 图标 → 选 Tab → 输入需求。

选模式有个简单口诀：问问题用 Chat，写代码用 Builder，连外部服务用 Builder with MCP，新项目用 SOLO Builder，改老代码用 SOLO Coder。80% 的日常开发用 Builder 就够了，别一上来就纠结。

这里有个容易忽略的点：模式决定的是 AI 的自主权边界，不是模型能力。Chat 模式下 AI 再强也不会碰你的文件，Builder 模式下 AI 会先给执行计划等你确认，SOLO 模式下 AI 会连续执行多步操作。所以选模式本质是选「你愿意让 AI 自动做多少事」。

验证模式是否切换成功：切到 Builder 后，输入「帮我在当前项目新建一个 hello.js 文件」，如果 AI 回复里出现执行计划并等你确认，说明 Builder 生效；如果只是给你一段代码让你自己复制，说明还在 Chat 模式。这个对比动作做完，你对模式的理解就落地了。

模式认知清楚后，接下来配 MCP。因为 Builder with MCP 和 SOLO 模式要调用外部工具，MCP 没配好，这两个模式的能力是残缺的。

3. Trae 安装 MCP 的三种方式与可复制配置片段

MCP 全称 Model Context Protocol，你可以把它理解成 Trae 的「外挂接口」。装了 MCP，AI 能操作 GitHub 仓库、读 Figma 设计稿、查数据库、抓网页内容。没装 MCP，AI 只能在你当前打开的文件里打转。

进入 MCP 配置页的路径：点右上角齿轮图标（设置）→ 左侧菜单找「MCP」或「模型上下文协议」→ 进去后看到两个 Tab：「市场」和「手动配置」。

方式一，市场一键添加，最适合新手。在市场 Tab 里浏览或搜索你要的 MCP，比如输入 Figma，找到后点右侧「+ 添加」，部分 MCP 会弹窗要 API Token，粘贴进去点保存，看到「连接成功」提示就成了。热门 MCP 需要提前准备的凭证：GitHub 需要 Personal Access Token（在 GitHub Settings → Developer settings → Personal access tokens 生成），Figma 需要 Personal Access Token（Settings → Account → Personal access tokens），高德地图需要 Web 服务 API Key。

方式二，手动粘贴 JSON 配置，适合市场里没有的 MCP。在 MCP 配置页点「手动配置」或「添加更多工具」，会看到 JSON 输入框。stdio 类型（本地命令行启动，最常见）的配置格式：

{ "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "D:\\DevProjects"], "env": {} } } }

http 类型（远程 HTTP 服务）的配置格式：

{ "mcpServers": { "my-remote-server": { "url": "https://example.com/mcp", "headers": { "Authorization": "Bearer 你的Token" } } } }

粘贴后点「确定」保存，状态栏显示xxx: running即成功。

配置文件放哪很关键，两个位置：全局配置在~/.trae-cn/mcp.json，所有项目共享；项目级配置在项目根目录.trae/mcp.json，仅当前项目生效且优先级更高。直接编辑这两个文件和在界面里粘贴效果一样，团队协作时把项目级配置跟着 Git 走，队友 pull 下来自动生效。

方式三，Schema 链接一键导入，适合从博客或社区看到的配置。复制别人给的trae-cn://开头的链接，在 Trae 里点击或粘贴到地址栏回车，Trae 自动解析配置并弹确认框，点「确认导入」即可。链接格式类似trae-cn://trae.ai-ide/mcp-import?type=stdio&name=github&config=...。

如果你用的是 Cline MCP 或 Codex 那套配置习惯，迁移到 Trae 时记住三件套要写全：Base URL、Key、Model ID。Trae 的 MCP 配置里，远程服务对应 url 字段（Base URL），headers 里的 Authorization 对应 Key，具体模型 ID 在模型设置里单独配，别混在 MCP 配置里。

验证 MCP 是否生效：在对话里切到 Builder with MCP，输入「帮我用 GitHub MCP 创建一个新分支 feat/login」。如果 AI 正常调用 GitHub 功能，说明 MCP 生效；如果报「工具调用失败」，往下看排错章节。

装 MCP 别贪多。Context7（实时拉最新文档）、GitHub（代码仓库操作）、Memory（跨会话记忆）、File System（读写项目文件）这四个底座够用了，装太多会互相打架，AI 调用工具时容易错乱。

4. Trae 安装 Skill 的四种方式与生效验证

Skill 是 Trae 的「外挂大脑」，把常用提示词、工作流、代码规范封装成技能包，AI 从通用助手变成领域专家。装 Skill 之前先搞清装在哪，三个层级优先级从高到低：项目级.trae/skills/仅当前项目生效；用户级~/.trae/skills/或~/.trae-cn/skills/所有项目共享；全局.agents/skills/跨 IDE 所有 Agent 共享。建议统一装用户级，除非某个项目有特殊规范才用项目级覆盖。

方式一，设置界面创建或上传，最直观。点齿轮 → 「规则与技能」→ 切到「技能」Tab → 选「项目」或「全局」（建议全局）→ 点「创建」。从零创建时输入技能名称，在编辑区写 Markdown 内容：

# 中文注释规范 ## 触发场景：写 Python 代码时自动生效 ## 执行指令： 1. 所有 Python 代码的注释必须使用中文 2. 每个函数上方要有中文说明 3. 复杂代码行旁边要有中文解释

点保存自动生效。上传已有 Skill 包则点「上传」，选.skill或.zip文件，Trae 解析元数据后点「安装」。

方式二，命令行 npx 安装，最快捷。按Ctrl+``打开内置终端，执行：

# 头脑风暴 npx skills add obra/superpowers --skill brainstorming -g -y # 系统化调试 npx skills add obra/superpowers --skill systematic-debugging -g -y # Skill 创建器 npx skills add anthropics/skills --skill skill-creator -g -y # 搜索发现新 Skill npx skills add https://github.com/vercel-labs/add-skill --skill find-skills -g -y

命令最后加-y跳过交互确认，否则会卡在选择界面超时。-g表示装到全局。

方式三，手动部署，最灵活。确认 Skill 文件夹里有SKILL.md文件（核心，没有它 Trae 识别不了），把整个文件夹复制到~/.trae/skills/（Windows 是C:\Users\你的用户名\.trae\skills\）或项目根目录.trae/skills/，重启 Trae 后在对话里测试调用。目录结构长这样：

~/.trae/skills/ ├── my-code-review/ │ ├── SKILL.md # 必须，核心定义文件 │ ├── skill.yaml # 可选，元数据配置 │ └── references/ # 可选，参考文档 └── my-logging-skill/ └── SKILL.md

方式四，自然语言创建，最省事。在对话输入框键入/skill，接着描述功能，比如/skill 一个能够将中文翻译成英文的翻译器，Trae 自动生成 SKILL.md 并保存到当前项目技能目录。复杂 Skill 也可以直接对话让 Trae 创建，把名称、规范、命名要求写清楚，它会在.trae/skills/下建好文件。

调用 Skill 有三种方式：手动调用，在对话里明确写「使用 code-reviewer 技能审查当前函数」；AI 自动调用，正常描述需求，AI 根据 Skill 里定义的触发场景自动匹配；命令面板，按Ctrl+Shift+P输入「技能」选择。

验证 Skill 是否生效：装完后在对话里输入「列出我当前可用的 MCP 工具和已安装的 Skill」，AI 会返回当前配置状态。确认 Skill 显示启用，再输入一个触发场景，比如装了 systematic-debugging 后输入「帮我系统化排查这个报错」，如果 AI 回复里出现「调用 skills」提示，说明生效。

管理 Skill：设置 → 规则与技能 → 技能，找到目标 Skill，点「停用」是保留文件但不再生效，点「卸载」是彻底删除。命令行装的也可以执行trae skill remove my-skill-name。

Skill 别装太多，3 到 5 个核心的就够。装多了 AI 输出会互相矛盾，你不知道谁在管。而且 Skill 执行顺序有讲究，靠后的会覆盖前面的，设计类 Skill 放最后。

5. Trae 配置常见报错排查对照

配 MCP 和 Skill 时遇到的报错，大部分集中在几个固定位置。下面按真实报错对照排查。

401 报错：MCP 之前能用，突然报 401。这是 Token 过期了，重新生成 Token 更新 MCP 配置即可。GitHub 的 Token 有有效期，Figma 的也是，别以为配一次就永久有效。

local proxy failed：本地 MCP Server 启动失败。先检查 Node.js 是否装了，终端跑node -v；再检查 MCP 配置里的 command 字段，Windows 下 npx 有时要写成npx.cmd；最后手动在终端跑一次配置里的命令，比如npx -y @modelcontextprotocol/server-filesystem D:\DevProjects，看具体报什么错。

reading choices 报错：通常是 MCP 返回的数据格式和 Trae 预期不一致，或者 MCP Server 版本太旧。更新 MCP Server 到最新版，或者换用市场里官方维护的版本。

OAuth 相关报错：远程 MCP 服务需要 OAuth 授权时出现。检查 headers 里的 Authorization 格式，Bearer 后面有没有多余空格，Token 是不是复制完整了。

command not found：MCP 装了但报这个。Node.js 没装或没加到 PATH，重装 Node.js 并勾选「Add to PATH」。

工具调用失败或 404：MCP Server 没在运行。终端手动跑一次 npx 命令看是否卡住，卡住说明网络或包下载有问题。

Agent 不调用 MCP：提示词里没写触发词。明确写「使用 MCP」「调用 GitHub 工具」，AI 才知道要调。

Skill 装了不生效：检查 SKILL.md 是否存在，路径是否在.trae/skills/下，Trae 是否重启过。项目级 Skill 只在当前项目生效，换项目就没了。

两个 Skill 互相干扰：比如 fix 和 code-reviewer 同时用，给矛盾建议。先用 fix 修 Bug，跑通后再用 code-reviewer 审质量，别同时开。

SOLO 模式乱跑改了 20 个文件：SOLO 任务要分阶段，每阶段确认git diff --stat看改了哪些文件，别一次性放权。

长对话 AI 失忆：10 轮后 AI 忘掉之前的约束。每 10 轮开新对话，把项目核心约束重新贴一遍。

路径有中文导致 MCP 不生效：安装路径和项目路径都别用中文，改成纯英文路径。

Skill 顺序不对被覆盖：frontend-design 被后面的规则冲掉。把设计类 Skill 放最后，执行顺序靠后的覆盖前面的。

Windows 下 npx 报错：手动配置 MCP 的 command 字段不对，把 command 从npx改成npx.cmd。

这些报错覆盖了 90% 的配置问题。遇到没列出来的，先看 Trae 的输出面板有没有详细日志，再对照 MCP 配置里的命令手动跑一遍，大部分问题能定位到具体哪一行。

6. 从裸机到满配的完整配置流程与后续接入

把前面所有步骤串成一条线，按这个顺序做，20 分钟能从裸机到满配。

第 1 步，确认环境，5 分钟。Node.js ≥ 16.0、Python ≥ 3.8、npx 可用、Trae 版本 ≥ 3.3.21，四个都确认一遍。

第 2 步，装 MCP，5 分钟。打开设置 → MCP → 市场，一键添加 Context7、GitHub、Memory、File System 四个底座。没有特殊需求这四个就够，别贪多。

第 3 步，装 Skill，5 分钟。打开终端逐条执行：

npx skills add obra/superpowers --skill brainstorming -g -y npx skills add obra/superpowers --skill systematic-debugging -g -y npx skills add anthropics/skills --skill skill-creator -g -y npx skills add https://github.com/vercel-labs/add-skill --skill find-skills -g -y

装完四个核心 Skill，后面需要什么用 find-skills 搜索。

第 4 步，写项目规则，5 分钟。在项目根目录创建.trae/rules/global.md，写上项目铁律：

# 项目铁律 - 语言：TypeScript，strict mode ON - 命名：变量用 camelCase，常量用 UPPER_SNAKE - 所有 delete/update 操作必须有 where 条件 - 错误统一走 error util，别裸 throw - 注释用中文

规则跟着 Git 走，队友 pull 下来自动生效。

第 5 步，验证配置。在对话里输入「列出我当前可用的 MCP 工具和已安装的 Skill」，确认 MCP 显示 running、Skill 显示启用。

配置完成后，如果你需要更稳定的模型接入来跑 Coding Plan 或 Agent 类任务，可以到 TaoToken 的 Coding Plan 页面看看长期编码方案，模型对话入口适合验证单个模型效果，API Keys 页面用来生成和管理接入凭证，接入文档里有完整的 Base URL 和参数说明。Claude Code 相关的接入配置在文档里也有对应章节，按三件套（Base URL + Key + Model ID）填全就能跑通。

配好之后别急着装更多 MCP 和 Skill。先用这套配置跑一个真实的小项目，感受一下 Builder 模式和 SOLO 模式的差别，用顺了再按需加。少即是多，配置到位，实战才爽。