Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

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.