UserProof

MCP config generator: one server, the right setup for 5 coding agents

Updated . Free tool, runs in your browser. By Ryan Doyle, founder of UserProof, a session replay tool for coding agents.

Type one MCP server's name and its start command or URL, and this page writes the setup for Claude Code, Codex, Cursor, VS Code and Claude Desktop: the command to run, or the JSON or TOML entry to paste. We read each format from that agent's own docs on November 7, 2026. Nothing you type leaves your browser.

For builders who add one MCP server to more than one agent: each agent stores the same server in a different shape. VS Code keys it under servers, Cursor and Claude Desktop under mcpServers, Codex in a TOML table, and Claude Code takes one command. The example below is the UserProof server, which answered its first request 4.7 seconds after a cold start in our test.

Your server

How it runs
Names only. The values stay in your shell or the agent's own settings.
Agents

The generator needs JavaScript and its script hasn't run, so editing changes nothing here. The result below is the example, written out in full.

Example result

5 agents for userproof, a local server started by npx -y github:GetUserProof/userproof.

Claude Code

Command run it in your project folder

claude mcp add --transport stdio userproof -- npx -y github:GetUserProof/userproof

Add --scope user for every project, or --scope project to write .mcp.json for your team.

.mcp.json in the project root, shared with your team

{
  "mcpServers": {
    "userproof": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "github:GetUserProof/userproof"
      ]
    }
  }
}

Codex (CLI, IDE extension and ChatGPT desktop app)

Command

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

Or ~/.codex/config.toml

[mcp_servers.userproof]
command = "npx"
args = ["-y", "github:GetUserProof/userproof"]
startup_timeout_sec = 60

The default start timeout is 10 seconds; the first start of npx downloads the server and can take longer. The ChatGPT desktop app and the Codex IDE extension read this same file.

Cursor

~/.cursor/mcp.json (or .cursor/mcp.json in one project)

{
  "mcpServers": {
    "userproof": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "github:GetUserProof/userproof"
      ]
    }
  }
}

Already have the file? Add the inner "userproof" entry under your existing mcpServers.

VS Code

.vscode/mcp.json in your workspace

{
  "servers": {
    "userproof": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "github:GetUserProof/userproof"
      ]
    }
  }
}

VS Code's file uses servers, not mcpServers.

Claude Desktop

claude_desktop_config.json Settings, Developer, Edit Config (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\)

{
  "mcpServers": {
    "userproof": {
      "command": "npx",
      "args": [
        "-y",
        "github:GetUserProof/userproof"
      ]
    }
  }
}

Quit and reopen Claude Desktop after saving.

Where each agent keeps its servers

AgentWhere the server goesTop-level keyRemote serversReads a variable as
Claude Codeclaude mcp add; .mcp.json for a projectmcpServers--transport http${NAME}
Codex, ChatGPT desktop appcodex mcp add; ~/.codex/config.toml[mcp_servers.name]urlenv_vars list
Cursor~/.cursor/mcp.json or .cursor/mcp.jsonmcpServersurl${env:NAME}
VS Code.vscode/mcp.jsonservers"type": "http"${env:NAME}
Claude Desktopclaude_desktop_config.jsonmcpServersSettings, Connectorsvalue in the file

Each row was read from the agent's own docs on November 7, 2026 (links under Sources). The ChatGPT desktop app, the Codex CLI and the Codex IDE extension share one file, so one entry covers all three.

How to use it

  1. Name the server. Letters, numbers, - or _. Done looks like the name in every block below.
  2. Say how it runs. A local server starts from a command such as npx, uvx or a path, plus its arguments. A remote one is a URL. Done looks like the summary line naming the command or URL.
  3. List the variable names it needs, if any. For a remote server, the one that holds your bearer token. Done looks like each agent's own way of reading it, such as ${env:API_KEY} for Cursor.
  4. Copy the block for your agent. Paste the command in a terminal, or merge the entry into the file. Done looks like the server in the agent's list (claude mcp list, codex mcp list, or /mcp).

Keep keys out of the files

The generator never asks for a value. Cursor and VS Code read ${env:NAME} from your environment, Claude Code's .mcp.json reads ${NAME}, and Codex's env_vars list forwards variables you already set. So the file you commit holds names only. Claude Desktop's guide writes values into its config file, so that block leaves a PASTE_..._HERE marker for you to fill in on your own computer. The UserProof server needs no variable at all: it reads its key from ~/.config/userproof/key, which setup writes.

Limits, stated plainly

What UserProof adds once it's connected

UserProof is the example server above. Once it is connected, it records what real visitors do on your site and hands your coding agent the one fix with the file and line, then checks whether it worked. Free covers 3 sites and 5,000 recorded visits a month; Pro is $29 a month (pricing, read November 7, 2026). Setup guides: Claude Code, Codex and Cursor, ChatGPT.

Related free tools: the dead click finder, the funnel calculator, the session replay cost calculator.

FAQ

What is the difference between mcp.json and .mcp.json?

They belong to different agents. Cursor reads mcp.json from ~/.cursor or a project's .cursor folder. Claude Code reads .mcp.json from the project root. VS Code reads .vscode/mcp.json and keys servers under "servers" instead of "mcpServers".

Where is the Codex MCP config file?

~/.codex/config.toml, or .codex/config.toml inside a trusted project. Each server is a [mcp_servers.name] table. The ChatGPT desktop app and the Codex IDE extension read the same file.

Why does my MCP server time out in Codex?

Codex gives a server 10 seconds to start by default. A server started with npx downloads itself the first time, which can take longer. Add startup_timeout_sec = 60 to its table; the generator does this for npx, uvx, bunx and pnpx.

Does this generator send or store what I type?

No. It runs in your browser, makes no requests and saves nothing. The page has the same visit analytics as the rest of this site, and the form and the result are marked so that analytics never records them. Reload the page and it starts from the example again.

Sources, read November 7, 2026

All of our free tools, including the dead click finder and the funnel calculator, are on the free tools page.