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 referenceCodex 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 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/mcpcodex mcp login kelvin --scopes kelvin:readSign-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.
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 VisualizationsThe 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.