Codex

Two install paths are supported. The plugin path is preferred — it ships the bundled skill prompt and uses OAuth.

Plugin install (preferred, OAuth)

Codex splits this into a shell command to register the marketplace, then a slash command inside Codex to install the plugin.

Add the marketplace from your shell

codex plugin marketplace add Within/within-mcp

Install the plugin from a Codex session

Open the plugins picker:

/plugins

Search for Within and install the plugin.

The first request that hits a Within tool will prompt you to authenticate.

Config file install (API key)

Use this for long-running background agents. Generate an API key from Settings → MCP in your Within workspace (see Authentication) and add the server to ~/.codex/config.toml:

[mcp_servers.within]
url = "https://api.within.ai/mcp"
bearer_token_env_var = "WITHIN_MCP_TOKEN"

Set the environment variable in your shell profile (~/.zshrc, ~/.bashrc):

export WITHIN_MCP_TOKEN=<YOUR_API_KEY>

Restart your terminal (or source the profile) so Codex picks up the new variable.

Treat the API key like a password. Rotate it from Settings → MCP in Within if it’s exposed.

Verify

In a Codex session, ask:

Search Within for AI transformation opportunities across our processes — where could we build skills or deploy agents?

The assistant should call search and return process results from your workspace.

Getting started

Install

Concepts

How-to guides

Help

Plugin install (preferred, OAuth)

Config file install (API key)

Verify

​Plugin install (preferred, OAuth)

​Config file install (API key)

​Verify

Plugin install (preferred, OAuth)

Config file install (API key)

Verify