LOCAL AGENT

Create with Codex.

Add a Streamable HTTP server and use OAuth login with read/generate scopes.

Native MCP OAuth or OpenGen CLI

A few steps to get connected.

  1. Review the commands below. Adding a server changes the MCP configuration shared by the Codex CLI and IDE.
  2. Run the login command in an interactive terminal and review OpenGen’s consent in your browser.
  3. Inspect MCP status and ask for catalog discovery. A saved server definition alone does not establish a successful connection.
Endpoint format · use your configured gateway
https://opengen.dev/mcp
Client configuration commands · review before running
codex mcp add opengen --url https://opengen.dev/mcp
codex mcp login opengen --scopes read,generate --oauth-client-registration dcr

Instructions based on Official OpenAI command reference ↗, reviewed 2026-11-03. Client interfaces and permissions can change.

Prefer a shell workflow? Use OpenGen’s CLI and browser login →

If setup stops halfway

The browser sign-in is unavailable

Your deployment must have sign-in configured. Start at your workspace to check availability. Hosted assistants need a publicly reachable HTTPS endpoint; installing code inside their sandbox does not create a hosted connector.

I denied consent or chose the wrong workspace

Start connection again and review the paying workspace before approving. A key stays in its issued workspace. To change an agent’s workspace, revoke its old authorization and sign in again with the intended selection.

Local login expired or was interrupted

Run opengen doctor using the installed CLI. Sign in again when expired or revoked. A stale profile lock requires checking that no OpenGen process is active before removing it; never bypass token-reuse checks or share the profile.

I want to disconnect

Revoke the connected app in OpenGen’s workspace, then remove its client configuration. For OpenGen’s CLI, opengen logout revokes before deleting the private profile. If revocation fails, keep the profile and retry.