HIVE CLI Docs
Home
Docs / Get started

Get started

Scan your app, review its capabilities, and run a local MCP server.

Before you start

Use Node.js 22.12 or newer. HIVE CLI currently scans an existing TypeScript Next.js App Router project. Run commands from that project's root.

Preview the scan

See discovered capabilities without writing files.

terminal
npx @usehive/cli scan --dry-run

Generate and install

Run the interactive scan. Review the methods, routes, risk labels, and permission evidence before selecting tools. Read operations start selected; write and destructive operations start unselected.

terminal
npx @usehive/cli scan --install

The official package is @usehive/cli on npm. HIVE generates the selected MCP tools inside .hive/ and installs the generated server's dependencies. You can also install the CLI globally with npm install -g @usehive/cli and run hive scan.

Run it locally

Start your application normally. Copy the generated environment template and set HIVE_APP_BASE_URL to your running app's origin. Add an existing app credential only if its API needs one.

terminal
cp .hive/mcp/.env.example .hive/mcp/.env
npm run hive:mcp

The Streamable HTTP endpoint is http://127.0.0.1:3333/mcp. If your project already had a hive:mcp script, HIVE leaves it unchanged; use npx @usehive/cli dev instead.

Keep it in sync

When your app changes, run sync. Unchanged approved tools stay approved, changed tools ask for re-approval, and new operations are offered for review, never approved automatically.

terminal
npx @usehive/cli sync

See the CLI reference for the exact rules and for checking drift in CI.

Use it from Claude or ChatGPT

Chat apps connect to MCP servers over the internet, so a server on 127.0.0.1 isn't enough for them. Once your app is deployed, host the generated server on your own Vercel account and paste the link it prints into the chat app.

terminal
npx @usehive/cli deploy --app-url https://myapp.com

See Deploy on Vercel for what it checks and how to connect Claude or ChatGPT.