hiveloom mcp-identity
An MCP identity is a per-person credential that a chat client (Claude Desktop, Cursor) uses to talk to one of your agent’s MCP endpoints. Identities are created server-side, then claimed by the user via a short-lived setup code.
Synopsis
hiveloom mcp-identity [GLOBAL FLAGS] <COMMAND>Global flags
| Flag | Description |
|---|---|
--endpoint <URL> | API endpoint. |
--token <TOKEN> | Bearer token for remote access. |
--json | JSON output. |
Subcommands
| Subcommand | Purpose |
|---|---|
create | Issue a new MCP identity. Returns a setup code the user redeems. |
list | List MCP identities for a tenant. |
show | Show details for one identity. |
map | Map an identity to a person (free-form label). |
unmap | Remove the person mapping. |
revoke | Revoke an identity. Existing client connections stop working. |
reissue-setup-code | Generate a fresh setup code if the original expired. |
Examples
Issue an identity for Alice and hand her the setup code:
hiveloom mcp-identity create \
--tenant acme \
--label "[email protected]"
# Output: setup code AB12-CD34-EF56 (valid 24h)Alice pastes the setup code into her chat client. After redemption:
hiveloom mcp-identity list --tenant acme
hiveloom mcp-identity show id_xyz789 --tenant acmeRevoke when Alice leaves:
hiveloom mcp-identity revoke id_xyz789 --tenant acmeIf the setup code expired before redemption:
hiveloom mcp-identity reissue-setup-code id_xyz789 --tenant acmeSee also
- Connect Claude Desktop — end-to-end setup including how the setup code is used by the client.
- MCP endpoint — how to find the URL the identity authenticates against.