Codex 接入

前置条件

  • 已安装 Codex CLI 或 Codex IDE 扩展
  • 已在控制台创建并复制 MCP 令牌

命令行配置

export IDCD_MCP_TOKEN='idcd_mcp_替换为你的令牌'
codex mcp add idcd \
  --url https://mcp.idcd.com/mcp \
  --bearer-token-env-var IDCD_MCP_TOKEN

IDCD_MCP_TOKEN 是你为这个 Codex 配置定义的本地环境变量。Codex 会把它的值发送为 Authorization: Bearer ...

config.toml 配置

也可以编辑 ~/.codex/config.toml

[mcp_servers.idcd]
url = "https://mcp.idcd.com/mcp"
bearer_token_env_var = "IDCD_MCP_TOKEN"

Codex CLI、IDE 扩展和同一主机上的 ChatGPT 桌面端共享这份配置。

验证

codex mcp list

在 Codex 中输入 /mcp,确认 idcd 已连接且显示 13 个工具。如果收到 401,请确认当前 Codex 进程能读取 IDCD_MCP_TOKEN,且令牌没有多余空格或换行。

配置字段与 OpenAI 官方 MCP 文档一致。