Skip to Content
CLI referencemcp-identity

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

FlagDescription
--endpoint <URL>API endpoint.
--token <TOKEN>Bearer token for remote access.
--jsonJSON output.

Subcommands

SubcommandPurpose
createIssue a new MCP identity. Returns a setup code the user redeems.
listList MCP identities for a tenant.
showShow details for one identity.
mapMap an identity to a person (free-form label).
unmapRemove the person mapping.
revokeRevoke an identity. Existing client connections stop working.
reissue-setup-codeGenerate 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 "alice@acme.com"
# 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 acme

Revoke when Alice leaves:

hiveloom mcp-identity revoke id_xyz789 --tenant acme

If the setup code expired before redemption:

hiveloom mcp-identity reissue-setup-code id_xyz789 --tenant acme

See 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.
authagent