mcp.md +14 −2
75- `enabled_tools` (optional): Tool allow list.75- `enabled_tools` (optional): Tool allow list.
76- `disabled_tools` (optional): Tool deny list (applied after `enabled_tools`).76- `disabled_tools` (optional): Tool deny list (applied after `enabled_tools`).
77 77
7878If your OAuth provider requires a static callback URI, set the top-level `mcp_oauth_callback_port` in `config.toml`. If unset, Codex binds to an ephemeral port.If 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.
79
80If your MCP OAuth flow must use a specific callback URL (for example, a remote devbox ingress URL or a custom callback path), set `mcp_oauth_callback_url`. Codex uses this value as the OAuth `redirect_uri` while still using `mcp_oauth_callback_port` for the callback listener port. Local callback URLs (for example `localhost`) bind on loopback; non-local callback URLs bind on `0.0.0.0` so the callback can reach the host.
81
82If the MCP server advertises `scopes_supported`, Codex prefers those
83server-advertised scopes during OAuth login. Otherwise, Codex falls back to the
84scopes configured in `config.toml`.
79 85
80#### config.toml examples86#### config.toml examples
81 87
88MY_ENV_VAR = "MY_ENV_VALUE"94MY_ENV_VAR = "MY_ENV_VALUE"
89```95```
90 96
97```toml
98# Optional MCP OAuth callback overrides (used by `codex mcp login`)
99mcp_oauth_callback_port = 5555
100mcp_oauth_callback_url = "https://devbox.example.internal/callback"
101```
102
91```toml103```toml
92[mcp_servers.figma]104[mcp_servers.figma]
93url = "https://mcp.figma.com/mcp"105url = "https://mcp.figma.com/mcp"
109 121
110The list of MCP servers keeps growing. Here are a few common ones:122The list of MCP servers keeps growing. Here are a few common ones:
111 123
112124- [OpenAI Docs MCP](/resources/docs-mcp): Search and read OpenAI developer docs.- [OpenAI Docs MCP](/learn/docs-mcp): Search and read OpenAI developer docs.
113- [Context7](https://github.com/upstash/context7): Connect to up-to-date developer documentation.125- [Context7](https://github.com/upstash/context7): Connect to up-to-date developer documentation.
114- Figma [Local](https://developers.figma.com/docs/figma-mcp-server/local-server-installation/) and [Remote](https://developers.figma.com/docs/figma-mcp-server/remote-server-installation/): Access your Figma designs.126- Figma [Local](https://developers.figma.com/docs/figma-mcp-server/local-server-installation/) and [Remote](https://developers.figma.com/docs/figma-mcp-server/remote-server-installation/): Access your Figma designs.
115- [Playwright](https://www.npmjs.com/package/@playwright/mcp): Control and inspect a browser using Playwright.127- [Playwright](https://www.npmjs.com/package/@playwright/mcp): Control and inspect a browser using Playwright.