Connect ChatGPT to Knowi's MCP server. Once connected, you can query data, manage dashboards, export reports, and more - directly from ChatGPT conversations.
Prerequisites
- ChatGPT Pro, Plus, Business, Enterprise, or Education plan
- Knowi account with AI Agents enabled
Option A: OAuth Browser Auth (Recommended)
The easiest way to connect - no token copy/paste needed.
- In ChatGPT, click + in the message input area and select Connectors (or navigate to Settings > Connected apps).
- Click Add custom connector.
- Set the connector name to
Knowi. - Set the server URL to:
https://www.knowi.com/api/2.0/mcp - For authentication, select OAuth 2.0 (not Bearer Token).
- Click Save.
- When you first use the connector, ChatGPT will open your browser to sign in to Knowi and authorize access.
Instance URL: Use the URL that matches your Knowi deployment:
-
Knowi Cloud (default):
https://www.knowi.com -
EU Cloud:
https://eu.knowi.com -
On-Premise: Your on-premise Knowi URL (e.g.
https://knowi.yourcompany.com)
Option B: Manual Token
If OAuth doesn't work in your environment:
- Log into Knowi. Navigate to Settings > AI Settings.
- Under MCP Token, select a token expiry and click Generate Token. Copy the token.
- In ChatGPT, click + > Connectors > Add custom connector.
- Set the connector name to
Knowi. - Set the server URL to:
https://www.knowi.com/api/2.0/mcp - For authentication, select Bearer Token and paste your MCP token.
- Click Save.
Verify
- Start a new ChatGPT conversation.
- Click + and enable the Knowi connector for this conversation.
- Ask:
"What Knowi tools are available?"
You should see the full list of Knowi tools.
Usage
With the Knowi connector enabled in a conversation, interact with Knowi using natural language:
"Show me my Knowi dashboards" "Ask Knowi: what were our top customers by revenue last month?" "Create a report in Knowi that runs every Monday"
ChatGPT will show you what tool it wants to call and ask for approval before executing data-modifying operations.
Important Notes
- You must enable the Knowi connector in each new conversation where you want to use it.
- ChatGPT MCP connector support requires a paid plan.
- The connector inherits the permissions of the Knowi user whose token you configured.
Troubleshooting
Connector not appearing
- Verify your ChatGPT plan supports connectors (Pro, Plus, Business, Enterprise, or Education).
- Try removing and re-adding the connector.
"Authentication failed"
- Your MCP token may have expired. Generate a new one from Settings > AI Settings > MCP Token.
- Edit the connector and update the bearer token.
Tool calls returning errors
- Verify the user has access to the requested resources in Knowi.
- Check that AI Agents is enabled for the account (Settings > AI Settings > AI Agents Access).
For full tool documentation, see MCP Server.