Skip to main content
Codex supports connecting to Civic directly over HTTP using the Streamable HTTP transport — no local proxy required.

​
Prerequisites

  • Codex installed and authenticated
  • Civic account at app.civic.com

​
Quick Setup (CLI)

Step 1 — Register the remote MCP server: 
codex mcp add civic --transport http https://app.civic.com/hub/mcp
Step 2 — Launch Codex: 
codex
Step 3 — Run /mcp, select civic, 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 CIVIC_URL — for example https://app.civic.com/hub/mcp?profile=your-toolkit
  3. Paste your CIVIC_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 civic 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 Civic session in your default browser; the MCP flow opens a new window for login
  • Delete and re-add the server with codex mcp remove civic followed by the setup command if you need to refresh credentials

​
Legacy: Hub Bridge (Local Proxy)

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 civic -- npx -y @civic/hub-bridge
Start Codex, run /mcp, select civic, 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