## Documentation Index

Fetch the complete documentation index at: [/docs/llms.txt](/content/docs/llms.txt)

Use this file to discover all available pages before exploring further.

Codex stores MCP configuration in `~/.codex/config.toml`. Use the Codex CLI to add the hosted Lightsage MCP endpoint and complete OAuth sign-in.

### 1

#### Add Lightsage MCP

Add Lightsage as a remote HTTP MCP server:

```
codex mcp add lightsage --url https://mcp.lightsage.com/mcp
```

### 2

#### Sign in with OAuth

Start the OAuth flow and approve access to your Lightsage organization:

```
codex mcp login lightsage --scopes openid,profile,email,offline_access
```

### 3

#### Verify Codex tools

Confirm Codex can read the server config:

```
codex mcp list
```

The `lightsage` entry should use `https://mcp.lightsage.com/mcp` and show **OAuth** under authentication. In an interactive Codex session, run `/mcp` to confirm the server is available. Then run a read-only prompt:

```
Use the Lightsage MCP server to check my Lightsage auth status.
```

See the [Codex MCP docs](https://developers.openai.com/codex/mcp) for the full configuration reference.