KELVINCode
by entropy lab

CODEX

Use Kelvin in Codex Desktop and CLI

Codex accepts MCP servers over STDIO or Streamable HTTP. This guide connects the published Live door and explains the boundary around visualization and Artifact.

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

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

Codex CLI

In a terminal, add the same server with the command below. The URL is the Live door; it is not an Artifact URL. 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 check the configured servers.

codex mcp login kelvin --scopes kelvin:read

In the TUI, use `/mcp` to see active servers. The CLI does not render Visualizations.

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.

What about Artifact MCP?

Artifact MCP is a different surface: it will read an authorized sealed source and prepare derived flows, without jobs, rooms, live frames or input. Nothing on this page connects Artifact.

Current status: in preparation. There is no Artifact URL to copy.

Visualizations and artifacts

Interactive visualization is a host capability. The official documentation says Codex CLI and the IDE extension do not render it; a visualization created in a conversation is a snapshot, not a live Kelvin session.

Read about Visualizations

The boundary that matters

Live MCP holds authority over a run. Artifact MCP will hold reading authority over sealed evidence. MCPB connects an agent to Kelvin.app locally. Do not reuse the Live URL to pretend one surface grants the powers of another.