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.
On this page
Add a client
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.
Choose Your team or Your users.
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 | Account Your Cactus account. | What it reads Every product, team pages and past conversations. | Needs A token for you, which the card mints. |
Your users | Account None. | What it reads The product's help site, and it asks questions there. | Needs 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 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 | What it lists Clients that logged in through your browser. They work on every product. | What its button does 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 | What it lists Agents you gave your team a code for, with the date each is logged in until. | What its button does Disconnect logs the agent out, and it must be claimed again. |
Your tokens | What it lists One row for each client you minted a token for, marked “Used” or “Not used yet”. | What its button does 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.” | What it means The token could not be minted. | What to do Press the install prompt again. |
“Couldn’t load the connected clients.” | What it means The Connected list could not be read. | What to do Use the retry the message offers. |
“Couldn’t load the clients and agents logged in as you.” | What it means The Logged in as you list could not be read. | What to do Use the retry the message offers. |
“Your login timed out while this page was open.” | What it means The sign-in on the approval page has run out. | What to do Select Log in again. |
“I can’t verify this request” | What it means The approval link is not signed by Cactus. | What to do Start again from your agent. Nothing was shared. |
“This claim link can’t be verified” | What it means Cactus does not know the agent behind the link. | What to do Ask the agent to start again. Nothing was shared. |
“This agent asked for somebody else” | What it means The agent named another email. | What to do Log in as the email the agent named. |
“That isn’t the code” | What it means The six digits do not match. | What to do Type the six digits again. |
“Too many wrong codes” | What it means The link is closed. | What to do Ask the agent to start again. |
“This code has expired” | What it means The 10 minutes have passed. | What to do Ask the agent to start again. |
“This agent already has a team” | What it means Someone already typed its code. | What to do If that was not you, tell your team. |
“Join a teamspace before connecting an AI client.” | What it means A help-site sign-in found no team for you. | What to do Join a teamspace, then connect again. See Joining a team. |