# OpenAI OpenAI Clients

Source: https://userguide.qualytics.io/using-the-platform/mcp/connecting-external-ai-clients/openai/

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](https://userguide.qualytics.io/using-the-platform/mcp/connecting-external-ai-clients/requirements/).

**Tab: ChatGPT**

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.

> **Info: 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.

> **Info: 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](https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt).

**Add the server**

1. In ChatGPT on the web, go to **Plugins**.
2. Select the **+** button, then **Add custom MCP server**.
3. Enter a name, such as `Qualytics`, and optionally a description.
4. Under **Connection**, enter your Qualytics MCP URL: `https://your-qualytics-instance.qualytics.io/api/mcp/`.
5. 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.
6. Read the risk warning and select **I understand and want to continue**.
7. Select **Create as a plugin**.
8. When ChatGPT opens the Qualytics authorization page, paste your Qualytics API token and approve the access.
9. 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.

**Tab: Codex**

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**

1. Open **Settings** and select **MCP servers**.
2. Select **Add server** and enter a name, such as `qualytics`.
3. Choose **Streamable HTTP** and enter your Qualytics MCP URL: `https://your-qualytics-instance.qualytics.io/api/mcp/`.
4. Save, then select **Restart**.
5. 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**

1. Register the server:

   ```bash
   codex mcp add qualytics --url https://your-qualytics-instance.qualytics.io/api/mcp/
   ```
2. Sign in:

   ```bash
   codex mcp login qualytics
   ```
3. On the Qualytics authorization page, paste your Qualytics API token and approve the access.
4. 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:

```toml
[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.

> **Info: Official Documentation**
>
> These steps follow OpenAI's guides for [custom MCP servers in ChatGPT](https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt) and [MCP in Codex](https://learn.chatgpt.com/docs/extend/mcp). If a menu or command in your version differs, check those pages.

If the connection fails, see [MCP Troubleshooting](https://userguide.qualytics.io/using-the-platform/mcp/troubleshooting/).

*Last updated: November 7, 2026.*