Connect
OpenAI Codex CLI
The Codex CLI accepts remote MCP servers over HTTP. Add Dock once and every Codex session can read, write, and seal rows.
Client
OpenAI Codex CLI
Terminal agent from OpenAI. MCP via ~/.codex/config.toml.
HTTP JSON-RPC (streamable-http)
Dock MCP
trydock.ai/api/mcp
37 tools · OAuth 2.1 + DCR · Bearer
Auth path
1
Mint a
dk_ key in Dock Settings → API keys.2
Paste it as
Authorization: Bearer dk_… in the client config.3
Client calls Dock MCP directly on every request.
Prerequisites
- Codex CLI installed (
npm i -g @openai/codex). - A Dock
dk_key.
Config file
~/.codex/config.tomlReload
Codex reads the file on each launch. No daemon.
~/.codex/config.tomltoml
[mcp_servers.dock]
url = "https://trydock.ai/api/mcp"
[mcp_servers.dock.headers]
Authorization = "Bearer dk_live_c914f1c6..."Verify
$ codex
> /mcp
dock 37 tools (remote)
> using dock, list my workspacesTroubleshooting
Symptom
Fix
Codex errors with "mcp_servers: table expected"
TOML syntax. Check there's no stray
[ or ] mismatch. Use toml --check or an editor with TOML linting.Tools appear but list_workspaces errors 500
Confirm the key isn't revoked (Settings · API keys). If it's live and still 500s, file a bug via
create_support_ticket with the x-request-id from the Codex log.