Skip to content
English
www.systemHUB.com
  • There are no suggestions because the search field is empty.

Connecting systemHUB to Claude (AI Gateway / MCP)

Learn how to connect your systemHUB account to Claude using the AI Gateway, so you can query your systems, policies, and training content directly from your AI assistant.

 


🔑 Before You Begin

  • You need AI Gateway access. If you don't see Settings → AI Gateway, ask your systemHUB admin to switch it on for your role (see Troubleshooting). 
  • 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.
  • Using ChatGPT? Click here for ChatGPT 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. 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 role doesn't have AI access switched on yet. Ask your systemHUB admin to enable it for your role in Permissions. If you are the admin and still can't see it, email support@systemology.com.
  • "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.
  • 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.