install-harbor

Install Harbor's local hrbr MCP server into agent clients.

Install the Harbor CLI once for normal use:

npm install -g @zonko-ai/harbor
hrbr login

The MCP server can then be started with:

hrbr serve

For copy-paste MCP configs, this repo uses the installed CLI form:

hrbr serve

That keeps every harness on the same singleton sidecar path instead of launching package bootstrap processes per client.

Install

Platforms are grouped by install complexity. Plugin-capable platforms get marketplace commands. Other platforms get exact MCP files to create and paste.

Harbor skills are seeded by the @zonko-ai/harbor npm postinstall/onboarding path when the CLI is installed. They are refreshed again by Harbor auth/setup flows. This repo does not ask users to copy AGENTS.md or per-project instruction files.

Claude Code — plugin marketplace

Prerequisites: Claude Code with plugin support and Node.js.

Install:

npm install -g @zonko-ai/harbor
hrbr login
/plugin marketplace add zonko-ai/install-harbor
/plugin install hrbr@zonko-ai-harbor

Restart Claude Code or run:

/reload-plugins

Verify:

/mcp

You should see an hrbr MCP server with Reef's inspect and exec tools.

Alternative — MCP-only install

claude mcp add -s user hrbr -- hrbr serve

Codex — plugin marketplace

Prerequisites: Codex CLI with plugin support and Node.js.

Install:

codex plugin marketplace add zonko-ai/install-harbor

Open /plugins, select Zonko AI Harbor, choose hrbr, and install it.

Then authenticate:

hrbr login

The plugin installs the hrbr MCP server through a plugin-local launcher:

bash ./scripts/run-mcp.sh

That launcher currently executes:

hrbr serve

It keeps the Codex MCP config stable while Harbor can change package startup details inside the plugin bundle. hrbr serve starts a lightweight stdio bridge and reuses one local hrbr MCP sidecar on 127.0.0.1, so multiple harnesses do not each own a full MCP server.

Restart Codex after installing the plugin.

Verify: list MCP tools. Harbor should expose Reef's inspect and exec tools.

Manual fallback config: configs/codex/config.toml

Debug local plugin health:

PLUGIN_ROOT="$(find ~/.codex/plugins/cache -path '*/zonko-ai-harbor/hrbr/*' -type d | sort | tail -1)"
cd "$PLUGIN_ROOT"
./scripts/check-health.sh

Update:

codex plugin marketplace upgrade zonko-ai-harbor

Codex caches installed plugins by marketplace, plugin name, and plugin version. Harbor bumps the hrbr plugin version whenever plugin assets, MCP config, or skills change so upgrades install into a new cache path.

Typical cache shape:

~/.codex/plugins/cache/zonko-ai-harbor/hrbr/<version>/

Gemini CLI — one settings file

Prerequisites: Gemini CLI and Node.js.

Install:

npm install -g @zonko-ai/harbor
hrbr login

Add this to ~/.gemini/settings.json:

{
  "mcpServers": {
    "hrbr": {
      "command": "hrbr",
      "args": ["serve"]
    }
  }
}

Verify:

/mcp list

Full config reference: configs/gemini-cli/settings.json

Cursor — MCP config

Prerequisites: Cursor Agent and Node.js.

Install:

npm install -g @zonko-ai/harbor
hrbr login

Create .cursor/mcp.json:

{
  "mcpServers": {
    "hrbr": {
      "command": "hrbr",
      "args": ["serve"]
    }
  }
}

Verify: open Cursor Settings > MCP and confirm hrbr is connected.

Full config: configs/cursor/mcp.json

OpenCode — MCP config

Prerequisites: OpenCode and Node.js.

Install:

npm install -g @zonko-ai/harbor
hrbr login

Add this to opencode.json in your project root or ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "hrbr": {
      "type": "local",
      "command": ["hrbr", "serve"]
    }
  }
}

Verify: start OpenCode and confirm the inspect and exec MCP tools are available.

Full config reference: configs/opencode/opencode.json

OpenClaw — MCP registry

Prerequisites: OpenClaw and Node.js.

Install:

npm install -g @zonko-ai/harbor
hrbr login
openclaw mcp set hrbr '{"command":"hrbr","args":["serve"]}'

Verify:

openclaw mcp show hrbr --json

Full config reference: configs/openclaw/mcp.json

Hermes — MCP server

Prerequisites: Hermes Agent and Node.js.

Install:

npm install -g @zonko-ai/harbor
hrbr login
hermes mcp add hrbr --command hrbr --args serve

Verify:

hermes mcp test hrbr
hermes mcp list

Full config reference: configs/hermes/config.yaml

VS Code Copilot — MCP config

Prerequisites: VS Code Copilot Chat with MCP support and Node.js.

Install:

npm install -g @zonko-ai/harbor
hrbr login

Create .vscode/mcp.json:

{
  "servers": {
    "hrbr": {
      "command": "hrbr",
      "args": ["serve"]
    }
  }
}

Full config: configs/vscode-copilot/mcp.json

JetBrains Copilot — MCP UI

Prerequisites: JetBrains IDE with Copilot MCP support and Node.js.

Install:

npm install -g @zonko-ai/harbor
hrbr login

Add MCP server in the IDE settings:

Name: hrbr
Command: hrbr
Args: serve

Full config: configs/jetbrains-copilot/mcp.json

Provider Marketplace

Once installed, provider setup happens through Reef MCP tools:

inspect: check auth, workspace, source, and tool state
exec: run Harbor Cloud TypeScript against the current workspace