Install Lightsage MCP in Codex - Lightsage

Documentation Index

Fetch the complete documentation index at: /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 for the full configuration reference.