# Quickstart

Two minutes from nothing to your agent searching 1,459,683 licence-cleared components.

## 1. Get a free API key

Sign up at [/signup](/signup) with your email (no card). Confirm the link we send and copy the key it shows you. It starts with `cobalt_live_` and is shown once; you can regenerate it at [/account](/account). The Free plan gives you free search plus 30 pull credits on day one, then 10 a day.

## 2. Connect your agent

The quickest way is the installer. It finds Claude Code, Claude Desktop, Cursor, Windsurf, Codex, OpenClaw and Hermes on your machine and configures each one (VS Code is manual, see below):

```sh
npx @justclaw-it/cli init
```

or, without npm on your PATH:

```sh
curl -fsSL https://justclaw.it.com/install | sh
```

> The `@justclaw-it/cli` 0.1.0 release is rolling out on npm. If `npx` stops with `justclaw-it: not found`, use the manual setup for your client below; it is one command or one config entry.

Or set it up by hand. Every client uses the same server URL, `https://justclaw.it.com/mcp` (Streamable HTTP), and the header `Authorization: Bearer <YOUR_API_KEY>`:

| client | how | guide |
| --- | --- | --- |
| Claude Code | `claude mcp add` one-liner | [Claude Code](/docs/clients/claude-code) |
| Claude Desktop | `claude_desktop_config.json` via `mcp-remote` | [Claude Desktop](/docs/clients/claude-desktop) |
| Cursor | `~/.cursor/mcp.json` | [Cursor](/docs/clients/cursor) |
| Windsurf | `mcp_config.json` with `serverUrl` | [Windsurf](/docs/clients/windsurf) |
| VS Code | `.vscode/mcp.json` with a prompted key | [VS Code](/docs/clients/vscode) |
| Codex CLI | `~/.codex/config.toml` | [Codex](/docs/clients/codex) |
| OpenClaw | `openclaw mcp set` | [OpenClaw](/docs/clients/openclaw) |
| Hermes Agent | `~/.hermes/config.yaml` | [Hermes Agent](/docs/clients/hermes) |
| anything else | standard bearer header | [Other clients](/docs/clients/other) |

## 3. Restart and try it

Restart the agent so it loads the new server, then ask in plain language:

- *"Search JustClaw-It for an express JWT auth middleware with a permissive licence."*
- *"Find a Python Stripe webhook signature check on JustClaw-It and pull the best one into this project."*

The agent calls `search_components` (free), picks a result by fit, score and licence, and calls `get_component` (1 credit) to pull the source. Keep the attribution header that comes with the code.

## 4. Check it works

```sh
npx @justclaw-it/cli doctor
```

`doctor` tests the connection, shows your plan and usage, and lists which agents are configured. Without the CLI:

```sh
curl -H "Authorization: Bearer $JUSTCLAW_IT_API_KEY" https://justclaw.it.com/usage
```

## Next

- [Tool reference](/docs/tools): every tool, parameter and result field.
- [Licences & attribution](/docs/licences): what you must keep when you reuse a component.
- [Agent skills](/docs/skills): teach your agent when to search before it writes.
- [Troubleshooting](/docs/troubleshooting) if something doesn't connect.