Cursor, Claude Code, Codex

The fastest path: open a recording and click Open in → Cursor. If the Roll MCP server isn't installed yet, Cursor offers to install it, then opens the recording. Everything below is the manual version.

How it works

Roll runs a small MCP server on your machine (stdio, no cloud endpoint, no token). It reads the recordings the extension saves to ~/.trace/jams and answers questions like "what failed?" with the timeline, the failed requests, and the console errors.

Install the server

npx -y @rollapp.pro/mcp

Optional — let the extension write straight into ~/.trace/jams even when no agent is running:

npx @rollapp.pro/mcp install --extension-id=<id from chrome://extensions>

Cursor

Click Add to Cursor. Cursor opens an install card for the local Roll MCP server. If the deeplink is blocked, paste this into .cursor/mcp.json and restart Cursor.

Add to Cursor

{
  "mcpServers": {
    "roll": {
      "command": "npx",
      "args": ["-y", "@rollapp.pro/mcp"]
    }
  }
}

Claude Code

claude mcp add roll -- npx -y @rollapp.pro/mcp

Codex

Append to ~/.codex/config.toml:

[mcp_servers.roll]
command = "npx"
args = ["-y", "@rollapp.pro/mcp"]

What the agent can call

get_latest_jam, get_timeline <id> — the merged repro story; start here
get_network <id> --failed_only — just the requests that broke, with bodies
get_console <id> --level error — errors with stacks
get_keyframes <id> — JPEG stills for vision models
list_jams, search_jams, resolve_jam, comment_jam, create_jam

Try: "Open the latest Roll and tell me why checkout failed." A published /c/<id> URL works as the id too.

Settings UI

The same configs live on the MCP settings page, with Add to Cursor and copy buttons for Claude Code.