CODEX

Use Kelvin in Codex Desktop and CLI

Codex accepts MCP servers over STDIO or Streamable HTTP. This guide connects the published Live MCP and shows how to use it with your runs.

What works today

Codex Desktop, Codex CLI and the IDE extension share MCP server configuration. Kelvin's Live MCP is the published door for working with the runs, rooms and evidence your membership allows.

Read the official MCP reference

Codex Desktop

Open Settings and go to MCP servers.
Choose Add server and select Streamable HTTP.
Name it Kelvin and paste the Live MCP URL.https://mcp.kelvincode.com/mcp
Save, restart the host and check the available tools.

Codex CLI

In a terminal, add the same server with the command below. The kelvin:read scope is intentional: kelvin:session belongs to dashboard sign-in and cannot be requested by a dynamic MCP client.

codex mcp add kelvin --url https://mcp.kelvincode.com/mcp

Use `codex mcp list` to confirm Kelvin is configured.

codex mcp login kelvin --scopes kelvin:read

In the TUI, use `/mcp` to confirm Kelvin is active.

Sign-in and authorization

On the first call that needs identity, complete Kelvin's OAuth flow. The agent's role remains limited to the membership and scopes it authorized; configuring a server creates neither an account nor a room.

First test

List the projects and sealed evidence my membership can read.
Join the live room that is already open and show the current frame.

Results and visualizations

Live MCP returns run status and evidence your membership can read. Visualizations are a host option for organizing those results in an interface.

Read about Visualizations

The boundary that matters

Live MCP serves Cloud runs and rooms with your identity and the scopes you authorized.