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

# OpenAI Codex

> Configure the oleander MCP server in OpenAI Codex

## Overview

Use the remote oleander MCP server in OpenAI Codex to connect your agent workflows directly to oleander.

> Beta: MCP integration docs and workflow may change.

## Prerequisites

* OpenAI Codex CLI installed

## Add the MCP server

Add the oleander server to your Codex config at `~/.codex/config.json`:

```json theme={null}
{
  "mcpServers": {
    "oleander": {
      "type": "streamableHttp",
      "url": "https://oleander.dev/mcp"
    }
  }
}
```

If you already have other MCP servers configured, add only the `oleander` entry under `mcpServers`.

## Authenticate

On first use, Codex will prompt you to complete an OAuth flow in your browser to authorize access with your oleander account.

Alternatively, you can pass your oleander [API key](https://oleander.dev/app/settings/api-keys) as a bearer token in the server config:

```json theme={null}
{
  "mcpServers": {
    "oleander": {
      "type": "streamableHttp",
      "url": "https://oleander.dev/mcp",
      "headers": {
        "Authorization": "Bearer [OLEANDER-API-KEY]"
      }
    }
  }
}
```

## Verify

Ask Codex to confirm it's connected:

> "Are you connected to oleander? Who am I authenticated as?"

Codex will call `oleander_whoami` and return your organization context.