Docs / Connect your AI

Connect Codex

ReadyCLI · IDE extension · desktop app · about 1 min

The Codex CLI, its IDE extension and the ChatGPT desktop app share one file: ~/.codex/config.toml.

You need an Openpane API key. The API keys page makes one for Codex and fills it into every step. Here, the steps show YOUR_API_KEY where it goes.

Make a key for Codex

Set it up fromKey in configKey from environment

Key in config

  1. Add to ~/.codex/config.toml

    ~/.codex/config.tomlTOML
    [mcp_servers.openpane]
url = "https://openpane.oblaidish.com/api/mcp"
http_headers = { "Authorization" = "Bearer YOUR_API_KEY" }

  2. Check it

    Or type /mcp inside codex.

    Terminalcheck
    codex mcp list
What you'll see · schematic
Terminal
$ codex mcp list
openpane https://openpane.oblaidish.com/api/mcp enabled

Key from environment

  1. Add to ~/.codex/config.toml

    ~/.codex/config.tomlTOML
    [mcp_servers.openpane]
url = "https://openpane.oblaidish.com/api/mcp"
bearer_token_env_var = "OPENPANE_API_KEY"

  2. Set the variable

    Terminaladd to your profile
    export OPENPANE_API_KEY="YOUR_API_KEY"

  3. Check it

    Or type /mcp inside codex.

    Terminalcheck
    codex mcp list

Apps opened from the Dock or Start menu may not see variables set in a shell profile. If the IDE extension or desktop app can't connect, use Key in config.

What you'll see · schematic
Terminal
$ codex mcp list
openpane https://openpane.oblaidish.com/api/mcp enabled

Your first pane

Ask Codex:

Prompttry it
Make me an Openpane pane with a React counter app.

It answers with a link to a private pane, which opens in any browser where you're signed in to Openpane. To show it to others, see Sharing. Codex now has Openpane's seven tools, to create, update, list, delete and share panes: the MCP server reference lists them.

Connect Codex to Openpane · Openpane docs