# Connect Codex

Use Masheev from the Codex CLI, IDE extension or app through the hosted MCP server.

> **Release status.** The hosted endpoint, OAuth, curated operator tools, toolset endpoints and the send permission are live. The Codex plugin installs from the public [masheev/skills](https://github.com/masheev/skills) marketplace.

## OAuth (recommended)

```bash
codex mcp add masheev --url https://api.masheev.com/api/agents/mcp
codex mcp login masheev
```

`login` opens Masheev in your browser. Pick one workspace and the permissions to grant. The entry lands in `~/.codex/config.toml`:

```toml
[mcp_servers.masheev]
url = "https://api.masheev.com/api/agents/mcp"
```

## Agent key (CI and headless)

Create a workspace agent key in **Developers → Connect an agent**, keep it in a private environment variable, and reference the variable name:

```bash
codex mcp add masheev --url https://api.masheev.com/api/agents/mcp --bearer-token-env-var MASHEEV_API_TOKEN
```

## Plugin with skills

The public [masheev/skills](https://github.com/masheev/skills) repository is a Codex marketplace. Its plugin bundles the remote server with every Masheev skill:

```bash
codex plugin marketplace add masheev/skills
codex plugin add masheev@masheev
```

## Larger tool sets

Use `https://api.masheev.com/api/agents/mcp/x/<toolset>`, `/x/all` or `/readonly` in place of the default URL for the full catalog grouped by area.

See [Connect an agent](https://docs.masheev.com/agents.md) for permissions and revocation.