GoRunner docs
Search or askSearch⌘K

Codex

Connect Codex to GoRunner, then ask it to build, run and check your workflows.

3 min · Cloud, Self-hosted and Embed

You need

Codex
On your computer.

Connect Codex

  1. In GoRunner, open MCP in the sidebar. If an app is already connected, press Connect an AI app. Choose Codex; if it isn’t shown, press All 13 apps.
    The Connect an AI app panel with Codex chosen. The ringed key is the one to press.
  2. In a terminal, run:
    Terminal
    codex mcp add gorunner --url https://api.gorunner.io/mcp/build
  3. Codex opens your browser. Sign in to GoRunner.
  4. On Allow “Codex” to use GoRunner?, choose the workspace and what it may do, then press Allow access.

Since v2026.10.23

  1. In the product you use, open MCP, press Connect an AI app and choose Codex.
  2. In a terminal, run:
    Terminal
    codex mcp add workflows --url https://YOUR_INSTALLATION/mcp/embed/YOUR_ACCOUNT_ID/build
  3. Codex opens your browser. Sign in with the account you use here.
  4. Choose what it may do, then press Allow access.

You should see “Connected · Codex · Acme · 12 tools” in the panel.

It stays connected for up to 180 days, or until you disconnect it.

The address is a placeholder for your account’s own, in the panel. The panel shows your product’s name where these steps say workflows. Without sign-in for AI apps, the panel shows Codex with a token instead: make or paste one, and copy the setting it fills in. If the product lets apps run your workflows but not build them, the address ends in /tools. Codex can then only call your published workflows. See Turn your workflows into tools.

Can I use an API token instead?

Yes, for an app that can’t sign in. In the panel, press Use an API token instead. Connect with an API token shows each step.

How do I disconnect Codex?

On the MCP page, under Connected apps, press Disconnect next to the app. Revoke a token in Settings › Workspace › API tokens.

On the product’s MCP page, press Disconnect next to the app.

It stops on its next request. Remove it in Codex too.

What you can ask

13 tools: it reads, drafts and runs in the workspaces you choose. It publishes only if you allow it.What it can do depends on what the product allows: building, or only your published workflows. If Codex lists the server’s commands, try one:

  • Build a workflow (when it may write drafts)
  • Diagnose a failed run
  • Explain a workflow

It can also call your own published workflows.

For developers

AI apps connect through MCP (Model Context Protocol). Codex adds the server https://api.gorunner.io/mcp/build under the name gorunner and signs in with OAuth. Self-hosted: your installation’s address, ending in /mcp/build.