Skip to main content

​
Install the plugin in the desktop app

Before you start, make sure you can sign in to Codex with your ChatGPT account and sign in to Unblocked.
1

Open the Unblocked plugin

Open Plugins in the desktop app, search for Unblocked, and open its details.You can also open Unblocked in the plugin directory.
2

Install Unblocked

Select Install plugin or the plus button to install Unblocked.
3

Connect your Unblocked account

When prompted, sign in to Unblocked and authorize the connection. Codex may ask you to connect during installation or the first time you use the plugin.
4

Start a new task

Start a new task in Codex so it can use the plugin. Ask it to use Unblocked to answer a question about your team or codebase.
You can also install the plugin in ChatGPT.

​
Quick install (macOS and Linux)

Run the following command to install Unblocked MCP:
The script downloads the Unblocked CLI and sets up your supported agents.
The install script supports macOS and Linux. On Windows, follow the install guide for your app.

​
Manual install (macOS, Windows, Linux)

You can connect Codex to remote Unblocked MCP with the following command:
After adding the server, log in to Unblocked via OAuth:
Codex will launch a browser to authenticate with Unblocked. Alternatively, you can add the server manually by editing the config file:
  • macOS / Linux: ~/.codex/config.toml
  • Windows: %USERPROFILE%\.codex\config.toml