> ## 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.

# Claude

> Connect Claude Desktop and claude.ai to the Onyx MCP server as a custom connector.

> [!NOTE]
>
> 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.](https://mintcdn.com/danswer/olcV-Rakf8oxOJIm/assets/overview/onyx_anywhere/mcp/claude_add_custom_connector.webp?fit=max\&auto=format\&n=olcV-Rakf8oxOJIm\&q=85\&s=ba3571c236d166cd19d23d430c340a95)

**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.](https://mintcdn.com/danswer/olcV-Rakf8oxOJIm/assets/overview/onyx_anywhere/mcp/claude_connector_url.webp?fit=max\&auto=format\&n=olcV-Rakf8oxOJIm\&q=85\&s=1dc700096ba9a709f9b7644de3f90f73)

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.](https://mintcdn.com/danswer/olcV-Rakf8oxOJIm/assets/overview/onyx_anywhere/mcp/claude_auth_settings.webp?fit=max\&auto=format\&n=olcV-Rakf8oxOJIm\&q=85\&s=9f973e060ce7f669667b40d7c2560652)

**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.](https://mintcdn.com/danswer/olcV-Rakf8oxOJIm/assets/overview/onyx_anywhere/mcp/claude_connectors_yours.webp?fit=max\&auto=format\&n=olcV-Rakf8oxOJIm\&q=85\&s=639c850e14f295fbf38dc84ca50b01f2)

**5. Check that Onyx is on**

In the message box, select **+ > Connectors** and check that Onyx is on.
Then send the [test prompt](https://docs.onyx.app/overview/onyx_anywhere/mcp_server.md#test-the-connection).

![Claude message box with the + menu open on Connectors and the Onyx connector toggle turned on.](https://mintcdn.com/danswer/olcV-Rakf8oxOJIm/assets/overview/onyx_anywhere/mcp/claude_enable_in_chat.webp?fit=max\&auto=format\&n=olcV-Rakf8oxOJIm\&q=85\&s=c52e17d4f3e842cb19c8ab0df9136607)

## 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.](https://mintcdn.com/danswer/olcV-Rakf8oxOJIm/assets/overview/onyx_anywhere/mcp/claude_org_add_custom.webp?fit=max\&auto=format\&n=olcV-Rakf8oxOJIm\&q=85\&s=9f50dc5469f6f694979ca179bef62d66)

**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.](https://mintcdn.com/danswer/olcV-Rakf8oxOJIm/assets/overview/onyx_anywhere/mcp/claude_org_connector_url.webp?fit=max\&auto=format\&n=olcV-Rakf8oxOJIm\&q=85\&s=f65d5eecb980e042ebdca57163152519)

**3. Keep the detected sign-in settings**

Keep **Sign in now** and **Use Claude's published identity**, as in the [personal setup](#add-the-onyx-connector).
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](https://docs.onyx.app/overview/onyx_anywhere/mcp_server.md#manage-connected-apps).


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