Trae 規則與 MCP 配置教學：.trae/rules 四種生效方式、導入 AGENTS.md、添加 MCP Server

本文根據 TRAE 官方文檔《規則（Rule）》《MCP 概覽》《添加 MCP Server》整理，資料核對於 2026-10-11。Trae 國內版與國際版怎麼選、SOLO 模式是什麼，見本站 AI 應用目錄裏的 TRAE 條目；本文只講規則和 MCP 兩項配置。

適用於誰

• 用 Trae 寫代碼，想讓 AI 固定遵守代碼風格和項目約定的人；
• 搜「trae rules 配置」「trae rules 最佳實踐」「trae mcp 配置」「trae mcp 啟動失敗」的人；
• 從 Cursor、Claude Code 遷到 Trae，想複用已有規則文件和 MCP 配置的人。

結論先說

1. Trae 的規則分兩類：全局規則（所有項目生效，存在用戶目錄的 .trae/user_rules）和項目規則（項目裏的 .trae/rules/，Markdown 文件）。
2. 項目規則有四種生效方式：始終生效、指定文件生效、智能生效、手動觸發生效，對應 alwaysApply、globs、description 三個屬性。
3. Trae 能讀項目根目錄的 AGENTS.md、CLAUDE.md、CLAUDE.local.md，但要在設定裏手動打開開關。
4. MCP Server 兩種加法：從內置的 MCP 市場添加，或手動填 JSON。支持 stdio、SSE、Streamable HTTP 三種傳輸。
5. 想把 MCP 配置跟着項目走，先打開「啟用項目級 MCP」，再在項目的 .trae/mcp.json 裏寫。
6. 官方免責聲明：MCP Server 由第三方構建和維護，TRAE 不審查也不為其行為負責。

一、規則放在哪

二、創建規則

全局規則：在 IDE 窗口進入 設定 > 規則與記憶，在「規則」部分點 + 創建，選 全局，輸入內容後儲存。適合寫個人偏好，例如官方示例裏的：

text
所有回答都使用中文表述。
如需提供代碼，為關鍵邏輯和可能造成理解困難的部分添加簡明的中文註釋。
當生成的代碼超過 20 行時，優先考慮是否可以進行適當的抽象或聚合。

項目規則：

1. 打開項目，進入 設定 > 規則與記憶；
2. 點 + 創建，選 項目；
3. 輸入規則名稱並確認——系統會自動創建 .trae/rules 文件夾和規則文件，並在編輯器裏打開；
4. 選擇生效方式，按下表填寫屬性；
5. 在 --- 下方用 Markdown 寫規則內容，儲存。

#Rule 引用的優先級最高：即使是「指定文件生效」或「智能生效」的規則，只要你在對話裏用 #Rule 點名，這次對話就會用上它。

三、規則多了怎麼組織

多層嵌套：可以在 .trae/rules/ 下建子文件夾歸類，系統會遞歸讀取，最多支持 3 層，更深的不識別。

text
.trae/rules/
├── general-rules.md            # 通用規則
├── frontend/
│   ├── react-best-practices.md
│   └── testing/
│       └── unit-test-rules.md
└── backend/
    └── api-design.md

給子目錄單獨配規則：Trae 會讀取項目裏任意子目錄下的 .trae/rules/（以及該目錄下的 AGENTS.md）。只有當你在對話中提到該目錄下的文件，或 AI 執行任務時讀到了該目錄下的文件，這些專屬規則才會帶上。大型項目裏，前端模組、後端模組各放各的規則，互不干擾。

四、複用 AGENTS.md 和 CLAUDE.md

Trae 兼容兩類位於項目根目錄的規則文件：

• AGENTS.md：跨工具的通用規範，需要你手動放到項目根目錄；
• CLAUDE.md 和 CLAUDE.local.md：Claude Code 的項目規則文件，從 Claude Code 遷移項目時會隨項目帶入。

讓它們生效的步驟：進入 設定 > 規則與記憶，在「導入設定」處打開 將 AGENTS.md 包含在上下文中 和 將 CLAUDE.md 包含在上下文中 兩個開關。不打開開關，文件放在那裏也不會被讀取。跨工具共用的寫法見《AGENTS.md 怎麼寫》。

五、給提交資訊（Commit Message）定規則

