跳转至

MCP 服务器行为规约 (MCP Server Rules)

MCP 服务器行为规约 (Rules) 允许你在 AI 智能体调用特定 MCP 服务器的工具时，向其注入专属的定制化控制指令。每当智能体使用该服务器所声明的工具时，系统会自动将这些规约打包为规则集 (Ruleset) 动态挂载到上下文中，从而确保智能体具备高度可控、一致且符合预期的行为逻辑。

什么是行为规约？

行为规约是一段纯文本指导规范，用于明确约束智能体应如何使用特定 MCP 服务器的工具集。它们直接持久化存储在 MCP 服务器的配置中，并在以下时机被引擎自动激活：

  • 在画布上使用挂载了该服务器的 MCPTask 节点时；
  • 在配置了该 MCP 服务的通用 Agent 节点执行期间。

为什么需要配置规约？

合理配置规约能够达成以下生产优势：

  • 定向规约智能体行为：明确指出调用特定工具的最佳实践与前置条件；
  • 保障执行一致性：强制智能体遵循团队统一的数据输出格式与交互范式；
  • 安全拦截异常与边缘情况：指导智能体在发生连接中断、超时或数据缺失时如何优雅容错；
  • 规避性能损耗与滥用：指导智能体高效使用外部 API，防止盲目高频轮询或暴力请求。

如何为 MCP 服务器添加规约

1. 新建服务器时添加

在注册全新 MCP 服务时，直接在 Rules 文本输入框中写入规范：

  1. 打开菜单栏 Settings → MCP Servers；
  2. 点击 + New MCP Server；
  3. 填写服务器的基础属性（名称、连接类型、运行命令等）；
  4. 在 Rules 文本区域中输入你的专属规则文本；
  5. 点击 Create Server 完成注册。

2. 为已有服务器追加或编辑

  1. 打开菜单栏 Settings → MCP Servers；
  2. 在目标服务器卡片上点击 Edit 编辑按钮；
  3. 直接调整 Rules 文本框中的内容；
  4. 点击保存确认。

典型规约工业级实战范例

网页抓取类服务器 (Web Fetching Server)

Always validate URLs before fetching. Check that URLs use HTTPS when possible. If a fetch fails, return a clear error message explaining what went wrong.
（抓取前必须校验 URL 合法性；优先选用 HTTPS 协议；若抓取失败，必须返回结构清晰的错误原因说明。）

本地文件系统类服务器 (File System Server)

Always check if a file exists before attempting to read it. Use absolute paths when possible. Never delete files without explicit user confirmation.
（尝试读取文件前必须预先确认其是否存在；路径尽可能采用绝对路径；严禁在未经用户显式确认前执行任何删除文件的破坏性指令。）

全网检索类服务器 (Search Server)

Always verify search results are relevant before returning them. If no relevant results are found, suggest alternative search terms. Format results in a clear, readable structure.
（返回检索结果前必须自行验证其与用户意图的相关性；若检索无果，应主动给出备选检索词建议；检索结果必须以整洁易读的 Markdown 结构排版呈现。）

数据库查询类服务器 (Database Server)

Always validate SQL queries before executing them. Never execute DROP or DELETE operations without explicit confirmation. Return query results in a structured format.
（执行前必须静态校验 SQL 语句语法；严禁在未经显式确认前执行 DROP、TRUNCATE 或批量 DELETE 破坏性操作；查询结果必须统一格式化为 Markdown 表格或 JSON 结构输出。）

规约的底层运行逻辑

  1. 持久化保存 (Storage)：规约作为元数据字段直接序列化在 MCP 服务器的配置字典中；
  2. 自动化激活 (Application)：一旦智能体决定调用该服务的工具，规约文本会自动转换为底层系统规则集（System Prompt Ruleset）；
  3. 精细化作用域 (Scope)：规约仅在调用该特定服务器的工具时生效，绝不会无端污染画布上其它无关节点；
  4. 单字符串格式 (Format)：规约以整段纯文本形式组织，你可以通过换行符或句号自由分隔多条业务条款。

撰写高质量规约的最佳实践

1. 指向精准，杜绝模糊表述

  • ✅ 优秀范例：“抓取前必须验证 URL 是否带有合法的 scheme，优先采用 HTTPS，遇到错误返回明确的失败原因。”
  • ❌ 模糊表述：“使用 URL 时小心一点。”

2. 聚焦于动作与格式

  • ✅ 优秀范例：“遇到异常时，请统一返回带有 error 与 message 字段的 JSON 格式数据。”
  • ❌ 泛泛而谈：“好好处理错误。”

3. 保持简练，直奔主题

  • ✅ 优秀范例：“处理前校验入参合法性，输出结果严格按照结构化 JSON 返回。”
  • ❌ 冗长拖沓：用数千字的长篇大论罗列每一种极其罕见的理论极端边界。

4. 落地验证与迭代

添加规约后，建议在画布上进行简单冒烟测试：

  1. 拖入关联该 MCP 服务的 MCPTask 节点；
  2. 输入带有潜在边界条件的提示词；
  3. 检查大模型返回的工具调用行为是否严格遵守了预设规范。

常见疑难排查 (Troubleshooting)

规约似乎未生效

  • 检查 MCP 设置面板中的 Rules 文本框，确认未被意外清空；
  • 确认该 MCP 服务器的 Enable 开关处于开启激活状态；
  • 检查画布上 MCPTask 节点选择的服务器名称是否与该配置完全匹配。

智能体未严格遵从规约

  • 规约提示词可能过于隐晦——请改用直截了当的命令式动词（如 Always、Never、Must）；
  • 先精简为一条核心规则进行独立测试，排除多条规则之间的冲突二义性；
  • 检查所选的底层模型是否具备足够强大的指令遵循 (Instruction Following) 能力。

推荐延伸阅读