Skip to main content

Users: Connect OpenAI Codex to the AI Gateway

To securely access your company's enterprise applications directly from OpenAI Codex, you must connect it to the JumpCloud AI Gateway. Connecting through JumpCloud ensures your enterprise data remains secure and your access is verified.

Configuring Codex​

Important

Use the AI Gateway MCP server URL for your JumpCloud datacenter region. See JumpCloud Data Centers: Login URLs and Service Endpoints.

OpenAI Codex natively supports Streamable HTTP MCP servers. While you can manually edit your ~/.codex/config.toml file, the easiest way to connect to the AI Gateway is by using a simple Codex CLI command:

  1. Open your terminal.

  2. Run the following command to add the JumpCloud endpoint as an MCP server. Use the URL for your datacenter region:

    • US: https://ai.jumpcloud.com/mcp
    • EU: https://ai.eu.jumpcloud.com/mcp
    • IN: https://ai.in.jumpcloud.com/mcp
    codex mcp add jumpcloud --url https://ai.jumpcloud.com/mcp

The example uses the US URL.

  1. If you are using the Codex App or IDE extension, restart the application to ensure the new server configuration is loaded.

Authenticating Your Tools​

  1. In your Codex interface (App, CLI, or IDE), submit a prompt that requires access to a company application.
  2. When prompted by Codex, click or follow the link to authenticate. You will be redirected to the JumpCloud authorization page in your web browser.
  3. Review the list of available applications and select the checkbox next to each one you want to access.
  4. Authenticate to the selected tools via OAuth or by entering your API token (click the documentation link provided in the UI if you need help finding your API token).
  5. Once all required tools display a green Connected status, click Authorize tools at the bottom of the page.
  6. Return to Codex. Your AI client can now use the tools authorized through the gateway.

Was this information helpful?