在規則文件的 frontmatter 裏加 scene: git_message：

markdown
---
scene: git_message
---
提交資訊使用中文，格式為「類型: 簡述」，類型限 feat / fix / docs / refactor / test。

只要文件裏有這個字段，AI 生成提交內容時就會遵循，不受 alwaysApply、globs 等其他字段影響。也可以在原始碼管理面板的提交輸入框右側下拉里選「配置提交資訊生成規則」，系統會在 .trae/rules 下生成 git-commit-message.md。

六、官方的規則最佳實踐

• 控制單條規則的粒度，保持清晰、聚焦；
• 規則之間不要互相沖突或覆蓋；
• 指定文件路徑時用相對項目根目錄的相對路徑；
• 新建或修改規則後開一個新對話再用，避免歷史上下文和新規則衝突；
• 項目裏已有大量不合規範的代碼時，模型可能沿用舊風格。官方建議：明確告訴模型當前任務是「重構」，或在特定場景裏強制要求嚴格遵循新規則。

七、添加 MCP Server

從 MCP 市場添加

1. 在 IDE 窗口或 Agent 窗口進入 設定 > MCP；
2. 點 添加 > 從市場添加；
3. 找到需要的 MCP Server，點右側的 +；
4. 在彈窗裏填配置資訊，點確認。

兩條官方提示：標記為「Local」的 MCP Server 需要本機先裝好 NPX 或 UVX（也就是 Node.js 或 Python 的 uv 工具）；配置裏的 env（API Key、Token 等）要換成你自己的真實資訊。

手動配置

設定 > MCP > 添加 > 手動添加，把 JSON 填進輸入框。已經在別的 IDE 裏配過的，點 原始配置（JSON），把原來的配置直接粘進 Trae 的 mcp.json。

stdio 類型（本地進程）：

json
{
  "mcpServers": {
    "mcp_name": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "API_Key": "value" }
    }
  }
}

HTTP 類型（遠程服務，SSE 或 Streamable HTTP）：

json
{
  "mcpServers": {
    "mcp_name": {
      "url": "https://example.com/mcp",
      "headers": { "Authorization": "Bearer xxxx-xxxxxxx" }
    }
  }
}

command 必須在系統 PATH 裏或寫完整路徑，而且命令本身不能包含空格，否則解析出錯——參數要放進 args。

項目級 MCP

1. 設定 > MCP，打開 啟用項目級 MCP 開關並確認；
2. 在項目根目錄的 .trae/ 下創建 mcp.json，寫入配置並儲存。

官方在這裏有一條警告：務必確保工作區內所有項目文件來源可信，避免加載惡意配置文件。配置裏可以用變量 ${workspaceFolder}（目前只支持這一個），啟動時會替換成項目根目錄的真實路徑。

常見問題

Q：MCP Server 啟動失敗 / 超時？

先確認本機裝了 Node.js（npx）或 uv（uvx）、command 沒有帶空格、env 裏的密鑰填對了。啟動慢的可以加超時設定：stdio 類型寫在 env 裏，HTTP 類型寫在 headers 裏——

json
"env": {
  "START_MCP_TIMEOUT_MS": "60000",
  "RUN_MCP_TIMEOUT_MS": "60000"
}

前者是啟動超時，後者是調用工具的超時，單位毫秒。

Q：Agent 窗口裏為什麼要選「本地 / 雲端」？

官方說明：本地的規則和 MCP Server 只能用於本地任務和工作樹任務；雲端的只能用於雲端任務。兩邊要分別配置。

Q：規則寫了但 AI 不遵守？

檢查生效方式：「指定文件生效」要對話裏真的提到了匹配的文件；「智能生效」要有清楚的描述；改完規則後開新對話。

Q：MCP 市場裏的伺服器都安全嗎？

官方明確不為第三方 MCP Server 背書。怎麼挑、怎麼審，見《MCP 伺服器怎麼選》。

參考資料

• 規則（Rule）（TRAE 官方文檔）：https://docs.trae.ai/ide/rules
• MCP 概覽（TRAE 官方文檔）：https://docs.trae.ai/ide/model-context-protocol
• 添加 MCP Server（TRAE 官方文檔）：https://docs.trae.ai/ide/add-mcp-servers