Connect Codex

Connect Ybug to Codex with the Ybug plugin in the ChatGPT desktop app or Codex CLI. For the IDE extension, use the manual MCP setup.

Install the plugin

ChatGPT desktop app

1. Open Plugins, search for Ybug and open it. You can also open the Ybug plugin listing.
2. Click + to install it.
3. Connect your Ybug account when prompted and approve access.
4. Start a new Codex chat in your project and ask it to use Ybug.

Codex CLI

1. Start codex in your project.
2. Enter /plugins, search for Ybug and install it.
3. Follow the prompts to connect your Ybug account and approve access.
4. Start a new Codex session to load the plugin's tools.

If you aren't prompted to connect during installation, ask Codex to use Ybug in the new chat to start the connection.

OpenAI's own guide: Plugins in ChatGPT and Codex.

Manual MCP setup

Use this for the Codex IDE extension, which doesn't support plugins, or if you sign in to Codex with an OpenAI API key and the plugin isn't available. It's also an option if you prefer adding the MCP server directly. The ChatGPT desktop app, Codex CLI and IDE extension share the MCP configuration in ~/.codex/config.toml, so you only add Ybug once.

Add the server from your terminal:

codex mcp add ybug --url https://mcp.ybug.io/mcp

Then sign in:

codex mcp login ybug

Your browser opens so you can approve access. You don't need an OAuth client ID. Codex registers itself with Ybug automatically.

If you prefer editing the config by hand, add this to ~/.codex/config.toml and run codex mcp login ybug afterwards:

[mcp_servers.ybug]
url = "https://mcp.ybug.io/mcp"

Run codex mcp list, or /mcp inside Codex, to check that Ybug is connected.

OpenAI's own guide: MCP in Codex.

Then check that it works.