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

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.omni.co/feedback

```json
{
  "path": "/ai/mcp/chatgpt",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Using the MCP Server in ChatGPT

> Connect your Omni data to ChatGPT with Omni's MCP Server.

ChatGPT supports MCP connections, allowing you to bring your Omni data directly into ChatGPT conversations. Once successfully connected, you can ask ChatGPT questions about your data and get answers powered by Omni.

## Requirements

<Note>
  Every person who wants to use the MCP Server must complete the setup.
</Note>

To follow the steps in this guide, you'll need:

* The following in ChatGPT:
  * **A plan that supports apps and connectors.** This includes Pro, Plus, Business, Enterprise, and Education plans.
  * **For manual OAuth or API key setup only**: [Developer mode](https://developers.openai.com/api/docs/guides/developer-mode/) enabled in ChatGPT. Toggle it on in **Settings > Apps > Advanced settings**.
* To have the following enabled in Omni:
  * **The MCP Server AI setting**. An Organization Admin can enable this setting by navigating to **Settings > AI > General**.
  * **Personal access tokens (PATs)**, which are required to use [OAuth to authenticate](/ai/mcp/authentication). An Organization Admin can activate them by going to [**Settings > API Keys > Personal tokens**](/api/authentication#personal-access-tokens-pat).

## Setup

Choose your setup method. See the [MCP authentication guide](/ai/mcp/authentication) if you need help selecting a method.

<Tabs>
  <Tab title="ChatGPT App (Recommended)">
    The official Omni Analytics app for ChatGPT provides the fastest setup experience with no manual configuration required.

    <Steps>
      <Step title="Install the app">
        Visit the [Omni Analytics ChatGPT app](https://chatgpt.com/apps/omni-analytics/asdk_app_694e8b8715108191a49fe2db4398d9e2) page and click **Add** to install the app.
      </Step>

      <Step title="Authorize the connection">
        1. ChatGPT will redirect you to an Omni authorization page.
        2. Review the requested permissions and click **Authorize**.

        Omni will automatically create a [Personal access token](/api/authentication#personal-access-tokens-pat) and link it to your Omni user account.
      </Step>

      <Step title="Verify the connection">
        At this point, you should be able to use the Omni MCP server in your ChatGPT conversations.

        In a new chat, click the <Icon icon="plus" iconType="solid" /> (plus) icon, then select the Omni connector to enable it.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Custom OAuth">
    OAuth provides streamlined setup without manually managing API keys. Use this method if you need to configure the connector manually using developer mode.

    <Steps>
      <Step title="Open connector settings">
        In ChatGPT, navigate to **Settings > Apps & Connectors**.
      </Step>

      <Step title="Create a new connector">
        Click **Create** next to **Advanced settings**.
      </Step>

      <Step title="Configure the connector">
        Fill in the following fields:

        * **Connector name** — Enter a name, such as `Omni`
        * **Description** — Enter a description, such as `Connect to Omni analytics data`
        * **Server URL** — Paste the following URL:

          ```
          https://callbacks.omniapp.co/callback/mcp
          ```

        Click **Add** to create the connector.
      </Step>

      <Step title="Authorize the connection">
        1. ChatGPT will redirect you to an Omni authorization page.
        2. Review the requested permissions and click **Authorize**.

        Omni will automatically create a [Personal access token](/api/authentication#personal-access-tokens-pat) and link it to your Omni user account.
      </Step>

      <Step title="Verify the connection">
        At this point, you should be able to use the Omni MCP server in your ChatGPT conversations.

        In a new chat, click the <Icon icon="plus" iconType="solid" /> (plus) icon, then select the Omni connector to enable it.
      </Step>
    </Steps>
  </Tab>

  <Tab title="API Key">
    API key authentication gives you direct control over key management.

    <Steps>
      <Step title="Create an API key">
        If you don't have an Omni API key, [create one](/api/authentication) before continuing.
      </Step>

      <Step title="Open connector settings">
        In ChatGPT, navigate to **Settings > Apps & Connectors**.
      </Step>

      <Step title="Create a new connector">
        Click **Create** next to **Advanced settings**.
      </Step>

      <Step title="Configure the connector">
        Fill in the following fields:

        * **Connector name** — Enter a name, such as `Omni`
        * **Description** — Enter a description, such as `Connect to Omni analytics data`
        * **Server URL** — Enter your instance URL:

          ```
          https://<YOUR_OMNI_INSTANCE>/mcp/https
          ```

        Replace `<YOUR_OMNI_INSTANCE>` with your Omni URL (e.g., `acme.omniapp.co`).
      </Step>

      <Step title="Configure authentication">
        Set the authentication method to **Bearer token** and enter your [Omni API key](/api/authentication).
      </Step>

      <Step title="Verify the connection">
        In a new chat, click the <Icon icon="plus" iconType="solid" /> (plus) icon, then select the Omni connector. Ask a question about your data to confirm the connection is working.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Using the MCP

Once the MCP Server is connected, you can use it in any ChatGPT conversation by enabling the connector.

<Steps>
  <Step>
    Open a new chat and click the <Icon icon="plus" iconType="solid" /> (plus) icon to select apps. Enable the Omni connector.
  </Step>

  <Step>
    Enter a prompt, such as `Hey Omni, tell me how many users have been sourced by search and email`.
  </Step>

  <Step>
    ChatGPT may prompt you to approve tool usage for actions that modify data. Click **Allow** to proceed.
  </Step>

  <Step>
    The MCP Server will pick a model (if not configured) and topic, then run a query to retrieve the data.
  </Step>
</Steps>