#配置与多实例

自动安装分开维护客户端注册与业务定义。客户端注册告诉 Codex 如何启动 MCP；业务配置决定有哪些 instance、使用什么语言和 Schema。

#默认路径

Windows 的 ~ 通常对应当前用户目录。发生名称冲突时，注册或 Skill 可能使用带后缀的名称，以安装状态和 doctor 输出为准。迁移已有配置时，实际业务配置路径可能不同于默认路径。

#定义中文订单实例

默认用户配置推荐直接写 JSON Schema，不需要额外依赖。希望使用 schema-dsl 时，把配置放在安装了该依赖的业务项目中，例如 D:\Worker\intent-business：

New-Item -ItemType Directory -Force D:\Worker\intent-business | Out-Null
cd D:\Worker\intent-business
npm init -y
npm install schema-dsl@3.0.4

在该目录创建 intent.config.mjs：

import { s } from "schema-dsl/pure";

export default {
  instances: {
    default: { language: "zh-CN" },
    orders: {
      language: "zh-CN",
      schema: s({
        orderId: s("string!").description("当前有效请求中的订单编号。原样保留前导零，不猜测。"),
      }),
    },
  },
};

用 doctor 输出及状态文件找到实际注册，再在该注册的 args 中把 --config 后的路径改为 D:\Worker\intent-business\intent.config.mjs。导入 schema-dsl 按此配置所在项目解析，不依赖 MCP 包的全局安装目录。

MCP 启动时读取这份配置。修改后运行 doctor 检查，再重载客户端；识别订单时提交 instance: "orders"。fields: ["orderId"] 提取该字段；fields: [] 只识别默认意图。

没有本地依赖时，在实际用户业务配置中将同样的字段写为以下 JSON Schema，无需更改注册路径：

export default {
  instances: {
    orders: {
      language: "zh-CN",
      schema: {
        type: "object",
        properties: {
          orderId: { type: "string", description: "当前有效请求中的订单编号，原样保留前导零，不猜测。" },
        },
        required: ["orderId"],
        additionalProperties: false,
      },
    },
  },
};

#工作目录与环境

MCP 的 cwd 是启动进程的工作目录。代码中的相对文件读取依赖它；业务配置的 import 相对路径仍按配置文件位置解析。迁移已有注册时保留原 cwd，新配置默认使用配置文件所在目录。

配置运行于 Node.js，有读文件和执行代码的能力，只加载你信任的文件。MCP 标准输出用于协议消息，配置或业务依赖的日志应写入标准错误。

项目级 .codex/config.toml 和 Codex profile 可能影响最终采用的注册，doctor 会提示检测到的覆盖关系。用户级诊断健康之后，仍要在目标客户端核对其实际配置。

#向业务配置传递环境变量

MCP 使用当前 Codex 模型，不需要模型 API key。只有业务配置确实读取某个环境变量时才添加它，例如：

[mcp_servers.intent-runtime]
env_vars = ["INTENT_BUSINESS_REGION"]
env = { INTENT_BUSINESS_MODE = "production" }

这是对实际注册的补充片段：将字段合并到现有的注册表，不要用片段覆盖已有 command、args 或 cwd。实际注册名带后缀时使用对应名称。

env_vars 从启动 Codex 的环境中传递指定变量；env 指定明确的值。Desktop 表单中分别对应“环境变量传递”和“环境变量”。业务配置通过 process.env 读取，修改后重启客户端使环境生效。

手动修改模块管理的注册后，doctor 可以检查实际入口，并提示用户修改；clean 会保留该注册。doctor --repair 会保留用户修改并可能新建带后缀的管理注册，因此不要把它当作应用自定义配置的必需步骤。修改后先 doctor、重载并核对实际启用的入口，避免重复注册。

#输出语言

language 默认 en，必须指定随包 IANA 快照支持的输出语言。标签会规范化大小写与已登记的首选别名；它控制结构化说明语言，用户要求的报告语言仍作为要求记录，精确编号、代码和业务枚举值按原始材料保留。

不是所有语法合法或注册表中的特殊标签都适合作为输出语言。支持范围以随包快照及本地验证为准，不在运行时联网获取注册表。