Codex

Codex supports Streamable HTTP MCP servers in ~/.codex/config.toml. The same configuration is shared by the Codex CLI and IDE extension.

Use the full MCP URL from Setup:

https://mcp.vrplatform.app/

Add ?team_id=<team-id> only if you want a default team for the session. Use vrplatform as the local MCP server name.

Setup

Add the server to ~/.codex/config.toml:

[mcp_servers.vrplatform]
url = "https://mcp.vrplatform.app/"
default_tools_approval_mode = "prompt"
tool_timeout_sec = 60

Start Codex and run /mcp to confirm that the vrplatform server connected. If the server shows as needing authentication, run codex mcp login vrplatform to complete the OAuth sign-in.

Recent Codex CLI builds can also add the server from the command line: codex mcp add vrplatform --url "https://mcp.vrplatform.app/".

Read-Only Setup

For read-only Codex workflows, disable the mutation tool:

[mcp_servers.vrplatform]
url = "https://mcp.vrplatform.app/"
default_tools_approval_mode = "prompt"
disabled_tools = ["vrt_api_mutation"]
tool_timeout_sec = 60

This keeps documentation search, team lookup, OpenAPI resources, and API reads available while preventing write-capable MCP calls.

API Token Fallback

If your Codex environment cannot complete OAuth, use an API-token URL from Setup:

[mcp_servers.vrplatform]
url = "https://mcp.vrplatform.app/?api_key=<api-token>"
default_tools_approval_mode = "prompt"
tool_timeout_sec = 60

Reference

• Codex MCP configuration