Connecting systemHUB to Claude (AI Gateway / MCP)

💡 [VIDEO TO COME - Connecting systemHUB to Claude]

🔑 Before You Begin

• You need AI Gateway access on your account. If you do not see Settings -> AI Gateway, email support@systemology.com to find out if it's available in your account. 
• 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.

🧭 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. If you have generated one before, click Update to replace it, then copy the long token string.

🔌 Step 2 — Add the connector in Claude

1. In Claude, open Settings -> Connectors.
2. Click Add custom connector.
3. Name it systemHUB.
4. Paste the Connector URL from Step 1 (double-check it is exact).
5. Paste the OAuth Client ID and the token you generated.
6. Click Add. The connector is added but not yet connected.
   

✅ Step 3 — Connect and approve

1. Click Connect on the systemHUB connector.
2. When prompted, enter your company alias, this is your subdomain, all lowercase with no spaces (e.g. acme, not "Acme" or "My Company").
3. Log in with your systemHUB credentials and click Approve.
4. Claude redirects back and shows the connector as Connected.

🧪 Step 4 — Test the connection

Start a new chat and ask:

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

Claude 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 account does not have access yet. Email support@systemology.com.
• Connector adds but will not connect
  • Remove it and re-add with a freshly generated token.

🎉 You're All Set!

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