Support

Codex (ChatGPT) Setup

Connect Tempreon to OpenAI's Codex — the ChatGPT desktop app, IDE extension, or CLI — for terminal-native and editor-native agent workflows.

Ready to connect? Your Bridges page walks you through it step by step.

Open your Bridges page

Overview

Codex is OpenAI's coding-agent product, available in the ChatGPT desktop app, as an IDE extension (VS Code, Cursor, and similar), and as a CLI. All three share the same MCP configuration surface — once you connect Tempreon, your Codex session sees your Core Imprint, Knowledge Vault, preferences, and project context, the same intelligence layer your Claude tools use.

Codex in the ChatGPT desktop app: install the published plugin. Tempreon is a published plugin in ChatGPT's plugin directory, and OpenAI says ChatGPT and Codex share one plugin directory, with plugins working in Codex in the ChatGPT desktop app. Open the Plugins tab, find Tempreon (or open its listing), install it and sign in to Tempreon when asked. Codex CLI has its own /plugins browser. The IDE extension doesn't support plugins, so use the MCP setup below there, or anywhere the plugin is unavailable.

Codex supports remote MCP servers over OAuth. There are several equivalent ways to register Tempreon; pick the one that matches your install.

Desktop naming (as of October 2026): OpenAI folded the standalone Codex Mac app into the ChatGPT desktop app in July 2026. If you're looking for a separate "Codex" application on your Mac and can't find it, open the ChatGPT desktop app — that's where Codex lives now. The config file and every step below are unchanged.

Prerequisites

  • A current Codex install — the ChatGPT desktop app, IDE extension, or CLI (run codex --version to confirm)
  • A Tempreon account on any plan
  • A working default browser on the machine running Codex — the OAuth flow opens one

Step-by-Step Setup

1. Get Your Connection Details

Log into Tempreon and navigate to the Bridges section of your dashboard to find your MCP server URL. The URL ends in /mcp.

2. Add to Your MCP Configuration

Codex reads MCP server configurations from ~/.codex/config.toml (global) or a project-local .codex/config.toml. All three Codex surfaces — the ChatGPT desktop app, IDE extension, and CLI — read the same file. Pick whichever method matches your install; the resulting configuration is identical.

Project-local config only loads for projects you've marked as trusted, so if a .codex/config.toml seems to be ignored, check the project's trust setting before anything else.

