IndexZeroDocs

Codex

Register IndexZero with the Codex CLI.

Codex supports remote MCP servers over Streamable HTTP and manages them with codex mcp.

Add the server

codex mcp add indexzero --url https://app.indexzero.site/mcp

This writes the server into Codex's config.toml. The equivalent by hand:

~/.codex/config.toml
[mcp_servers.indexzero]
url = "https://app.indexzero.site/mcp"

Authenticate

codex mcp login indexzero

A browser window opens on app.indexzero.site; approve the connection. If your Codex build does not offer a login command, it will prompt on first use.

Confirm

codex mcp list

IndexZero should show as connected. In a session, ask Codex to list your IndexZero projects.

Using an API key instead

For a non-interactive setup, create an API key and pass it as a header:

~/.codex/config.toml
[mcp_servers.indexzero]
url = "https://app.indexzero.site/mcp"
http_headers = { "x-api-key" = "iz_your_key_here" }

Codex versions differ in the exact header option name; codex mcp add --help shows the one your build accepts.

On this page