Codex CLI

Connect

Codex CLI configures MCP servers in ~/.codex/config.toml. The most reliable way to attach a remote HTTP server with an auth header is the standard mcp-remote bridge:

[mcp_servers.nimply]
command = "npx"
args = [
  "-y", "mcp-remote",
  "https://mcp.nimply.io/mcp",
  "--header", "Authorization: Bearer nim_live_YOUR_KEY"
]

Create the key in Nimply → Settings → Developers. Restart Codex; the Nimply tools appear in the session's tool list.

If your Codex version supports native remote MCP servers (url field), you can skip the bridge:

[mcp_servers.nimply]
url = "https://mcp.nimply.io/mcp"
http_headers = { "Authorization" = "Bearer nim_live_YOUR_KEY" }

Try it

• "Use nimply to draft a post about this repo's new release and save it as a draft."

Troubleshooting

• Bridge fails to start — npx mcp-remote needs Node 18+; run the command manually to see the error.
• Tools not listed — check codex mcp list (or the equivalent in your version) for the server status.