Skip to main content

ChatGPT

ChatGPT connects via OAuth — no API key needed.

Step 1: Enable 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: Connect ChatGPT to Holistics MCP Server​

  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 — obtain it from Step 3 — 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 3: Obtain 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)

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 :)