Skip to main content
Claude connects to Onyx from Anthropic’s cloud, not from your computer. Your Onyx MCP URL must be reachable from the internet, not only through a VPN.

Add the Onyx connector

1

Open Add custom connector

Open Customize > Connectors and select + Add > Add custom connector.Claude Customize page on the Connectors tab with the Add menu open and Add custom connector shown.
2

Enter the Onyx MCP URL

Name the connector Onyx, enter your Onyx MCP URL, and select Continue.Add custom connector dialog with the name Onyx and an Onyx MCP server URL, and the Continue button.If Claude says a connector with this URL already exists in your organization, close the dialog and go to Sign in to Onyx.
3

Keep the detected sign-in settings

Keep Sign in now and Use Claude’s published identity, which Claude marks Detected. Select Add.Add custom connector authentication settings with Sign in now and Use Claude's published identity selected and marked Detected.
4

Sign in to Onyx

Sign in and select Allow access. If the sign-in does not open, select Connect for Onyx under Customize > Connectors > Yours. A check mark in Status shows that Onyx is connected.Claude Connectors list on the Yours tab with the custom Onyx connector authorized as Individual and a check mark in Status.
5

Check that Onyx is on

In the message box, select + > Connectors and check that Onyx is on. Then send the test prompt.Claude message box with the + menu open on Connectors and the Onyx connector toggle turned on.

Add Onyx for an organization

An organization owner can add Onyx one time for all members.
1

Open Add custom connector

Open Organization settings > Connectors and select Add > Custom > Web.Claude Organization settings Connectors page with the Add menu open on Custom and the Web option shown.
2

Enter the Onyx MCP URL

Name the connector Onyx, enter your Onyx MCP URL, and select Continue.Organization Add custom connector dialog with the name Onyx, an Onyx MCP server URL, and the Continue button.
3

Keep the detected sign-in settings

Keep Sign in now and Use Claude’s published identity, as in the personal setup. Select Add.
Members then open Customize > Connectors, select Connect next to Onyx, and sign in with their own Onyx account.

Disconnect

Removing the connector in Claude does not revoke access. Revoke it in Onyx under Connected apps.