Skip to main content

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.
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.
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.
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.Onyx then shows under Installed on the Plugins page.ChatGPT plugin page for Onyx with the Settings and Try in chat buttons.
5

Use Onyx in a chat

Select Try in chat, or type @Onyx before your question in any chat. Send the test prompt to check the connection.ChatGPT message box with @Onyx followed by a request to search for the onboarding guide.
To remove Onyx, open Settings > Plugins, select Onyx, and select Delete app. Then revoke access in Onyx under Connected apps.

ChatGPT desktop

The desktop app shares ~/.codex/config.toml with Codex. 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.