1. Enable Developer Mode
In ChatGPT, open Settings → Apps & Connectors → Advanced settings and switch Developer Mode on. This unlocks the “Add custom connector” flow.2. Create a new connector
In the settings, go to Apps & Connectors → Add new connector. Some plans label it Connectors → Create.3. Fill in the connector details
You do not enter a client ID or a secret. GrainQL registers ChatGPT when it connects the first
time.
4. Trust and create
Select the I trust this application checkbox and click Create. ChatGPT opens the GrainQL consent screen in your browser.5. Authorize the workspace
Choose All workspaces in my account, or Select workspaces and tick the ones that ChatGPT will see. Read the three scope rows, and click Allow access. A workspace on the consent screen is a tenant. ChatGPT closes the browser tab and marks the connector as connected.6. Use it in a conversation
Open a new chat, click + (or the tools menu, depending on the ChatGPT version), enable GrainQL, and ask a question. For example, ask “What were my top 10 referrers last week, and which ones grew the most versus the week before?”. ChatGPT callsgrain_query_compare and
summarizes the result.
What the assistant can do
ChatGPT turns rows into a paragraph. These prompts work well:
The digest response includes the GrainQL surprise hints (concentration, volatility, rank changes).
The “surprising” bullets come from the data, not from a guess. Read Tools
for every tool.