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

# ChatGPT

> Connect ChatGPT to CloudQuant Data Liberator with the MCP connector and OAuth authentication

# Connecting Liberator to ChatGPT

Use ChatGPT's MCP connector with **OAuth** to query CloudQuant Data Liberator from a ChatGPT workspace. Each user authenticates with their own Liberator credentials, so data access follows individual entitlements rather than a shared API key.

## Prerequisites

* Access through [app.cloudquant.ai](https://app.cloudquant.ai) — ChatGPT MCP setup for Liberator is done from that CloudQuant environment.
* A **ChatGPT Pro or Plus** account — the MCP connector is only available on paid tiers.
* **Developer tool access** enabled in ChatGPT (required before you can create custom Apps). Enable it under **Settings**.
* A CloudQuant Data Liberator account with valid username and password.
* The **Liberator MCP Endpoint URL** from the Liberator UI (for example, `https://api.cloudquant.ai/mcp`).

<Note>
  OAuth is the recommended authentication method. Each user who connects through the ChatGPT app authenticates with their own Liberator credentials, so entitlements stay per-user.
</Note>

## Setup steps

<Steps>
  <Step title="Open ChatGPT Settings">
    In ChatGPT, click your workspace or profile name in the lower-left corner, then select **Settings**.
  </Step>

  <Step title="Create an App under Advanced settings">
    In Settings, open the **Advanced** section, click **Apps**, then click **Create App**.
  </Step>

  <Step title="Fill in the app details">
    In the New App dialog, set:

    | Field           | Value                                                                                           |
    | --------------- | ----------------------------------------------------------------------------------------------- |
    | **Name**        | `CloudQuant Liberator`                                                                          |
    | **Description** | `MCP Connector for CloudQuant Data Liberator`                                                   |
    | **Connection**  | Select **Server URL** (not Tunnel). Enter the Liberator MCP Endpoint URL from the Liberator UI. |

    Example MCP Endpoint URL:

    ```text theme={null}
    https://api.cloudquant.ai/mcp
    ```

    Copy the exact URL from your Liberator UI if your environment differs.
  </Step>

  <Step title="Set authentication to OAuth">
    Under **Authentication**, select **OAuth**. This is the recommended method for Liberator and keeps access tied to each user's credentials.
  </Step>

  <Step title="Accept the custom MCP warning and create">
    ChatGPT shows a warning that custom MCP servers introduce risk. Check **I understand and want to continue**, then click **Create**. The Create button stays inactive until you acknowledge the warning.
  </Step>

  <Step title="Authenticate and grant access">
    ChatGPT starts the OAuth flow and shows a **Grant Access to ChatGPT** screen. Approve access for:

    * User profile
    * `openid`
    * User roles
    * Email address
    * `groups`

    Click **Yes** to grant access so ChatGPT can authenticate to the Liberator MCP server on your behalf.
  </Step>
</Steps>

<Tip>
  Once access is granted, the CloudQuant Liberator MCP connector is ready to use in your ChatGPT workspace.
</Tip>

## Using the connector

After the app is created, Liberator MCP tools are available in ChatGPT conversations:

| Tool                 | Purpose                                           |
| -------------------- | ------------------------------------------------- |
| `list_datasets`      | List available Liberator datasets                 |
| `get_dataset_config` | Fetch configuration and schema for a dataset      |
| `query_dataset`      | Query a Liberator dataset by name with parameters |

<Note>
  Because OAuth is used, each user who interacts with the connector is prompted to authenticate with their own CloudQuant credentials. Individual data access and entitlements apply — no shared API keys are required.
</Note>

## Related

<CardGroup cols={2}>
  <Card title="Microsoft Copilot Studio" icon="microsoft" href="/integrations/copilot">
    Add Liberator as an MCP tool in a Copilot Studio agent
  </Card>

  <Card title="Claude Desktop" icon="sparkles" href="/integrations/claude">
    Install the Liberator .mcpb extension in Claude Desktop
  </Card>

  <Card title="What's new in 2.3" icon="rocket" href="/whats-new/liberator-2.3">
    Liberator 2.3 release notes, including AI-driven reporting
  </Card>

  <Card title="Grafana integration" icon="chart-line" href="/integrations/grafana">
    Connect Liberator metrics to Grafana with a Bearer token
  </Card>
</CardGroup>