Getting connected
Published Updated
Everything about connecting an AI assistant to the HubPeople MCP: the address, the sign-in, what to do when it stops working, and the technical detail if you are wiring up something other than Claude. If you would rather hand this page to your assistant and let it do the work, it is written to be read that way.
Coming back to this page? The Changelog at the bottom records what has changed and when.
https://mcp.hubpeople.ai/mcp, sign in with the HubPeople account you already have, and approve it. There is nothing to generate, paste or store.The server
One address, one scope, one sign-in. These are the only values you need, whichever assistant you are connecting.
| What | Value |
|---|---|
| MCP endpoint | https://mcp.hubpeople.ai/mcp |
| Transport | Streamable HTTP. Send POST with Accept: application/json, text/event-stream. |
| Authentication | OAuth 2.1. Bearer token in the Authorization header. |
| Scope | mcp |
| Who you sign in as | Your ordinary HubPeople portal login. You see exactly the brands that account can already see. |
Connecting Claude
The connection belongs to your Claude account, not to a device. Add it once and every place you sign in to Claude has it.
On the website or in the desktop app
- Open Settings, then Connectors. In the desktop app you can also click
+beside the message box, then Connectors, then Manage connectors. - Choose Add custom connector.
- Name it HubPeople. The name is only a label in your own list, but using the same one keeps these guides matching what you see.
- Put
https://mcp.hubpeople.ai/mcpin the server address field and continue. - Leave every remaining field exactly as it arrives. They are filled in from our server and there is nothing you need to change.
- Sign in with your HubPeople account when the browser opens, and approve the access.
This route is identical on a Mac and on Windows.
Tool permissions
Out of the box every single request asks your permission first. The tools are labelled, so you can wave through the ones that only look at things and stay asked about the ones that change something.
In the connector's permissions, set the read-only tools to Always allow and leave the rest. Nothing in that group can change a page.
Connecting another agent
Nothing about this server is specific to Claude. It implements the MCP authorization spec, so any client that does too can connect itself without us issuing you anything. For most of them the only thing you have to provide is the address at the top of this page.
What a compliant client does
- Calls the endpoint with no token and gets
401with aWWW-Authenticate: Bearerchallenge naming the resource metadata document. - Reads the protected resource metadata to find the authorization server.
- Reads the authorization server metadata to find where to register itself and where to send you to sign in.
- Registers itself at the registration endpoint. Dynamic client registration is open, so there is no client id to request from us and no secret to keep.
- Runs an authorization code flow with PKCE. You sign in and approve in a browser, and it exchanges the code for a token.
- Sends that token as a bearer header, and refreshes it when it expires.
What your client needs from you
- The address, and nothing else. The server publishes its OAuth metadata at the standard well-known addresses, so a client that follows the spec reads its own configuration from there. You should not have to paste endpoints in by hand, and you should not hard code them: if we ever move them, a client that discovers them follows, and one that has them written down breaks.
- There is no client id to ask us for and no secret to keep. Registration is open, so your client registers itself the first time it connects. If a set of instructions tells you to email us for credentials, it is not describing this server.
- PKCE has to be S256. A client offering only a plain challenge is refused, and the failure is not always reported clearly at the other end.
Redirect addresses, including loopback
A command line tool or a desktop agent has no website to come back to, so it listens on a port on your own machine and uses that as its redirect. The server accepts loopback redirects, which is what makes those clients possible at all.
| Redirect | Accepted |
|---|---|
A loopback address, for example http://127.0.0.1:PORT/callback. Both of the usual written forms of the loopback host are accepted. | Yes, on any port. |
An https address you control | Yes, given at registration. |
| Anything carrying a fragment | No. Refused when the client registers. |
http is allowed for loopback only. That is the standard exception, because the request never leaves your machine. Every other redirect has to be https.Which tools work today
| Client | Where it stands |
|---|---|
| Claude on the website and in the desktop app | Verified. Used daily, on more than one account. |
| The Claude phone apps | The connection works there once it is on your account. |
| Claude Code and other command line agents | The loopback route is open and registration works, so there is nothing standing in the way. A full sign-in has not been walked by us yet. |
| Cursor, Codex, Gemini CLI and other MCP clients | Untested. They should work if they follow the spec. Tell us how you get on and we will write it up. |
As each one is confirmed, its own steps get added to this page, and the change is recorded in the Changelog at the bottom.
When it stops working
| What you see | What it is |
|---|---|
| The assistant has no HubPeople tools at all. | The connector is not added, or the sign-in behind it has lapsed. Open your connector settings: a lapsed one shows a Reconnect button where a working one has a tick. |
| The tools were there yesterday and have quietly gone. | The sign-in expired. This one is worth knowing because nothing tells you: the connector goes silent rather than asking you to sign in again. Open your connector settings on the Claude website, press Reconnect on the HubPeople row and sign in again; every device gets it back. If there is no Reconnect button, remove the connector and add it again. |
| There is no way to add a connector at all. | Your Claude plan. See the limits below. |
| It is connected, but this one conversation cannot see it. | Connectors can be switched off per conversation. Click + beside the message box, then Connectors, and check the HubPeople switch is on. |
| It works in one folder and not another. | A folder with its own MCP settings takes priority over the connector on your account. Older toolkit folders shipped such a file; versions from v0.70.0 onward do not, but a folder upgraded from an older one keeps the file it already had. Delete it and reopen the folder. |
| Something asks you for a token or an API key. | You are following older instructions. There is no token. If a set of steps tells you to generate one, it is out of date. |
| You want to know whether the server itself is reachable. | Fetch /.well-known/oauth-authorization-server on the MCP host. JSON and a 200 means the server is up and answering, and the problem is on the client side. |
| A long run stops part way with a rate-limit message. | Tools are limited per minute, and the limit differs from tool to tool. It resets within a minute, so wait a moment and carry on; nothing is lost. |
Limits and rules
- On the Claude Free plan you get one custom connector. If you already have one, you will have to remove it or move to a paid plan.
- On a Team or Enterprise plan, only an organisation Owner can add a connector. If there is no way to add one in your settings, that is why. Ask your Owner to add it once for the organisation.
- On a shared computer, sign out of HubPeople first. A sign-in can be reused for a while in the same browser, so on a machine other people use you could end up joined to whoever signed in before you.
- You see exactly what your HubPeople account sees. The connection carries your own permissions. It cannot reach a brand you could not already open in the portal.
- We do not issue access tokens to partners. Signing in through your assistant is the only route, and it is the one we support. Anything asking you to paste a key is not us.
- To disconnect, remove the connector in your Claude settings. That discards the tokens the client is holding. Reviewing and ending sessions from the HubPeople portal is not built yet, so if you are ever unsure, remove the connector and add it again.
Installing the toolkit
Optional, and separate from the connection above. The connection lets your assistant see and change your brands; the toolkit carries the guidance it follows while it works on them, so building, auditing and migrating pages is more capable with it than without. It is one download from our public GitHub release, the same for every brand, and not the per-brand zip you generate in the portal.
The steps, the prompt and what to do when it does not load are in setting up the toolkit.
Where next
Once you are connected, the start page shows what to do with it.
Connect your brands to AI: the three steps →
The toolkit: setup and first run →
Tell us what you think
This is a beta, and connection problems are the ones we most want to hear about. If something here did not match what you saw, tell us and we will fix the page.
Changelog
| Release | Changes |
|---|---|
| 15 September 2026 | Added Installing the toolkit. The page described the toolkit and linked its guide but never said where it comes from, so an assistant asked how to get it had nothing to go on and fell back to the older per-brand zip in the portal. The section names the GitHub release, the fingerprint check and the folder it installs into, and says plainly that the portal zip is the other toolkit. |
| 8 September 2026 | Open beta. The lapsed sign-in row now says what to press: Reconnect on the HubPeople row in your connector settings, with removing and re-adding as the fallback, matching the setup guide. The rate-limit row said to ask in fewer, larger requests; the limit resets within a minute, so it now says to wait a moment and carry on. |
| 7 September 2026 | Rewritten as the connection reference. Added the server details, the steps for connecting an assistant other than Claude, the OAuth and loopback rules those clients need, and a table of which clients are proven today. Corrected a wrong statement that a connector could not be added from a phone; it can, and the claim has been removed. The page also moved from /guides/mcp-toolkit/getting-connected to its address here. The prompts that used to be on this page now live on the start page. |
| 3 September 2026 | Page first published on the Help Centre, covering the connector setup and a first set of prompts. |