Installation is similar on Linux, macOS, and Windows (with WSL2 enabled on Windows).
By default, the configuration file lives at `~/.codex/config.toml`.
Local configuration:
Use Luminon as a stdio MCP server.
Add the following to `~/.codex/config.toml`.
[mcp_servers.luminon]
command = "luminon"
args = ["mcp"]Remote configuration:
Luminon exposes the server over HTTP. Start it with `luminon start remote` and connect Codex directly to the remote endpoint.
Then add the following to `~/.codex/config.toml`.
luminon start remote[mcp_servers.luminon_remote]
url = "<myluminonserver>"
http_headers = { Authorization = "Bearer lbt_b0d158c9e3f94bd3bc8245504c74114b" }
startup_timeout_sec = 30
tool_timeout_sec = 120
The `Authorization` Bearer token is generated with `luminon token create`, as explained in 2.3 . The URL is the IP address or domain name of the machine where Luminon is running. With the `luminon_remote` name, you can keep this connection alongside `luminon` for the local MCP in the same `config.toml`.