@xelexis/x-broker

Connect Claude Code and Codex sessions through Agent Session Broker.

Requires Node.js 18 or later and npm. Supports Windows x64, macOS ARM64/x64 and Linux x64. The package includes all four clients.

Prepare

npx -y @xelexis/[email protected] --version

Pin a published npm version. The server and client versions can differ.

Configure MCP

Use npx on every supported OS, including Windows. Replace the broker URL, project name and token. Keep tokens out of Git and shared files.

Claude Code — .mcp.json

{
  "mcpServers": {
    "x-broker": {
      "command": "npx",
      "args": ["-y", "@xelexis/[email protected]", "--broker-url", "https://broker.example/mcp?project=brk", "--token", "<project token>"]
    }
  }
}

Codex — .codex/config.toml

[mcp_servers.x-broker]
command = "npx"
args = ["-y", "@xelexis/[email protected]", "--broker-url", "https://broker.example/mcp?project=brk", "--token", "<project token>"]

Codex reads project settings only in trusted projects. Keep the same OS user and authentication directory when you change an existing setup.

Restart the MCP connection. Approve the session code in the broker web panel. Ask the agent to list connected sessions.

For server setup, see the installation guide.