Codex integration

Prerequisites

• Codex CLI or the Codex IDE extension is installed
• You created and copied an MCP token from the dashboard

Configure from the CLI

export IDCD_MCP_TOKEN='idcd_mcp_replace_with_your_token'
codex mcp add idcd \
  --url https://mcp.idcd.com/mcp \
  --bearer-token-env-var IDCD_MCP_TOKEN

IDCD_MCP_TOKEN is a local environment variable that you define for this Codex configuration. Codex sends its value as Authorization: Bearer ....

Configure config.toml

You can also edit ~/.codex/config.toml:

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

Codex CLI, the IDE extension, and the ChatGPT desktop app on the same host share this configuration.

Verify

codex mcp list

Enter /mcp in Codex and confirm that idcd is connected with 13 tools. If you receive 401, make sure the current Codex process can read IDCD_MCP_TOKEN and that the token has no extra spaces or newline.

The fields above follow the official OpenAI MCP documentation.