Connect ChatGPT to UserProof: what works in the desktop app, Codex and the web
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 in | Does UserProof connect? | What to do |
|---|---|---|
| The ChatGPT desktop app | Yes | Add a STDIO server under Settings, MCP servers. Steps. |
| Codex in the terminal or your editor | Yes | One codex mcp add command. Full Codex and Cursor steps. |
| chatgpt.com in a browser | Not yet | Use the desktop app or Codex on the same account. Why. |
| Claude Code | Yes, as a plugin | Set 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.
- Open Settings, then MCP servers, then Add server. Done looks like a form asking for a name and a transport.
- Fill in the server. Name it
userproof, pick STDIO, and set the command tonpxwith the arguments-y github:GetUserProof/userproof. It needs Node.js on your computer, becausenpxcomes with it. - Save, then Restart. Done looks like
userproofin the server list, marked enabled. - Check it loaded. Type
/mcpin the composer. Done looks likeuserproofamong the connected servers. - 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
- No browser-only path. You need the ChatGPT desktop app or Codex, plus Node.js.
- Setup runs from a coding agent. It edits your site's code to add the script tag, so it runs where your project is open.
- It needs real visitors for a fix. Before traffic arrives, the free scan finds broken elements on your live site; the top fix comes from recorded visits.
- Field values are never recorded. A click keeps the first 50 characters of the clicked element's text, so mark rich-text editors with
data-exclude.
Price
| Plan | Price | Recorded visits a month | Sites |
|---|---|---|---|
| Free | $0 | 5,000 | 3 |
| Pro | $29 a month | 50,000 | Unlimited |
| Scale | $99 a month | 250,000 | Unlimited |
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
- OpenAI, Model Context Protocol: desktop app, Codex CLI (codex mcp add, startup_timeout_sec default 10, shared config.toml) and IDE extension, plus ChatGPT web, read November 7, 2026
- UserProof MCP server: GetUserProof/userproof, version 3.10.0, started and queried November 7, 2026
- UserProof setup steps: setup.md, read November 7, 2026
- UserProof plans: pricing page, read November 7, 2026