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. Grain 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 Grain consent screen in your browser.5. Authorize the workspace
Pick the workspace that ChatGPT will see, read the three scope rows, and click Authorize. 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 Grain, 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 Grain surprise hints (concentration, volatility, rank changes).
The “surprising” bullets come from the data, not from a guess. Read Tools
for every tool.