Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.corsair.dev/llms.txt

Use this file to discover all available pages before exploring further.

You can set up Codex with Corsair through the dashboard or in code.

​
In the dashboard

  1. Sign in at app.corsair.dev.
  2. Open Dashboard and click New instance.
  3. Open your instance and click Add Plugin to enable an integration (e.g. GitHub, Slack).
  4. Click New User to add a tenant — enter a tenant ID and click Save.
  5. Connect the integration for that tenant: click the cell where the tenant row meets the plugin column, then sign in with OAuth or enter credentials.
  6. Click the tenant name in the first column to open the side panel.
  7. Copy the MCP URL and create an API key (New key → name → Create → copy the secret once).
Quick Start is an optional guided demo if you want Corsair to provision a sample instance for you.

​
In code

​
Configure Codex

In Codex, add a custom MCP server with Streamable HTTP:
FieldValue
Namecorsair
URLYour MCP URL from the dashboard
HeaderAuthorization
ValueBearer <tenant-api-key-secret>
CLI: 
export CORSAIR_MCP_SECRET="ch_..."
codex mcp add corsair \
  --url "https://api.corsair.dev/mcp/YOUR_INSTANCE_ID?tenantId=your-tenant-id" \
  --bearer-token-env-var CORSAIR_MCP_SECRET
~/.codex/config.toml: 
[mcp_servers.corsair]
url = "https://api.corsair.dev/mcp/YOUR_INSTANCE_ID?tenantId=your-tenant-id"
http_headers = { Authorization = "Bearer ch_..." }
Verify with codex mcp list.

​
With the SDK

import { createClient } from "@corsair-dev/app";

const key = await createClient({ apiKey: process.env.CORSAIR_DEV_KEY! })
  .instance(process.env.CORSAIR_INSTANCE_ID!)
  .tenant("your-tenant-id")
  .mcpKeys.create("codex");

​
Try it

Run a prompt in Codex. If you connected GitHub, try: 
Use Corsair to star the Corsair repo on GitHub