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

# Connect an MCP client to Qobra

> Prerequisites, the OAuth consent flow, and adding the MCP server to Claude, ChatGPT or Dust

## Prerequisites

<Steps>
  <Step title="MCP enabled for your company">
    The server is gated by a per-company feature flag (`MCP`). Ask the Qobra
    team to enable it for your workspace before connecting.
  </Step>

  <Step title="A Qobra account">
    You authenticate as yourself. The tools only ever return data your Qobra
    user is allowed to see — the same role-based permissions as the app.
  </Step>
</Steps>

## Server URL

The server speaks **Streamable HTTP** and is available at `https://mcp.qobra.co/mcp`.

There is **no API key**. Every client authenticates through the same OAuth 2.1
flow described in [Authorize](#authorize-oauth-consent) below — you only ever
paste the server URL, never a secret.

## Add the server to your client

<Tabs>
  <Tab title="Claude">
    Open **Settings → Connectors → Add custom connector**, give it a name (e.g.
    `Qobra`) and paste the server URL (`https://mcp.qobra.co/mcp`). Leave the
    Advanced settings (OAuth Client ID / Secret) empty.

    <img src="https://mintcdn.com/qobra/hNHTZGdw7eCKFz01/mcp_documentation/images/claude_add_custom_connector.png?fit=max&auto=format&n=hNHTZGdw7eCKFz01&q=85&s=92774a80a23f8e6687d5453329269c77" alt="Adding the Qobra MCP server as a custom connector in Claude" width="420" data-path="mcp_documentation/images/claude_add_custom_connector.png" />
  </Tab>

  <Tab title="ChatGPT">
    Custom MCP connectors live behind **Developer mode**, available on
    **ChatGPT Plus, Pro, Business, Enterprise and Edu** plans. Open
    **Settings → Connectors → Advanced** (`chatgpt.com/apps#settings/Connectors/Advanced`)
    and click **Create** to open the **New App** dialog.

    <Steps>
      <Step title="Name the connector">
        Enter a **Name** (e.g. `Qobra`). The icon and description are optional.
      </Step>

      <Step title="Point it at the server">
        Under **Connection**, keep **Server URL** selected and paste
        `https://mcp.qobra.co/mcp`.
      </Step>

      <Step title="Choose OAuth">
        Set **Authentication** to **OAuth**. You can leave the **Advanced OAuth
        settings** as discovered — the server registers the client automatically.
      </Step>

      <Step title="Acknowledge & create">
        Tick **I understand and want to continue** (the standard warning for any
        custom MCP server), then click **Create**.
      </Step>
    </Steps>

    <img src="https://mintcdn.com/qobra/vC7wisWRDOUJb7G8/mcp_documentation/images/chatgpt_add_custom_connector.png?fit=max&auto=format&n=vC7wisWRDOUJb7G8&q=85&s=efc90755feca9e318b5f9d65fb32b023" alt="Adding the Qobra MCP server as a custom connector in ChatGPT" width="320" data-path="mcp_documentation/images/chatgpt_add_custom_connector.png" />
  </Tab>

  <Tab title="Dust">
    Add Qobra as a **remote MCP server** from a Dust space. Open your space's
    **Tools** (the *Actions* category), then **Add MCP Server** to open the
    **Configure MCP Server** dialog.

    <Steps>
      <Step title="Point it at the server">
        In **URL**, paste `https://mcp.qobra.co/mcp`.
      </Step>

      <Step title="Leave authentication on Automatic">
        Keep **Authentication** set to **Automatic**. Dust discovers that the
        server requires OAuth and uses dynamic client registration to obtain the
        credentials. Leave **Use custom headers** off.
      </Step>

      <Step title="Save & use it in an agent">
        Click **Save**, complete the OAuth consent, then add the Qobra tools to
        an agent so it can query your Qobra data.
      </Step>
    </Steps>

    <img src="https://mintcdn.com/qobra/vC7wisWRDOUJb7G8/mcp_documentation/images/dust_add_mcp_server.png?fit=max&auto=format&n=vC7wisWRDOUJb7G8&q=85&s=bf62f6db1689edfdc60bcf0a28f747ce" alt="Adding the Qobra MCP server as a remote MCP server in Dust" width="520" data-path="mcp_documentation/images/dust_add_mcp_server.png" />
  </Tab>
</Tabs>

## Authorize (OAuth consent)

The server is protected by **OAuth 2.1 + PKCE** — there is no API key to copy.
The flow is identical for every client (Claude, ChatGPT, Dust). On first use:

<Steps>
  <Step title="Discovery & registration">
    The client discovers the server's OAuth metadata and registers itself
    automatically.
  </Step>

  <Step title="Consent in your browser">
    The client opens the Qobra consent screen in your browser. Log in to Qobra
    as usual (SSO / MFA included) and click **Authorize**.
  </Step>

  <Step title="Connected">
    The client receives a short-lived token and the Qobra tools appear in its
    toolbox. Tokens are scoped to your user and company, and can be revoked.
  </Step>
</Steps>