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

  1. In ConnectAI clients, select Add a client. The button shows only once a client has connected; until then the add card is already open.

  2. Choose who the client is for: Your team or Your users, as the table below says.

  3. 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.

  4. The agent adds Cactus to every project on the machine, checks the address, and asks you to restart the client.

  5. 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.

Sources

Related pages