Connecting systemHUB to ChatGPT (AI Gateway / MCP)

🤖 Connecting Via ChatGPT

🔑 Before You Begin

• You need AI Gateway access. If you don't see Settings → AI Gateway, email support@systemology.com and we'll switch it on for your role (admin seats have it by default).
• Have your systemHUB login handy, you will approve the connection at the end.
• Treat the token you generate like a password. Do not share it.
• Use Claude? Click here for Claude connection instructions. 

🧭 Step 1 — Get your connection details from systemHUB

1. Log in to systemHUB.
2. Go to Settings -> AI Gateway.
3. Copy the Connector URL exactly as shown (a wrong character here is the #1 cause of failures).
4. Note your OAuth Client ID and your company alias, both are your account subdomain (the part before .systemhub.com). Example: if you log in at acme.systemhub.com, your alias is acme.
5. Click Generate to create a token and copy the long token string. ⚠️ If you already have one, only click Update if you need to. It revokes your old token and disconnects any AI you connected with it, including Claude.

🔌 Step 2 — Add the connector in ChatGPT

1. Turn on Developer Mode, then create the app. Where you do that depends on your ChatGPT plan:

   
   1. Plus / Pro: Settings → Apps → Advanced Settings → turn on Developer Mode → Create
   2. Business: you must be a workspace admin. Workspace Settings → Apps → Create
   3. Enterprise / EDU: you must be a workspace admin. Settings → Apps → Advanced Settings → Create
2. A new window pops up where you enter in your systemHUB details from Step 1.
   1. Name it systemHUB.
   2. Paste the Connector URL from Step 1 (double-check it is exact).
   3. Under Authentication, click OAuth and the window will expand with more fields to complete
   4. Paste your OAuth Client ID in the OAuth Client ID field
   5. Paste the token you generated into the OAuth Client Secret field
   6. Tick "I understand and want to continue"
3. Click Create. 

✅ Step 3 — Connect and approve

1. A new window will now appear for you to sign into systemHUB
2. When prompted, enter your company alias, this is the same as your OAuth ID and your subdomain, all lowercase with no spaces (e.g. acme, not "Acme" or "My Company"), then click Continue
3. Log in with your systemHUB credentials and click Approve Connection
4. ChatGPT should now redirect back and shows the systemHUB app as Connected

🧪 Step 4 — Test the connection

1. Start a new WORK chat and select systemHUB from the plugins list underneath the chat box:

   

2. Then ask: "Can you check the folder tree and tell me what main root-level folders I have in my systemHUB account?"

3. ChatGPT will load the tool and return your folders, which confirms it is working!

🛠️ Troubleshooting

• "Invalid or expired client ID"
  • This is almost always the company alias or the token.
  • Check the alias is your exact subdomain, lowercase, no spaces (acme, not "Acme" or your company name).
  • Your token may have expired or been regenerated, so go back to Settings -> AI Gateway, generate a fresh token, and update it in the connector.
  • Confirm the Connector URL was pasted exactly.
• No "AI Gateway" option under Settings
  
  • Your role doesn't have AI access switched on yet. Only systemHUB support can enable it for Editor, Contributor and Reader roles, so email support@systemology.com and tell us which roles. Once it's on, each person's AI gets exactly their own seat's permissions: a Reader's AI can read but can't change anything.
• "No active agent token found" when approving
  • You haven't generated your own token yet. Each person needs their own. Generate one in Settings → AI Gateway, then approve again.
• ChatGPT says Connected but no tools show up
  • The approve step wasn't finished. Reconnect, sign in to systemHUB and click Approve Connection.
• Connector adds but will not connect
  • Remove it and re-add with a freshly generated token.

🎉 You're All Set!

ChatGPT can now read your systemHUB content. Try asking it to summarise a system, find a policy, or list what is in a folder.