OpenAI Clients¶

Connect ChatGPT and Codex to the Qualytics MCP server. Before you start, have a Personal API Token and your Qualytics MCP server URL ready. See External AI Client Requirements.

ChatGPTCodex

ChatGPT adds the Qualytics MCP server as a custom MCP server from Plugins. Custom MCP servers are available on ChatGPT on the web only, not in the mobile apps.

What your ChatGPT plan allows

Business: only workspace admins and owners can add a custom MCP server and publish it for the workspace.
Enterprise and Edu: admins and owners can add one, and admins can let selected members add one too. Only admins and owners can publish it for the workspace.
Pro: you can add a custom MCP server, but only with read access. Qualytics tools that change data, such as creating a check or running an operation, are not available.

Your Qualytics instance must be reachable from the internet

ChatGPT connects to MCP servers from OpenAI's cloud, not from your computer. If your Qualytics instance is only reachable inside a private network, OpenAI offers a Secure MCP Tunnel. See the official documentation.

Add the server

In ChatGPT on the web, go to Plugins.
Select the + button, then Add custom MCP server.
Enter a name, such as Qualytics, and optionally a description.
Under Connection, enter your Qualytics MCP URL: https://your-qualytics-instance.qualytics.io/api/mcp/.
For authentication, choose OAuth. Leave the OAuth client ID and secret empty, so ChatGPT registers its own client with Qualytics. A fixed client ID is rejected.
Read the risk warning and select I understand and want to continue.
Select Create as a plugin.
When ChatGPT opens the Qualytics authorization page, paste your Qualytics API token and approve the access.
Review the Qualytics tools ChatGPT discovered, then install the plugin.

Use Qualytics in a chat

Start a new conversation, type @ in the prompt box, and select the Qualytics plugin. The selection applies to that message, so mention the plugin again when a follow-up needs new data from Qualytics. ChatGPT asks you to confirm actions that change data before it runs them.

Make it available to your workspace

On Business, Enterprise, and Edu plans, an admin or owner publishes the server for everyone. In the Admin Console, select the workspace, open Plugins, select Manage Legacy Apps, then go to Drafts and select Publish. Each member still authorizes with their own Qualytics API token.

The Codex desktop app, the Codex CLI, and the Codex IDE extension share one MCP configuration, so you add the Qualytics server once and use it in all three.

In the Codex desktop app

Open Settings and select MCP servers.
Select Add server and enter a name, such as qualytics.
Choose Streamable HTTP and enter your Qualytics MCP URL: https://your-qualytics-instance.qualytics.io/api/mcp/.
Save, then select Restart.
Select Authenticate. On the Qualytics authorization page, paste your Qualytics API token and approve the access.

In the Codex IDE extension, open the gear menu, select MCP servers, and follow the same steps. After saving, select Restart extension.

From the Codex CLI

Register the server:

codex mcp add qualytics --url https://your-qualytics-instance.qualytics.io/api/mcp/

Sign in:
```
codex mcp login qualytics
```
On the Qualytics authorization page, paste your Qualytics API token and approve the access.
Run codex mcp list, or /mcp inside Codex, to confirm the server is connected.

The command saves the server in ~/.codex/config.toml, where you can also add it by hand:

[mcp_servers.qualytics]
url = "https://your-qualytics-instance.qualytics.io/api/mcp/"

Leave bearer_token_env_var unset. Qualytics does not accept an API token as the MCP bearer token, and Codex refreshes the MCP access token on its own.

Official Documentation

These steps follow OpenAI's guides for custom MCP servers in ChatGPT and MCP in Codex. If a menu or command in your version differs, check those pages.

If the connection fails, see MCP Troubleshooting.