Skip to main content

Codex Setup

Codex supports connecting to Leadovaro directly over HTTP using the Streamable HTTP transport — no local proxy required.

Prerequisites​

Quick Setup (CLI)​

Step 1 — Register the remote MCP server:

codex mcp add leadovaro --transport http /_sites/app.leadovaro.com/hub/mcp

Step 2 — Launch Codex:

codex

Step 3 — Run /mcp, select leadovaro, and follow the browser sign-in flow to authorize.

Setup via Desktop App​

You can also register the MCP server via the Codex desktop app UI:

  1. Open Settings → MCP Servers → Add Server → Streamable HTTP
  2. Paste your LEADOVARO_URL — for example /_sites/app.leadovaro.com/hub/mcp?profile=your-toolkit
  3. Paste your LEADOVARO_TOKEN if using token authentication
  4. Save — you are ready to go.
Get Your Credentials

How to find your MCP URL and generate a token

Verify the Connection​

  • In Codex, run /mcp to check that leadovaro shows as connected
  • Test a command such as "What tools do I have available?" to confirm the session is authorized

Troubleshooting​

  • If the connection shows failed, re-run codex --debug to view detailed logs in your terminal
  • Ensure you have an active Leadovaro session in your default browser; the MCP flow opens a new window for login
  • Delete and re-add the server with codex mcp remove leadovaro followed by the setup command if you need to refresh credentials

Legacy: Hub Bridge (Local Proxy)​

note

The Hub Bridge is a legacy local proxy for environments that cannot make outbound HTTPS connections to remote MCP servers. Use the HTTP method above unless you specifically need offline capability or your environment blocks outbound HTTPS.

If you require the Hub Bridge:

Prerequisites: Node.js 18+

codex mcp add leadovaro -- npx -y @civic/hub-bridge

Start Codex, run /mcp, select leadovaro, and follow the browser sign-in flow.

Hub Bridge Guide

Full Hub Bridge configuration details

Resources​

Client Compatibility

MCP support matrix for Codex

Troubleshooting

Common Codex connection fixes

Get Help

Ask setup questions in our developer Slack