Version: Next

Connect Remote MCP Servers to MCPX

Remote MCP servers are hosted outside of your environment, and MCPX can connect to them over HTTP or SSE.

You just need to provide the server name, type, and URL in your mcp.json configuration.

Edit mcp.json

Add each remote MCP server to your configuration with its name, type, and URL.

cd config
nano mcp.json

Example mcp.json with multiple remote servers:

{
  "mcpServers": {
    "notion": {
      "type": "streamable-http",
      "url": "https://mcp.notion.com/mcp"
    },
    "linear": {
      "type": "sse",
      "url": "https://mcp.linear.app/sse"
    }
  }
}

Make sure the url is reachable by MCPX and the type matches the server's streaming protocol.

Restart MCPX

Apply the updated configuration by running the MCPX container.

docker run --rm --pull always -v ./config:/lunar/packages/mcpx-server/config -p 9000:9000 -p 5173:5173 -p 9001:9001 -p 3000:3000 --name mcpx us-central1-docker.pkg.dev/prj-common-442813/mcpx/mcpx:latest

Verify Connection

Once MCPX starts, it will attempt to connect to each remote server.

Check the MCPX logs to confirm successful connections.
If a server is unreachable or returns an error, MCPX will log a warning.

Use the Control Plane to inspect connected servers and debug issues.