> ## Documentation Index
> Fetch the complete documentation index at: https://sendmux.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex MCP setup

> Configure Qubrics MCP in Codex.

Use this page to connect Qubrics MCP to your AI client.

## Hosted OAuth

Use the hosted endpoint when the client supports remote MCP OAuth:

```text theme={null}
https://mcp.qubrics.com/mcp
```

Add this to `~/.codex/config.toml` or a trusted project `.codex/config.toml`.

```toml theme={null}
[mcp_servers.sendmux]
url = "https://mcp.qubrics.com/mcp"
```

Then authenticate:

```bash theme={null}
codex mcp login sendmux
```

## Local stdio

> [!WARNING]
>
> Before upgrading an existing installation, keep its working package environment,
> dependency state, and MCP client and tool configuration. Version 2.0.0 removes
> local `file_path` and roots inputs from MCP attachment tools. Before switching
> existing agents, follow the [upgrade and rollback guidance](https://github.com/qubrics/qubrics-sdk/blob/main/packages/python/mcp/README.md#200-upgrade).

Install the local package once:

```bash theme={null}
pip install --upgrade sendmux-mcp
```

Use a mailbox key for Mailbox or Sending:

```bash theme={null}
export QUBRICS_MBX_KEY=smx_mbx_...
```

Use a root key for Management:

```bash theme={null}
export QUBRICS_ROOT_KEY=smx_root_...
```

Run Codex with `QUBRICS_API_KEY` already set, then use `env_vars` so the value stays outside the config file.

```toml theme={null}
[mcp_servers.sendmux_mailbox]
command = "sendmux-mcp-mailbox"
env_vars = ["QUBRICS_API_KEY"]
```

## Private HTTP

Start a local HTTP MCP server:

```bash theme={null}
export QUBRICS_MCP_HTTP_BEARER_TOKEN=local-mcp-token

QUBRICS_API_KEY=smx_mbx_... \
sendmux-mcp-mailbox --transport http --host 127.0.0.1 --port 8765
```

Use `http://127.0.0.1:8765/mcp` as the client URL.

```toml theme={null}
[mcp_servers.sendmux_local]
url = "http://127.0.0.1:8765/mcp"
bearer_token_env_var = "QUBRICS_MCP_HTTP_BEARER_TOKEN"
```

Keep the server running. In the shell where you start Codex, export the same bearer token:

```bash theme={null}
export QUBRICS_MCP_HTTP_BEARER_TOKEN=local-mcp-token
codex
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.