Skip to main content

ChatGPT

Overview​

Here's what you'll do to connect ChatGPT to Holistics:

  • Turn on MCP Server: A one-time step in your Holistics workspace, done by an admin. If it's already on, skip ahead.
  • Get your connection URL: Choose the environment you want to work with:
    • Reporting: Published Holistics objects (those on the Reporting tab).
    • Development: Unpublished Holistics objects in your current AMQL project branch (those on the Development tab).
  • Connect ChatGPT: ChatGPT connects via OAuth (you log in with your Holistics account, no API key needed).
  • Install Holistics skills: add the Holistics plugins so ChatGPT knows how to work with Holistics.

Step 1: Turn on MCP Server​

This is a one-time setup done by a workspace admin. Go to AI Settings and enable both Holistics AI and the MCP Server.

ai-mcp-setting

Step 2: Get your connection URL​

Your connection URL depends on your data center region and the Holistics environment you want your AI to work with.

Select your data region

Select your working environment

Let your AI work with published Holistics objects — those on the Reporting tab.

Get your connection url

https://mcp-apac.holistics.io/reporting/mcp


URL format
https://mcp-<REGION>.holistics.io/<ENV>/mcp
  • <REGION>: Choose based on your data center: apac, eu, or us
  • <ENV>:
    • reporting (default): Let your AI work with published Holistics objects (i.e. objects on your Holistics Reporting tab)
    • development: Let your AI work with unpublished Holistics objects in your current AMQL project branch (i.e. objects on your Holistics Development tab)

Step 3: Connect​

  1. Open Settings > Apps, then click Advanced settings at the bottom.
  2. Toggle Developer mode on.
Developer mode toggle in ChatGPT settings
  1. Click Create app. Enter a name, your connection URL from Step 2, and select OAuth as the authentication method.
Create app dialog in ChatGPT with OAuth selection
  1. Click Save — the app appears under Drafts in Settings > Apps.

To use it in a chat, click + in the composer > More > Developer mode, then select your app.

Step 4: Install Holistics skills​

Holistics skills teach ChatGPT how to work with Holistics, such as exploring datasets and writing AQL. Installing them in ChatGPT requires a Business, Enterprise, Healthcare, or Edu workspace.

  1. Workspace admin: go to Admin console, select your workspace, and open Plugins. Select Add → Import marketplace, enter https://github.com/holistics/skills in Source (leave Path and Branch empty), and select Import marketplace. Then set each Holistics plugin's installation policy to Available or Installed.
  2. Members: if a plugin is set to Available, go to Plugins, open it under Your workspace, and select Install plugin.

If your workspace can't import marketplaces, upload individual skills instead: download them from holistics/skills (plugins/holistics-development/skills/ to develop your AMQL project, or plugins/holistics-reporting/skills/ to ask data questions), then go to Plugins → Skills tab → Create → Upload from your computer.

For more details, see OpenAI's guides: Importing and syncing plugin marketplaces from GitHub and Skills in ChatGPT.

Need more help?​

See the MCP FAQ for questions about permissions, data access, and security.

Open Markdown
Let us know what you think about this document :)