Skip to main content
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.
1

Add the marketplace from your shell

codex plugin marketplace add Klarity-AI/klarity-mcp
2

Install the plugin from a Codex session

Open the plugins picker:
/plugins
Search for klarity and install the plugin.
3

Sign in

The first request that hits a Klarity 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 Klarity workspace (see Authentication) and add the server to ~/.codex/config.toml: 
[mcp_servers.klarity]
url = "https://api.klarity.ai/mcp"
bearer_token_env_var = "KLARITY_MCP_TOKEN"
Set the environment variable in your shell profile (~/.zshrc, ~/.bashrc): 
export KLARITY_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 Klarity if it’s exposed.

​
Verify

In a Codex session, ask: 
Search Klarity 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.