HarborHarbor
DocumentationGuidesPlugins
Get Started

Install your first plugin

Connect a service, inspect readiness, and run your first tool with real CLI commands.

Pick a service

Open the Plugin catalog and pick one you use. This guide uses Linear as the example, but the same inspect/exec pattern applies to any ready source.

Install and authorize

Use the Harbor Cloud dashboard Install page for guided install and OAuth. The public CLI does not expose a top-level plugin install command.

If a source is present but needs OAuth, inspect can return the setup URL:

hrbr inspect 'return await hrbr.sources.oauthStart({ namespace: "linear-mcp" })'

Inspect source readiness

hrbr inspect 'return await hrbr.sources.list()'

Look for a ready source and its runtime namespace. If it is not ready, finish the setup step before executing.

Search tools

hrbr inspect 'return await hrbr.tools.search({ query: "linear list issues", limit: 5 })'

The search result includes callable examples and type details. Copy the returned JavaScript call shape instead of guessing tool names.

Run a tool

hrbr exec 'return await linearMcp.listIssues({ limit: 3 })'

The execution returns TOON-formatted output and records a trace.

Where to go next