MCP instructions 把硬约束放进前 512 个字符

Codex 读初始化返回的 instructions 当整台服务器的跨工具说明。决定怎么用这台服务器时,只保证前 512 个字符在场。限流、禁止事项不要埋在后半段。

给 Codex 用的 MCP 服务器,初始化握手可以返回 instructions。Codex 把它当成这台服务器的全局说明,和工具列表一起看:跨工具工作流、约束、限流写这里,不要只写在某一个 tool description 里。

决定「这台服务器怎么用」时,官方要求前 512 个字符自成一段。超长说明的后半段在选型阶段可能还没进上下文,于是限流、只读边界、禁止写操作会看起来像没声明。

把这些放在开头:这台服务器能做什么、绝对不能做什么、速率限制、要先登录还是永远只读。细节、示例、字段对照可以放在 512 之后。

这不是 SKILL.md,也不是 AGENTS.md。技能和仓库规则管的是 Codex 自己的工作流;instructions 管的是这台 MCP 对所有工具生效的边界。改完重启 MCP 或新开会话再 /mcp 核对。

来源