Skip to main content
Codex connects to Popcorn through Codex CLI. You run two commands that Popcorn gives you: the first registers Popcorn, the second starts the sign-in that opens Popcorn’s approval screen in your browser.

​
Before you start

  • A Popcorn role with API keys view access, so you can open Settings → AI assistants. Owner, Admin and Manager have it.
  • Codex CLI installed on your computer.
  • If you belong to more than one workspace, switch to the one you want first. The connection belongs to the workspace you approve it in.

​
Connect

1

Copy the commands

In Popcorn, go to Settings → AI assistants. Under Connect an assistant, find the Codex card (labelled Codex CLI) and click Copy commands. The commands are:
2

Register Popcorn

Run the first command. It adds Popcorn to Codex as a server named popcorn.
3

Sign in and approve

Run the second command. Codex opens Popcorn’s approval screen in your browser. If you are not signed in, you are sent to sign in first and then brought back.The screen shows the App asking, the Workspace it will reach (with your email), when the Request expires, the Connection address, and Requested access with one line per area, such as “Campaigns: Read”. Check that the workspace is the one you intend, then click Allow access. Return to your terminal.
4

Try a request

Ask Codex something read-only first, for example “Give me an overview of my Popcorn workspace” or “Show my last five orders.”
The approval request is valid for 10 minutes. If the page says Authorization request was not found., run codex mcp login popcorn again.

​
What the approval screen means

  • Requested access lists each area Codex asked for, in the form “Inbox: Send”, with a short description and the access code beside it. A description that says “after you confirm the action” means Codex must show you a preview and get your go-ahead each time before Popcorn carries it out.
  • If Codex does not ask for specific areas, Popcorn grants read-only access to every area your role can view.
  • Access never exceeds your own Popcorn role. If Codex asks for more than your role can grant, the page shows Authorization request expired. instead of the approval screen.
  • Deny cancels the request. Nothing is connected.
  • Codex uses the main address, so billing is available (with confirmation), unlike ChatGPT and the Claude connector.
See Permissions and safety for the full model.

​
First requests to try

​
Built-in workflows

Popcorn publishes four ready-made workflows that Codex can list and run: Safely prepare and launch a campaign, Triage the Popcorn inbox, Review and publish an agent version, and Connect a commerce or messaging integration. Each walks Codex through reading first, showing you a preview, and waiting for your confirmation. See What you can do.

​
Troubleshooting