> ## Documentation Index
> Fetch the complete documentation index at: https://doc.extole.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> Connect OpenAI Codex CLI to Extole and invoke Extole tools in automated workflows.

Connect your Extole programs to OpenAI Codex CLI and invoke Extole tools as part of automated coding and scripting workflows.

***

## Requirements

* [OpenAI Codex CLI](https://github.com/openai/codex) installed
* An active Extole user account
* An OpenAI API key

***

## Setup

Choose your authentication method. See the [MCP authentication guide](/technical-docs/extole-ai/extole-mcp/mcp-authentication) if you're not sure which to use.

***

### Option 1: OAuth (Recommended)

**Step 1: Add the Extole MCP server**

`~/.codex/config.toml`

**Step 2: Authenticate**

`~/.codex/config.json`

Your browser will open to an Extole authorization page. Review the permissions and click **Authorize**.

**Step 3: Verify**

`<YOUR_API_KEY>`

The Extole server should show as connected.

***

### Option 2: API Key

**Step 1: Get your API key**

Generate one at the [My.Extole Security Center](https://my.extole.com/security-center#access-token).

**Step 2: Edit your Codex config**

Add the following to `~/.codex/config.toml`:

`codex --list-tools`

Or in JSON format (`~/.codex/config.json`):

`codex --list-tools`

Replace `<YOUR_API_KEY>` with your Extole API key.

**Step 3: Verify**

`Bearer `

***

## Using the MCP

Once connected, Extole tools are available in any Codex session:

> *"Pull the conversion report for my refer-a-friend program for the past 30 days."*

> *"What reward suppliers are configured on my account?"*

> *"Update the friend reward in campaign X to \$15."*

Run `codex --list-tools` to see which Extole tools are available.

> **Write operations** -- Actions that modify programs, rewards, or campaign components execute immediately under your Extole permissions and are recorded in the Extole change log.

***

## Troubleshooting

**"Tool not found"** -- Confirm the URL is correct. Run `codex --list-tools` to see what's being discovered.

**"Unauthorized"** -- Check your token. Verify the `Bearer ` prefix is present.

> **Note:** Codex CLI MCP support is evolving. Refer to the [Codex CLI documentation](https://github.com/openai/codex) for the latest configuration format if these steps differ from your version.