AI 規則（AI Rule）

接入 ServBay MCP 後，AI 工具雖然「能」呼叫 ServBay，但未必「知道」應該在何時、以何種方式呼叫。AI 規則（AI Rule） 就是寫給 AI 的一份指引——它告訴 AI：當遇到本地服務、網站、網域、HTTPS、埠號、資料庫、備份等問題時，應優先透過 ServBay MCP 進行檢查與操作，而不是直接修改應用程式碼來繞過環境問題。本文將介紹如何安裝 AI 規則。

AI 規則能解決的問題

• 讓 AI 優先使用 MCP — 遇到「站台無法開啟 / 502 / 埠號被佔用 / 憑證錯誤」等本地環境問題時，先使用 ServBay MCP 檢查狀態，而不是盲目修改程式碼。
• 規範安全邊界 — 對於寫入或具破壞性的操作先說明再確認，不在對話中要求或貼上金鑰等敏感資訊。
• 減少反覆解釋 — 規則常駐，AI 每次對話都能遵循一致的行為準則。

安裝前提

• 已安裝並執行 ServBay。
• 建議已完成 ServBay MCP 接入。

工作區級 vs 全域級

AI 規則可安裝在兩種層級：

• 工作區級（Workspace） — 規則檔案寫入某個專案目錄，僅對該專案生效。適合專案客製化。
• 全域級（Global） — 規則寫入 AI 工具的使用者層級設定，對所有專案生效。目前僅 Claude Code 與 Codex 支援全域級規則。

安裝 AI 規則

進入 ServBay 設定（Settings）→ AI 用戶端整合（IDE Integrations），於對應用戶端行點擊 安裝 AI 規則（Install AI Rule）；進行工作區級安裝時需先選擇目標專案目錄。ServBay 會建立或更新相應的規則檔案。若要移除，則點擊 移除 AI 規則（Remove AI Rule）。

工作區級規則檔案位置

用戶端	規則檔案（相對專案根目錄）
VS Code	.github/instructions/servbay-mcp.instructions.md
Cursor	.cursor/rules/servbay-mcp.mdc
Codex	AGENTS.md
Claude Code	CLAUDE.md

全域級規則檔案位置

用戶端	規則檔案
Claude Code	~/.claude/CLAUDE.md（官方用戶記憶，啟動對話時載入）
Codex	~/.codex/AGENTS.md（官方全域記憶）

合併策略：不覆蓋你的內容

ServBay 採用標記合併策略寫入規則：將 ServBay 託管的規則內容用特定標記註解包裹，只會更新標記區域內的內容，保留你在同一檔案中的其它內容。所以將規則寫入你現有的 CLAUDE.md / AGENTS.md 是安全的——你原有的內容不會被遺失，移除時也只會刪除託管區域。

常見問題（FAQ）

• Q：安裝 AI 規則會覆蓋我現有的 CLAUDE.md / AGENTS.md 嗎？
  • A：不會。ServBay 僅會更新由標記包裹的託管區域，你的其他內容會保留不變。
• Q：為什麼我的用戶端沒有「全域規則」選項？
  • A：目前僅 Claude Code 與 Codex 支援全域級規則，其他用戶端請使用工作區級安裝。
• Q：AI 規則和 MCP 接入有什麼關係？
  • A：MCP 接入讓 AI 能夠呼叫 ServBay，而 AI 規則則讓 AI 知道何時以及如何呼叫。兩者配合效果最佳。
• Q：Cursor / VS Code 專案中的規則會被提交到 Git 嗎？
  • A：規則存在專案目錄作為檔案，是否納入版本控制由你的 .gitignore 決定，請依團隊規範處理。

總結

AI 規則是 ServBay MCP 的「使用說明書」，讓 AI 處理本地開發環境問題時能優先、正確且安全地運用 ServBay。支援工作區與全域兩種安裝方式，並採標記合併策略保護你原有的內容。安裝後，你的 AI 工具就能成為本地環境管理的得力助手。