> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onyx.app/llms.txt
> Use this file to discover all available pages before exploring further.

# ChatGPT

> Connect ChatGPT on the web and the ChatGPT desktop app to the Onyx MCP server.

## ChatGPT on the web

Your ChatGPT workspace must allow custom MCP servers.

**1. Open Add custom MCP server**

Open **Customize > Plugins** and select **Add > Add custom MCP server**.

![ChatGPT Plugins page with the Add menu open and Add custom MCP server shown.](https://mintcdn.com/danswer/olcV-Rakf8oxOJIm/assets/overview/onyx_anywhere/mcp/chatgpt_add_custom_mcp.webp?fit=max\&auto=format\&n=olcV-Rakf8oxOJIm\&q=85\&s=bdd2694e1935793d96a6edcb84db604c)

**2. Enter the Onyx MCP URL**

Enter **Onyx** as the **Name** and your Onyx MCP URL as the **Server URL**.
Keep **OAuth** as the **Authentication**.

![Add custom MCP server form with the name Onyx, an Onyx MCP server URL, OAuth authentication, and the I understand and want to continue checkbox selected.](https://mintcdn.com/danswer/olcV-Rakf8oxOJIm/assets/overview/onyx_anywhere/mcp/chatgpt_server_form.webp?fit=max\&auto=format\&n=olcV-Rakf8oxOJIm\&q=85\&s=bd6e22a8d072b5c2b1420915b8b426e6)

**3. Select Dynamic Client Registration**

Open **Advanced OAuth settings** and set **Registration method** to **Dynamic Client Registration (DCR)**.

![ChatGPT OAuth advanced settings with Registration method set to Dynamic Client Registration and read:search selected under Default scopes.](https://mintcdn.com/danswer/olcV-Rakf8oxOJIm/assets/overview/onyx_anywhere/mcp/chatgpt_oauth_dcr.webp?fit=max\&auto=format\&n=olcV-Rakf8oxOJIm\&q=85\&s=30b741230adee798559177c897ad95a9)

**4. Create the plugin and sign in**

Select **I understand and want to continue**, then **Create as a plugin**, then **Continue to Onyx**.
Sign in and select **Allow access**.

![ChatGPT Connect Onyx dialog with the Continue to Onyx button.](https://mintcdn.com/danswer/olcV-Rakf8oxOJIm/assets/overview/onyx_anywhere/mcp/chatgpt_connect_onyx.webp?fit=max\&auto=format\&n=olcV-Rakf8oxOJIm\&q=85\&s=0de41ba1b52c07d1dc1814bf737b1d7f)

Onyx then shows under **Installed** on the **Plugins** page.

![ChatGPT plugin page for Onyx with the Settings and Try in chat buttons.](https://mintcdn.com/danswer/olcV-Rakf8oxOJIm/assets/overview/onyx_anywhere/mcp/chatgpt_plugin_page.webp?fit=max\&auto=format\&n=olcV-Rakf8oxOJIm\&q=85\&s=fb33b09dc06ddc7d17f3ca3c20d4d512)

**5. Use Onyx in a chat**

Select **Try in chat**, or type `@Onyx` before your question in any chat.
Send the [test prompt](https://docs.onyx.app/overview/onyx_anywhere/mcp_server.md#test-the-connection) to check the connection.

![ChatGPT message box with @Onyx followed by a request to search for the onboarding guide.](https://mintcdn.com/danswer/olcV-Rakf8oxOJIm/assets/overview/onyx_anywhere/mcp/chatgpt_prompt.webp?fit=max\&auto=format\&n=olcV-Rakf8oxOJIm\&q=85\&s=22a5d0acba00f0866ec18484c3f84cfa)

To remove Onyx, open **Settings > Plugins**, select Onyx, and select **Delete app**.
Then revoke access in Onyx under [Connected apps](https://docs.onyx.app/overview/onyx_anywhere/mcp_server.md#manage-connected-apps).

## ChatGPT desktop

The desktop app shares `~/.codex/config.toml` with [Codex](https://docs.onyx.app/overview/onyx_anywhere/mcp_server/codex.md).
If you already added Onyx in Codex, it is already in the server list.

**1. Add the server**

Open **Settings > MCP servers** and select **Add server**. Name it **Onyx**, choose **Streamable HTTP**,
and enter your Onyx MCP URL.

**2. Restart and sign in**

Save and select **Restart**. Select **Authenticate** for Onyx, sign in, and select **Allow access**.

**3. Check the connection**

Enter `/mcp` to see connected servers.
Send the [test prompt](https://docs.onyx.app/overview/onyx_anywhere/mcp_server.md#test-the-connection).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.