This is the most reliable path. Open ~/.codex/config.toml in your editor (create it if it doesn't exist) and add:

[mcp_servers.tempreon]
url = "https://api.tempreon.com/functions/v1/tempreon-mcp/mcp"

Save. Fully quit Codex (Cmd-Q on Mac, not just close the window) and reopen. Tempreon will appear in your MCP servers list.

Tip: Use ~/.codex/config.toml to make Tempreon available across every Codex install on this machine. Use a project-local .codex/config.toml to scope it to a single project.

Method B — Codex IDE Extension

In the Codex extension, open the gear menu → MCP servers → Add server and fill in the Tempreon URL, then choose Restart extension. The extension writes to the same ~/.codex/config.toml as Method A. The IDE Extension is the most convenient path if you're already working inside VS Code, Cursor, or a similar editor.

Method C — One CLI command

From a terminal, register and authorize Tempreon without opening an editor:

codex mcp add tempreon --url https://api.tempreon.com/functions/v1/tempreon-mcp/mcp

This writes the same [mcp_servers.tempreon] block to ~/.codex/config.toml. Codex checks the server, prints "Detected OAuth support. Starting OAuth flow…", and opens your browser to sign in right away. If the browser didn't open, or the sign-in didn't finish, run codex mcp login tempreon. Confirm with codex mcp list.

Method D — Desktop app GUI

In the ChatGPT desktop app, open Settings → MCP servers → Add server, fill in the form, then choose Restart. The app writes the same [mcp_servers.tempreon] block to ~/.codex/config.toml for you.

If the Add server form flickers or the OAuth window closes immediately, the form may have failed to persist before triggering OAuth. Fall back to Method A (edit ~/.codex/config.toml directly) — the verified workaround from our 2026-05-06 validation. The same TOML block applies; the app picks it up on next launch.

3. Authorize the Connection

If you used codex mcp add (Method C), the OAuth flow has already started. For the other methods, Codex triggers it on first connect. If the browser didn't open, or to re-authorize later, run:

codex mcp login tempreon

On a machine without a browser, add --no-browser and open the printed URL yourself. A browser window opens with the Tempreon consent screen. Sign in if prompted, review the requested scopes, and approve. The window closes; Codex stores the access token locally and reuses it on every future session.

4. Verify the Connection

Open the MCP servers list in your Codex surface (desktop app Settings → MCP servers, the IDE extension's gear menu → MCP servers, or codex mcp list from the CLI). Tempreon should appear as Connected. Start a new session and ask:

"What Tempreon tools do you have access to?"

If Codex lists Tempreon's tools, the Bridge is working.

Developer-Specific Features

Codex with Tempreon is particularly powerful for developers because:

  • Architecture decisions persist. Tell Codex to remember a technical decision in one session and it surfaces automatically the next time you're working in the same area — across the desktop app, IDE extension, and CLI.
  • Project context carries over. Domain-scoped knowledge means Codex knows the difference between your work projects and your personal projects without you re-explaining.
  • Session bootstrap is automatic. Tempreon surfaces the right context at session start — what you've decided before, who you've talked to, which projects are active — so Codex picks up where the last session left off.
  • Task management is integrated. Capture tasks from inside the terminal or editor without context-switching to a separate tool.

Try Saying...

  • "Pull up what I've been working on in [project name]" — Loads project context into the session
  • "What did I decide about the auth service architecture last week?" — Searches your Knowledge Vault from the terminal or editor
  • "Save this design note as a spec document" — Stores a file in your File Vault tagged for cross-session retrieval
  • "What tasks do I have queued for [project]?" — Reads your personal task queue without leaving Codex

Common Issues

ProblemSolution
Desktop app's Add server form flickers, OAuth window closes, Tempreon never appearsUse Method A (edit ~/.codex/config.toml directly). Save, fully Cmd-Q the app, reopen.
Can't find a separate Codex app on your MacCodex moved into the ChatGPT desktop app in July 2026. Open that instead — your config carries over.
A project-local .codex/config.toml seems to be ignoredCodex only loads project-scoped config for projects you've marked trusted. Trust the project, or use the global ~/.codex/config.toml.
OAuth completes but Tempreon disconnects after a few minutesFully restart Codex. If it keeps happening, remove the Tempreon MCP server and add it again (not just disconnect/reconnect), then re-authorize.
Tools list doesn't update after a Tempreon-side changeIf tools look stale, restart Codex or remove and re-add the Tempreon MCP server.
codex mcp login reports "unknown command"Your Codex build predates the login command (added October 2025). Update Codex.
Browser doesn't open during codex mcp loginCodex prints the auth URL on the terminal — copy it into your browser manually. On a machine without a browser, run codex mcp login tempreon --no-browser.

For more help, see Troubleshooting Connections.

Frequently asked questions

How do I authorize Tempreon in Codex?
If you register Tempreon with codex mcp add, the CLI detects that Tempreon supports OAuth and starts the sign-in right away. If you add it by editing config.toml or from the desktop app or IDE extension, Codex triggers the OAuth flow on first connect. Either way a browser window opens with the Tempreon consent screen where you sign in, review the requested scopes, and approve; Codex then stores the access token locally and reuses it every session. If the browser didn't open, or to re-authorize later, run codex mcp login tempreon.
Where does Codex keep its MCP settings, and how do I add Tempreon?
Codex reads MCP servers from ~/.codex/config.toml for all installs on the machine, or a project-local .codex/config.toml to scope it to one trusted project. All three Codex surfaces — the ChatGPT desktop app, IDE extension, and CLI — read the same file. The most reliable path is to open ~/.codex/config.toml, add an [mcp_servers.tempreon] block with your URL, save, then fully quit Codex with Cmd-Q and reopen. You can also run codex mcp add tempreon --url followed by your Tempreon URL to write the same block from the terminal and start sign-in.
I can't find the Codex app on my Mac anymore — where did it go?
OpenAI folded the standalone Codex Mac app into the ChatGPT desktop app in July 2026, so there is no separate Codex application to open. Launch the ChatGPT desktop app and use Codex from there. Your MCP configuration is unaffected, since every Codex surface reads the same ~/.codex/config.toml file.