配置 Codex

开始配置前，请先完成 快速开通，并在 Gateway 连接模式 中选择连接地址。

Codex CLI

使用以下命令读取当前 zsh 用户输入的 API Key。请从 API Key 页面复制完整 Key 后在提示中粘贴；输入不会显示在屏幕上，也不会写入该命令的 Shell 历史。

read -s "MCP_GATEWAY_API_KEY?请输入 API Key: "
echo
export MCP_GATEWAY_API_KEY

完成 codex mcp add 后，必须在同一个终端会话中启动 Codex，连接才能读取该环境变量。每次打开新的终端会话后，都需要在启动 Codex 前重新安全读取并导出 API Key。

主路由

主路由会提供该 API Key 已获授权的 MCP Server 和工具。

codex mcp add mcp-gateway --url http://mcpgw.dingtone.xyz/mcp --bearer-token-env-var MCP_GATEWAY_API_KEY

子路由

子路由固定连接一个 MCP Server。将 {namespace} 与 {mcp-server-name} 替换为运维提供的真实值。

codex mcp add mcp-server-name --url http://mcpgw.dingtone.xyz/mcp/{namespace}/{mcp-server-name} --bearer-token-env-var MCP_GATEWAY_API_KEY

API Key 始终受授权范围和 API Key IP 白名单限制，子路由也不例外。只有已授权的 MCP Server 和工具可被发现或调用；若当前出口 IP 不在白名单中，请联系运维核查配置。

Codex 桌面版

新增自定义 MCP 连接，选择“流式 HTTP”，并填写已选定的 Gateway URL。增加以下请求标头：

标头	值
Authorization	Bearer mck_live_xxxxxxxxxxxxxxxxxxxxx

安全提示

文档中的 API Key 仅以掩码或占位符展示。不要将真实 API Key 提交到代码仓库、镜像层、Shell 历史或共享文档中。