UserProof

Connect ChatGPT to UserProof: what works in the desktop app, Codex and the web

Updated . By Ryan Doyle, founder of UserProof, a session replay tool for coding agents.

You can connect UserProof to the ChatGPT desktop app and to Codex, because both start local MCP servers and share one config file. Add it once with codex mcp add userproof -- npx -y github:GetUserProof/userproof. ChatGPT in a web browser can't use it yet: UserProof has no remote MCP server and no ChatGPT plugin.

For founders who build their site with ChatGPT and Codex: we tested the server on November 7, 2026: started cold with npx, it answered its first request in 4.7 seconds and listed 14 tools. That is under Codex's 10-second start limit on our machine, but a slower network can pass it, so the steps below raise the limit to 60.

Jump to: quick picks · desktop app · Codex · chatgpt.com · our test · limits · price · FAQ

Quick picks: where do you use ChatGPT?

If you work inDoes UserProof connect?What to do
The ChatGPT desktop appYesAdd a STDIO server under Settings, MCP servers. Steps.
Codex in the terminal or your editorYesOne codex mcp add command. Full Codex and Cursor steps.
chatgpt.com in a browserNot yetUse the desktop app or Codex on the same account. Why.
Claude CodeYes, as a pluginSet up UserProof in Claude Code.

Connect the ChatGPT desktop app

The desktop app adds MCP servers in its settings, and OpenAI's MCP page says the desktop app, the Codex CLI and the Codex IDE extension share that configuration. Add UserProof in one of them and the others see it.

  1. Open Settings, then MCP servers, then Add server. Done looks like a form asking for a name and a transport.
  2. Fill in the server. Name it userproof, pick STDIO, and set the command to npx with the arguments -y github:GetUserProof/userproof. It needs Node.js on your computer, because npx comes with it.
  3. Save, then Restart. Done looks like userproof in the server list, marked enabled.
  4. Check it loaded. Type /mcp in the composer. Done looks like userproof among the connected servers.
  5. Run setup once, from Codex in your site's folder. Until setup has run, every UserProof tool answers that no API key was found. Setup needs an agent that can run commands in your project, so open Codex there and ask it to follow getuserproof.com/setup.md. It signs you in, writes the key to ~/.config/userproof/key, adds the script tag and proves it records. The desktop app's copy of the server reads the same key file.

Connect Codex

Codex is OpenAI's coding agent, in the terminal and in your editor. It takes the same server with one command:

codex mcp add userproof -- npx -y github:GetUserProof/userproof

Then add startup_timeout_sec = 60 under [mcp_servers.userproof] in ~/.codex/config.toml, because Codex gives a server 10 seconds to start by default and the first start downloads it. Run codex mcp list to see it. The Codex and Cursor install page has every step with what done looks like. To write the entry for another agent too, use the MCP config generator. To see how UserProof compares with other analytics an agent can read, see our ranking of 7 tools for AI coding agents.

Why chatgpt.com can't use UserProof yet

OpenAI's MCP page says ChatGPT on the web uses remote MCP tools through plugins, and that it does not read local Codex config files. UserProof's MCP server runs on your own computer over standard input and output; there is no hosted address for chatgpt.com to call, and no UserProof plugin in ChatGPT. So a chat in the browser can talk about UserProof, but it can't read your site's visits or hand you a fix from them. That changes only if we ship a remote server, and this page will say so when we do.

What we saw when we ran it

On November 7, 2026 we started the server the way the steps above do, with an empty npm cache and no UserProof key, and sent it the first two messages any MCP client sends. The reply, trimmed to the parts that matter:

initialize  -> {"name": "userproof", "version": "3.10.0"}, protocol 2025-06-18, 4.7 s after start
tools/list  -> list_sites, select_site, get_top_fix, fleet, mark_fix_applied, set_industry, set_goal,
               upgrade, check_fix, wait_for_first_event, scan_site, check_coverage, get_activation, get_usage
list_sites  -> "UserProof isn't connected yet: no API key found. To create an account and key in
               about a minute, run setup ..."

That last line is what the ChatGPT desktop app or Codex shows before setup. After setup, ask "what should I work on?" and get_top_fix returns the one fix with the file and line to change.

Limits, stated plainly

Price

PlanPriceRecorded visits a monthSites
Free$05,0003
Pro$29 a month50,000Unlimited
Scale$99 a month250,000Unlimited

Read from our pricing page on November 7, 2026. Analyses and fix checks are unlimited on every plan, and site scans are free up to 10 a day per site. Your ChatGPT plan is separate and billed by OpenAI.

FAQ

Can I use UserProof in ChatGPT on the web?

Not yet. ChatGPT on the web reaches remote MCP servers through plugins, and UserProof's server runs locally on your computer. Use the ChatGPT desktop app or Codex, which can start a local server.

Do the ChatGPT desktop app and Codex share MCP servers?

Yes. OpenAI's MCP page says the desktop app, the Codex CLI and the Codex IDE extension share one configuration, kept in ~/.codex/config.toml, so a server added in one shows up in the others.

Why do the UserProof tools say no API key was found?

Setup hasn't run on this computer yet. Ask Codex, in your site's project folder, to follow getuserproof.com/setup.md. It writes the key to ~/.config/userproof/key, and the server reads it from there on the next start.

Which UserProof tools does ChatGPT get?

14 tools, listed by version 3.10.0 of the server on November 7, 2026. The ones you use most are get_top_fix for the next fix, check_fix to see whether a shipped fix moved your goal, and scan_site for a scan before visitors arrive.

Sources, read November 7, 2026