Already set up in Claude Code, Codex, Cursor or VS Code? omp reuses it, so you
are done. Otherwise:

## 1 · Add the server

Run `/mcp add` in omp, or put this in `~/.omp/agent/mcp.json`:

```json
{
  "mcpServers": {
    "brain": { "type": "http", "url": "https://brain.levirge.com/mcp" }
  }
}
```

## 2 · Sign in

Run `/mcp reload`, then `/mcp test brain`, and sign in when the browser opens.
Later: `/mcp reauth brain`.

## 3 · Verify

Ask for a read-only call: `kb_overview` returns your workspace's knowledge
summary.

## Using a token instead

For machines that cannot open a browser (CI, a server). Get a
[token](/brain/docs/install/mcp#auth) first and put it in an environment
variable, for example `export BRAIN_TOKEN=<your-token>`. Then add a `headers`
line; omp expands the variable:

```json
{
  "mcpServers": {
    "brain": {
      "type": "http",
      "url": "https://brain.levirge.com/mcp",
      "headers": { "Authorization": "Bearer ${BRAIN_TOKEN}" }
    }
  }
}
```

## Troubleshooting

**omp does not see the server.** Run `/mcp reload` to rediscover configs, then
`/mcp test brain`.

**Sign-in has expired.** Run `/mcp reauth brain`.

**"401" or "Unauthorized" with a token.** Check the header is exactly
`Authorization: Bearer <your-token>`, and that the token has not been revoked on
[Profile → MCP Tokens](https://brain.levirge.com/profile).

## Other clients

Every guide is listed under [any MCP client](/brain/docs/install/mcp). No
workspace yet? [Request access](/contact).
