Hubbi & AI

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.

One address Your HubPeople login No token to create About two minutes
The short version: add a custom connector pointed at 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.

WhatValue
MCP endpointhttps://mcp.hubpeople.ai/mcp
TransportStreamable HTTP. Send POST with Accept: application/json, text/event-stream.
AuthenticationOAuth 2.1. Bearer token in the Authorization header.
Scopemcp
Who you sign in asYour ordinary HubPeople portal login. You see exactly the brands that account can already see.
Use the address exactly as written, lower case and with no trailing slash.

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

  1. Open Settings, then Connectors. In the desktop app you can also click + beside the message box, then Connectors, then Manage connectors.
  2. Choose Add custom connector.
  3. 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.
  4. Put https://mcp.hubpeople.ai/mcp in the server address field and continue.
  5. Leave every remaining field exactly as it arrives. They are filled in from our server and there is nothing you need to change.
  6. 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

  1. Calls the endpoint with no token and gets 401 with a WWW-Authenticate: Bearer challenge naming the resource metadata document.
  2. Reads the protected resource metadata to find the authorization server.
  3. Reads the authorization server metadata to find where to register itself and where to send you to sign in.
  4. 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.
  5. Runs an authorization code flow with PKCE. You sign in and approve in a browser, and it exchanges the code for a token.
  6. Sends that token as a bearer header, and refreshes it when it expires.

What your client needs from you

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.

RedirectAccepted
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 controlYes, given at registration.
Anything carrying a fragmentNo. Refused when the client registers.
Plain 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

This is a beta, and not every connection path below is proven yet. Claude is the one we use daily and support properly. The others should work, because this server follows the standard rather than doing anything of its own, but we have not walked them end to end ourselves. We are working through them. If you get one going, or get stuck, telling us is the fastest way to turn a row below into real instructions.
ClientWhere it stands
Claude on the website and in the desktop appVerified. Used daily, on more than one account.
The Claude phone appsThe connection works there once it is on your account.
Claude Code and other command line agentsThe 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 clientsUntested. 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 seeWhat 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

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 →

Everything the MCP can do →

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.

Send feedback

Changelog

ReleaseChanges
15 September 2026Added 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 2026Open 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 2026Rewritten 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 2026Page first published on the Help Centre, covering the connector setup and a first set of prompts.