---
lang: en
---

# AI clients

An AI client is an app, such as Claude Code or Cursor, that reads and asks a product over MCP, and you add, watch and disconnect clients on Connect › AI clients. A client added with **Your team** logs in as you and works on every product you can reach, while **Your users** needs no account and reads only the product's public help site.

> Verified against the product on 2026-11-20

## Add a client

1. In Connect › AI clients, select **Add a client**. The button shows once a client is listed. With no client yet, the card is already open.
2. Choose **Your team** or **Your users**.
3. Copy the install prompt under **Install prompt for a coding agent** into your agent, or open it there.

The prompt tells the agent to add Cactus for every project on the machine, and to restart the client when it is done.

Other clients have their own commands under **Another client**, which lists Claude Code, Codex, Cursor and VS Code.

## Your team or your users

| Address | Account | What it reads | Needs |
| --- | --- | --- | --- |
| **Your team** | Your Cactus account. | Every product, team pages and past conversations. | A token for you, which the card mints. |
| **Your users** | None. | The product's help site, and it asks questions there. | The product's help site made public. |

If the help site is not public, **Your users** shows no install and asks you to make it public on the [Help site](https://cactus.heycactus.ai/94dn3s-help-site) page.

## Your team's token

When you press the install prompt for **Your team**, Cactus mints a token for you and that client. The card shows the token once, with the words “Your token. It’s shown only once, so copy it now.” The token cannot be shown again.

Until a token exists, the copy button is off. Pressing the prompt mints one first.

Each client has one token for you. A second mint for the same client replaces the first, and the old token stops working.

Without a token, the client asks you to log in to Cactus the first time it connects, in a browser window.

## Check that a client connected

After you add a client, the card says “Waiting for a client to connect…”. When the client's first call arrives, the card closes and that client is listed at the top.

## Connected clients

The **Connected** list shows each client that has reached this product, or the team it belongs to. Each row shows the client's name, whether it used the **Team address** or the **Public address**, the person it is signed in as or “No account”, when it first connected or was last seen, and its call count. A client seen in the last 24 hours shows as “Seen today”.

Select **Forget** to remove a row from this list. Forgetting removes only the record. The client keeps what it was given, and it gets a new row the next time it connects.

## Disconnect a client

Three lists hold the ways a client can be signed out. Each has its own button.

| Panel | What it lists | What its button does |
| --- | --- | --- |
| **Logged in as you** | Clients that logged in through your browser. They work on every product. | **Disconnect** revokes that sign-in. The client's token is refused on its next call, and the client must log in again. |
| **Agents you’ve claimed** | Agents you gave your team a code for, with the date each is logged in until. | **Disconnect** logs the agent out, and it must be claimed again. |
| **Your tokens** | One row for each client you minted a token for, marked “Used” or “Not used yet”. | **Revoke** stops that token on its next call. The entry stays in the client's own settings until its install is run again. |

## Approve a browser sign-in

When a client signs in through the browser, Cactus shows a page headed “Your agent wants to use Cactus as you. Shall I let it in?”, or a set-up wording when the client asks to set up Cactus. The page lists what the client may do, in words such as “read your pages” and “ask me questions”.

Select **Allow** to let it in, or **Deny** to refuse. Deny sends the answer back to the client as refused.

If you are signed out, the page offers **Log in with GitHub** or **Log in with Google** where those are set up, and otherwise **Log in**. Once you are in, the page names your team. Which line it shows depends on your team:

- A team you are on: “It will work in” that team.
- No team yet: Allow makes one with a free trial and no card.
- A team already on Cactus that you have not joined: you join it first, then Allow brings you back.
- The waitlist: Cactus says it has a waitlist for now, and Allow joins it.

A sign-in that came through a help site, not through Cactus itself, needs a team already. Without one, Allow is refused.

You can take a client back at any time under **AI clients**.

## Give an agent your team

An agent with no browser shows a six-digit code. You open the link it gave you, type the code and press **Give it my team**. The page is for a person who is logged in as the email the agent named.

Type a code only from an agent you started yourself. A code lasts 10 minutes.

On success the page says “The agent has your team”, and the agent gets its token at its next check.

If you are on the waitlist, the page also asks for a referral code. Leave it empty to join the waitlist.

If your team is already on Cactus and you have not joined it, the claim stops and asks you to join first.

## If a client doesn’t connect

| What you see | What it means | What to do |
| --- | --- | --- |
| “Couldn’t reach Cactus to set this up. Try again.” | The token could not be minted. | Press the install prompt again. |
| “Couldn’t load the connected clients.” | The **Connected** list could not be read. | Use the retry the message offers. |
| “Couldn’t load the clients and agents logged in as you.” | The **Logged in as you** list could not be read. | Use the retry the message offers. |
| “Your login timed out while this page was open.” | The sign-in on the approval page has run out. | Select **Log in again**. |
| “I can’t verify this request” | The approval link is not signed by Cactus. | Start again from your agent. Nothing was shared. |
| “This claim link can’t be verified” | Cactus does not know the agent behind the link. | Ask the agent to start again. Nothing was shared. |
| “This agent asked for somebody else” | The agent named another email. | Log in as the email the agent named. |
| “That isn’t the code” | The six digits do not match. | Type the six digits again. |
| “Too many wrong codes” | The link is closed. | Ask the agent to start again. |
| “This code has expired” | The 10 minutes have passed. | Ask the agent to start again. |
| “This agent already has a team” | Someone already typed its code. | If that was not you, tell your team. |
| “Join a teamspace before connecting an AI client.” | A help-site sign-in found no team for you. | Join a teamspace, then connect again. See [Joining a team](https://cactus.heycactus.ai/55b9rk-joining-a-team). |
