Connect to Remote Instance

The open-source version of MCPX runs locally and therefore does not support HTTPS and non-TLS HTTP connections are blocked by default.

In order to enable remote HTTP connections, you must explicitly add the --allow-http flag when starting the connection and make sure to use the mcp-remote version mcp-remote@0.1.21. This requirement comes from our dependency on mcp-remote.

For security reasons, if you are connecting MCPX to a remote machine, we strongly recommend doing so within your VPC since limiting access to a secure network is essential.

Example JSON

{
  "mcpServers": {
    "mcpx": {
      "command": "npx",
      "args": [
        "mcp-remote@0.1.21",
        "http://34.171.81.235:9000/mcp",
        "--allow-http",
        "--header",
        "x-lunar-consumer-tag: Claude"
      ]
    }
  }
}