Skip to content

From October 1, WhatsApp charges for every business reply. Read the migration playbook

AI agents

Connect SuperCognit to Codex

OpenAI's Codex CLI and IDE extension connect to remote MCP servers from a single config file. Add your SuperCognit workspace and Codex can create and edit agents, build knowledge bases from your docs, register your API endpoints as tools and read conversations — as part of the coding tasks you already give it.

Connection details

Replace <workspace> with the workspace slug shown under Integrations → Platform MCP, and <api-key> with a workspace API key when your client does not sign in with OAuth. Published MCP servers connect the same way at their own URL.

# ~/.codex/config.toml
[mcp_servers.supercognit]
url = "https://mcp.supercognit.com/platform/<workspace>/mcp"

# then, in a terminal:
# codex mcp login supercognit

What you can do once it's connected

  • Ship agent changes with the codeChange a tool's endpoint in your API and have Codex update the matching SuperCognit tool definition in the same task.
  • Turn an OpenAPI spec into agent toolsCodex reads your spec, creates one SuperCognit tool per operation you choose and attaches them to the agent.
  • Knowledge from the repositoryDocs folders, changelogs, README files — Codex can push them into a knowledge base and refresh it when they change.
  • Investigate a bad answerFetch the conversation, inspect the tool calls and the cited sources, and fix the instructions or the knowledge — all in one session.

Codex

How to connect

Add your SuperCognit workspace to OpenAI Codex with one config entry. Create agents, manage knowledge and attach tools from the Codex CLI or IDE extension.

  1. Copy your workspace MCP URL

    Integrations → Platform MCP in the dashboard. One URL per workspace.

  2. Add the server to config.toml

    Add an [mcp_servers.supercognit] table with the url to ~/.codex/config.toml, or run codex mcp add supercognit --url <url>.

  3. Sign in

    Run codex mcp login supercognit to complete the OAuth sign-in in your browser. If your Codex version has no OAuth login, add a workspace API key as an x-api-key header following Codex's MCP docs.

  4. Work

    Start Codex and ask it to list your agents. It calls the workspace tools and asks for approval before anything that writes.

Frequently asked questions

Still wondering? Ask our agent; it answers from these same pages.

More AI agents

Connect from the other AI agents you use.

Human ambition. SuperCognit intelligence.

Your workspace, one MCP URL away

Create a workspace, copy the MCP URL from Integrations → Platform MCP, paste it into your agent — free for 7 days.