Connect an agent
You can connect a local AI assistant — Claude Desktop, Claude Code, an OpenClaw-class agent, or any MCP-capable agent — to SweetHive. It connects with a scoped access token that never exceeds what you can see, and that you can revoke at any time.
Create a connection
- Open My agents from the home rail (or Settings → Connected agents).
- Choose Connect an agent.
- Name it, pick the hives and contexts it may access, choose a capability and an expiry.
- Create the token. Copy it (shown once) or download the config bundle.
- Register the connector with your local agent using the bundle — see MCP connector setup.
Capabilities
| Capability | The agent can |
|---|---|
| Read (default) | read items and search in its scope |
| Read + draft | also prepare drafts for you to send |
| Read + post | also post messages — with your one-time confirmation per context |
What stays safe
- The token's scope is intersected with your live visibility on every request. Leave a group, and the token loses that access at the same instant.
- Read-only is the default. Posting needs a Read + post token and a one-time confirmation per context.
- Anything a connected agent posts is attributed “via you” and obeys the same group targeting as any message.
- Revoke a token in one click from its card — access stops immediately.
- Every token's card shows when it was last used and how much it has read, and hive admins can allow, restrict to read-only, or block external agents on their hive entirely.
Your agent runs outside SweetHive. Anything the token can read, treat as being on your machine — so scope it tightly: the contexts it needs, nothing more.
See your agents at work
The My agents page lists every token with its scope, capability, expiry and a live online indicator (the agent has checked in recently). From a context, you can also see which of your agents currently cover it.