install-mcp
unison-labs-ai/install-mcp
One-command CLI to install the Unison Memory MCP into any client (Claude Code, Cursor, Codex, OpenCode, Windsurf, ChatGPT) — auth included.
Instalação
npx convez-ai unison-labs-ai/install-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
install-mcp
One command. Persistent memory in every AI client you already use.
Add the Unison brain to Claude Code, Cursor, Codex, Windsurf, or any of 17 other clients — auth included, no config editing required.
Quickstart • Supported clients • Flags • MCP tools • Auth flow
Quickstart
npx @unisonlabs/install-mcp
The CLI prompts for your client and email, then handles everything else: provisions your account, mints a usk_live_... API key, and writes the MCP server entry into your client's config file. Restart your client — the brain tools are live.
What it does
- Detects (or asks for) your target client.
- Provisions a Unison account and mints a
usk_live_...API key via the machine-auth flow — or recovers your existing key if the email is already registered. - Writes the MCP server entry (
@unisonlabs/mcp) into the client's config file withUNISON_TOKENandUNISON_API_URLenv vars set. - Done — restart your client and the brain tools are available.
Supported clients
Specify client directly
npx @unisonlabs/install-mcp --client claude-code
npx @unisonlabs/install-mcp --client cursor
npx @unisonlabs/install-mcp --client windsurf
| Client | Flag |
|---|---|
| Claude Code | --client claude-code |
| Cursor | --client cursor |
| OpenCode | --client opencode |
| VS Code | --client vscode |
| Codex CLI | --client codex |
| Gemini CLI | --client gemini-cli |
| Zed | --client zed |
| Windsurf | --client windsurf |
| Claude Desktop | --client claude-desktop |
| Cline | --client cline |
| Roo-Cline | --client roo-cline |
| Goose | --client goose |
| Aider | --client aider |
| Aider Desk | --client aider-desk |
| Witsy | --client witsy |
| Enconvo | --client enconvo |
| Warp | --client warp (prints config to paste) |
| Droid | --client droid |
Flags
Skip confirmations
npx @unisonlabs/install-mcp --client claude-code --yes
Install locally (project-scoped config)
npx @unisonlabs/install-mcp --client cursor --local
Bring your own token
UNISON_TOKEN=usk_live_... npx @unisonlabs/install-mcp --client claude-code
# or
npx @unisonlabs/install-mcp --client claude-code --token usk_live_...
Custom API URL
npx @unisonlabs/install-mcp --client cursor --api-url https://brain.unisonlabs.ai
Skip auth (token must already be set)
npx @unisonlabs/install-mcp --client codex --skip-auth
Environment variables
| Variable | Description | Default |
|---|---|---|
UNISON_TOKEN | Your usk_live_... API key | — |
UNISON_API_URL | Unison API base URL | https://brain.unisonlabs.ai |
The installed MCP config also sets these env vars so the MCP server can reach the brain.
Auth flow
The installer uses a headless (no browser) three-step machine-auth flow:
POST /v1/auth/provision— creates an account and returns an immediately usableusk_key plus sends a verification OTP to your email.- You enter the OTP.
POST /v1/auth/verify— makes the account durable (no 72-hour expiry).
If your email is already registered, the installer runs the recovery flow (/v1/auth/request-key + /v1/auth/verify) to mint a fresh key instead.
The minted token is saved to ~/.config/unison/config.json and used on subsequent installs without prompting.
MCP tools
Once installed, the following tools are available inside your client:
Brain (memory): brain_search, brain_get, brain_list, brain_write, brain_edit, brain_resolve_entity, brain_facts_about, brain_record_fact, brain_status
Auth bootstrap (no token required): auth_provision, auth_verify, auth_request_key
Web: web_search
What gets written to your config
{
"mcpServers": {
"unison-brain": {
"command": "npx",
"args": ["-y", "@unisonlabs/mcp"],
"env": {
"UNISON_TOKEN": "usk_live_...",
"UNISON_API_URL": "https://brain.unisonlabs.ai"
}
}
}
}
Star history
If this saved you time, a star helps others find it.
License
MIT
Part of the Unison Labs constellation
One brain, every agent. Every repo below reads from and writes to the same Unison brain — no per-tool memory silos.
| Repo | What it does |
|---|---|
| unison-brain | CLI · SDK · MCP server — the core |
| claude-unison | Memory for Claude Code |
| cursor-unison | Memory for Cursor |
| codex-unison | Memory for OpenAI Codex CLI |
| opencode-unison | Memory for OpenCode |
| openclaw-unison | Memory for OpenClaw |
| pipecat-unison | Memory for Pipecat voice agents |
| python-sdk | Python SDK for the brain |
| install-mcp | One-command MCP installer ← you are here |
| code-chunk | AST-aware code chunking |
| unison-fs | Mount the brain as a filesystem |
| backchannel | Async messaging between agents |
| Unison-evals | Open memory benchmark suite |