Connecting to MCPX

Once your MCPX service is up and running, connect your MCP servers and clients. We recommend to use the MCPX Control Plane or you can connect manually using the following steps:

Connect Your MCP Servers to MCPX

1

Configure app.yaml (Optional)

Create and update your app.yaml configuration file:

cd config
touch app.yaml

For Example:

permissions:
  default:
    allow: []
  consumers: {}
  toolGroups: []
  auth:
    enabled: false
  toolExtensions:
    services: {}   

See the app.yaml configuration guide for detailed information.

2

Configure mcp.json

Create and update your mcp.json configuration file:

touch mcp.json

For example:

{
  "time": {
    "command": "uvx",
    "args": ["mcp-server-time", "--local-timezone=America/New_York"]
  }
}

See the mcp.json configuration guide for detailed information. Make sure to define any necessary Environment Variables.

Once MCPX is running with your MCP servers, connect your client to MCPX instead of individual MCP servers.

Connect Your Client to MCPX

1

Setup the Connection to MCPX

Configure your client to connect to MCPX using the following:

Go to the Settings in your AI agent platform, for example, Claude or Cursor, and edit the MCP configuration.

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

Make sure to configure the args for your use case, change x-lunar-consumer-tag to your desired Agent/application name.

Expected Result

Once connected, you will see your connected agent and server in the MCPX Control Plane.

Example for usage

Once connected, you can use the Time tool through MCPX. For example:
Ask Claude: "What is the current time in Tokyo, Japan?" Claude will connect to the Time server and return the current time in Tokyo.

What's Next?

Connect your MCP Servers

Learn how to connect your MCP servers to MCPX and connect AI agents to MCPX

Connect your Client

Choose from one of the ways to connect your client to MCPX

Monitor with Metrics

Use MCPX's built-in Prometheus metrics to monitor tool usage and performance

Configure Access Control

Set up granular access policies to control which tools each agent can access