convez.ai
MCP Server
unison-labs-ai

install-mcp

unison-labs-ai/install-mcp

Ver no GitHub
BomPluginScore · de 0 a 100

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-mcp

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 2 meses
Versão
—
Issues abertas
7
Contribuidores
2

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.

CI npm License: MIT Stars

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

  1. Detects (or asks for) your target client.
  2. 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.
  3. Writes the MCP server entry (@unisonlabs/mcp) into the client's config file with UNISON_TOKEN and UNISON_API_URL env vars set.
  4. 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
ClientFlag
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

VariableDescriptionDefault
UNISON_TOKENYour usk_live_... API key—
UNISON_API_URLUnison API base URLhttps://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:

  1. POST /v1/auth/provision — creates an account and returns an immediately usable usk_ key plus sends a verification OTP to your email.
  2. You enter the OTP.
  3. 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.

Star history chart

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.

RepoWhat it does
unison-brainCLI · SDK · MCP server — the core
claude-unisonMemory for Claude Code
cursor-unisonMemory for Cursor
codex-unisonMemory for OpenAI Codex CLI
opencode-unisonMemory for OpenCode
openclaw-unisonMemory for OpenClaw
pipecat-unisonMemory for Pipecat voice agents
python-sdkPython SDK for the brain
install-mcpOne-command MCP installer ← you are here
code-chunkAST-aware code chunking
unison-fsMount the brain as a filesystem
backchannelAsync messaging between agents
Unison-evalsOpen memory benchmark suite
Ver o original no GitHub

Bom para

Relacionados