docs/errors/MCPX_CONFIG_PARSE_ERROR.md
MCPX_CONFIG_PARSE_ERRORSeverity: error Domain: Config
mcpproxy reads ~/.mcpproxy/mcp_config.json (or the path you configured) on
startup and on every change. The file failed JSON parsing — usually a
trailing comma, an unquoted key, or a stray character.
mcpproxy refuses to start with a broken config rather than silently loading a partial state.
jq . ~/.mcpproxy/mcp_config.json
jq will print the line/column of the first parse error. Common offenders:
".mcpproxy writes .bak files when applying migrations / web-UI edits:
ls ~/.mcpproxy/*.bak
cp ~/.mcpproxy/mcp_config.json.bak ~/.mcpproxy/mcp_config.json
If you're not comfortable hand-editing JSON, edit through the web UI: it applies changes atomically and never leaves the file in a broken state.