mcp.md Codex Docs, 2026-05-14 21:00 UTC → 2026-05-18 22:01 UTC

86- `required` (optional): Set `true` to make startup fail if this enabled server can't initialize.86- `required` (optional): Set `true` to make startup fail if this enabled server can't initialize.

87- `enabled_tools` (optional): Tool allow list.87- `enabled_tools` (optional): Tool allow list.

88- `disabled_tools` (optional): Tool deny list (applied after `enabled_tools`).88- `disabled_tools` (optional): Tool deny list (applied after `enabled_tools`).

89- `default_tools_approval_mode` (optional): Default approval behavior for

90 tools from this server. Supported values are `auto`, `prompt`, and

91 `approve`.

92- `tools.<tool>.approval_mode` (optional): Per-tool approval behavior override.

89 93 

90If your OAuth provider requires a fixed callback port, set the top-level `mcp_oauth_callback_port` in `config.toml`. If unset, Codex binds to an ephemeral port.94If your OAuth provider requires a fixed callback port, set the top-level `mcp_oauth_callback_port` in `config.toml`. If unset, Codex binds to an ephemeral port.

91 95 

125url = "http://localhost:3000/mcp"129url = "http://localhost:3000/mcp"

126enabled_tools = ["open", "screenshot"]130enabled_tools = ["open", "screenshot"]

127disabled_tools = ["screenshot"] # applied after enabled_tools131disabled_tools = ["screenshot"] # applied after enabled_tools

132default_tools_approval_mode = "prompt"

128startup_timeout_sec = 20133startup_timeout_sec = 20

129tool_timeout_sec = 45134tool_timeout_sec = 45

130enabled = true135enabled = true

136 

137[mcp_servers.chrome_devtools.tools.open]

138approval_mode = "approve"

139```

140 

141### Plugin-provided MCP servers

142 

143Installed plugins can bundle MCP servers in their plugin manifest. Those

144servers are launched from the plugin, so user config doesn't set their

145transport command. User config can still control on/off state and tool policy

146under `plugins.<plugin>.mcp_servers.<server>`.

147 

148```toml

149[plugins."sample@test".mcp_servers.sample]

150enabled = true

151default_tools_approval_mode = "prompt"

152enabled_tools = ["read", "search"]

153 

154[plugins."sample@test".mcp_servers.sample.tools.search]

155approval_mode = "approve"

131```156```

132 157 

133## Examples of useful MCP servers158## Examples of useful MCP servers