AI clients
AI clients are the coding assistants and chat apps that read and ask a product's help over MCP, and this page is where you add one and see or disconnect it. Pressing the install prompt for Your team mints a token that is shown once, and Your users needs no account but needs the help site public.
On this page
Add a client
In Connect
AI clients, select Add a client. The button shows only once a client has connected; until then the add card is already open. Choose who the client is for: Your team or Your users, as the table below says.
Open the install prompt in your coding agent, or copy it. Claude Code, Cursor and VS Code open from a link, and the other clients use the copy.
The agent adds Cactus to every project on the machine, checks the address, and asks you to restart the client.
The card closes when the client's first call reaches Cactus, and the client appears under Connected.
Choose an address
Address | Who it is for | What it reads | What it needs |
|---|---|---|---|
Your team | Who it is for You, on every product | What it reads Every product, team pages, and past conversations. | What it needs Your Cactus account. A token is minted when you press the prompt. |
Your users | Who it is for Anyone, with no account | What it reads The product's help site and its questions. | What it needs The help site made public. |
The team address is https://mcp.heycactus.ai/mcp, and a product's public address is /p/ and its name, then /mcp.
If a prompt has no token, the client logs in to Cactus with OAuth the first time it connects, in a browser window.
Your team's tokens
Each person has one token per client, for Claude Code, Cursor or VS Code. Pressing the prompt again for the same client replaces the old token.
The token is shown once, on the add card, with the line "Your token. It’s shown only once, so copy it now."
Any member of the team that owns the product can mint a token for it.
Revoke a token
In Your tokens on this page, select Revoke beside the client. The token stops working on the client's next call.
The client keeps its entry in its own settings. It stays until the install is run again, so Revoke is not the same as disconnecting the client.
Each token row shows Used with its last use, or Not used yet until the client first calls.
Connected clients
Connected lists each client that has reached this product through its own address or through the team's address. Each row shows the address, the person, when it connected or was last seen, and its call count.
A row reads Seen today when its last call was within the last 24 hours, and Not seen today otherwise.
Select Forget to remove a row. This removes only Cactus’ record of the client. The client keeps its login and writes a new row the next time it connects.
To log a client out, use Disconnect under Logged in as you, or Revoke on its token.
Logged in as you and claimed agents
Logged in as you lists the clients that logged in through your browser. They work on every product.
Select Disconnect to log one out. Its token is refused on the client's next call, and the client must log in again.
Agents you’ve claimed lists the agents you added to your team with a code. An agent stays logged in for 30 days from its claim, and the row shows the date it stops. Adding an agent is covered on Connecting from an AI agent.
Select Disconnect on an agent to log it out. It must be claimed again before it can connect.
If a client doesn’t show up
What you see | What it means | What to do |
|---|---|---|
“Couldn’t load the connected clients.” | What it means The list could not be read. | What to do Select Try again on the message. |
“Couldn’t reach Cactus to set this up. Try again.” | What it means The token could not be minted. | What to do Press the prompt again. |
“Couldn’t find this product.” | What it means You are not on the team that owns this product. | What to do Open a product your team owns. |
“Make your help site public first” | What it means The Your users address needs a public help site. | What to do Make the Help site public, then return here. |
“Waiting for a client to connect…” | What it means The card has not seen a first call yet. | What to do Run the install in the client, restart it, and ask it a question. |