OpenAI Codex CLI

Overview

The OpenAI Codex CLI supports MCP servers. AgentZero can provide policy-enforced tools to Codex sessions.

Setup

1. Build with MCP support

cargo build --release --features mcp

2. Add to Codex MCP config

Add AgentZero to your Codex MCP configuration:

{
  "mcpServers": {
    "agentzero": {
      "command": "az",
      "args": ["mcp"]
    }
  }
}

Or use the automated setup:

az connect codex --dry-run  # preview the config
az connect codex             # write config

3. Verify

Start Codex in your project directory. AgentZero tools will be available alongside Codex’s built-in capabilities.

Available Tools

Tool	Description
read_file	Read file contents (policy-checked)
list_directory	List directory contents
search_files	Search for patterns in files
write_file	Write content to a file (requires approval)
run_command	Execute a shell command (requires approval)

Security

• Policy engine enforces deny-by-default rules
• Path validation and sensitive file blocking
• Full audit trail in .agentzero/audit/

Troubleshooting

• Tools not visible — ensure az is in your PATH and built with --features mcp
• Policy denials — check az policy status