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 工具就能真正成为本地环境的得力助手。