MCP in Codex.
Install the CLI, register Empirical’s hosted MCP server in Codex, authenticate, and verify a tool call.
Install the CLI and MCP entry
The `empirical install` command configures the detected Codex target. Run the npm install first; the Empirical command is not available before the CLI is installed.
npm install -g @empirical-gauzza/cli
empirical installAuthenticate Codex
Codex uses the hosted MCP OAuth flow. If the installer leaves authentication pending, use Codex’s MCP login command for the Empirical server.
codex mcp login empiricalDo not use a pasted long-lived token: Complete OAuth in the client or use the documented headless flow for automation.
Verify the connection
Ask Codex to query a known non-sensitive preference, then confirm that the Empirical tools appear in its MCP tool list. If they do not, run empirical doctor and re-run the installer.
empirical doctor
codex mcp get empiricalLast updated: July 31, 2026