Quit Claude and open it again after you save. The desktop file starts a local process. It does not take a URL on its own.
Local npx
stdio
{
"mcpServers": {
"mcp-reference-server": {
"command": "npx",
"args": ["-y", "mcp-reference-server"],
"env": { "MCP_MODE": "stdio" }
}
}
}
Hosted server
mcp-remote opens the hosted URL from that local process.
{
"mcpServers": {
"mcp-reference-server": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://your-app.onrender.com/mcp"]
}
}
}
When auth mode is write or all, pass the key the way mcp-remote documents an Authorization header. Auth is off on a fresh server, so the block above needs no key. For a local stdio process, set MCP_API_KEY in env.