Quickstart

Read plain Markdown

# Quickstart

Two minutes from nothing to your agent searching 4,519,159 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 up to 300 free component pulls a month (10 a day) and 30 on signup.

## 2. Connect your agent

Claude Code takes one command:

```sh
claude mcp add --transport http --scope user justclaw-it https://justclaw.it.com/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
```

Cursor (`~/.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "justclaw-it": {
      "url": "https://justclaw.it.com/mcp",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}
```

VS Code (`.vscode/mcp.json`, asks for the key once and stores it securely):

```json
{
  "inputs": [
    { "type": "promptString", "id": "justclaw-it-key",
      "description": "JustClaw-It API key", "password": true }
  ],
  "servers": {
    "justclaw-it": {
      "type": "http",
      "url": "https://justclaw.it.com/mcp",
      "headers": { "Authorization": "Bearer ${input:justclaw-it-key}" }
    }
  }
}
```

Codex CLI (`~/.codex/config.toml`):

```toml
[mcp_servers.justclaw-it]
url = "https://justclaw.it.com/mcp"
http_headers = { "Authorization" = "Bearer <YOUR_API_KEY>" }
```

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

On **Claude.ai or ChatGPT** you don't need a key or a config file: add `https://justclaw.it.com/mcp/signin` as a custom connector and sign in with your JustClaw-It account ([Claude.ai](/docs/clients/claude-ai), [ChatGPT](/docs/clients/chatgpt)).

Want to try it before you sign up? `https://justclaw.it.com/mcp` answers `search_components` with no key at all (a small per-network limit); every other tool asks for a key or a signed-in connector.

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

In Claude Code, `claude mcp list` should show `justclaw-it` as connected. To check the key itself:

```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.