# Agentek – áttekintés és gyors kezdés

> Telepítsd a Haszno skillt, CLI-t és MCP-szervert; futtasd az első csak olvasásos parancsot a demón öt percen belül.

## A három eszköz

A Haszno három csomagot biztosít AI-agenteknek és automatizálási szkripteknek. A CLI és az MCP-szerver ugyanazt a HTTP API-t hívja, ugyanolyan hitelesítési adatokkal (az `x-api-key` fejlécben küldött API-kulccsal vagy HTTP Basic-kel), de máshonnan olvassák őket: a CLI csak az `--api-key` / `--api-url` flagekből és a környezeti változókból (`HASZNO_API_KEY`, `HASZNO_API_URL`, `HASZNO_BASIC`), az MCP-szerver ezekből a környezeti változókból, vagy ha egyik sincs beállítva, a `~/.config/haszno/config.json` fájlból. Lásd: [CLI-beállítás](cli.md#configuration).

| Csomag | Mi ez | Mire való |
|---|---|---|
| **MCP-szerver** (`haszno-mcp`) | MCP stdio szerver: 51 eszköz `haszno_*` névvel regisztrálva | Interaktív Claude Code- vagy Claude Desktop-munkamenetek – az eszközök natívan jelennek meg, nincs szükség parancssori meghívásra |
| **CLI** (`haszno`) | Node.js parancssori program | Shellszkriptek, cron-feladatok, Codex, Cursor terminál, fej nélküli agentek |
| **Skill** (`haszno-skill`) | Irányítófájlok a Claude Code-hoz: biztonsági szabályok, munkafolyamat-receptek, eszköz- és parancshivatkozások | A Claude Code betöltheti, ha a beszélgetés a Hasznóról szól; megtanítja az agentnek az MCP és a CLI használatát |

A skill önmagában nem önálló API-felület. A Claude Code-ban töltődik be, és utasítja az agentet: ha az MCP csatlakoztatva van, azt használja, egyébként a CLI-t.

## Melyiket válaszd?

| Környezet | Mit használj |
|---|---|
| Interaktív Claude Code-munkamenet | MCP-szerver + skill |
| Claude Desktop | MCP-szerver |
| Bármely MCP-kompatibilis kliens (Cursor, Zed …) | MCP-szerver |
| Shellszkript vagy cron-feladat | CLI |
| Codex terminál | CLI |
| Mindhárom egyszerre | Egylépéses telepítő |

## Telepítés

### Egylépéses telepítő (ajánlott)

Egyetlen paranccsal telepíti a CLI-t, az MCP-szervert és a skillt. Szükséges: Node.js 20 vagy újabb, `git` és `npm`.

```bash
curl -fsSL https://raw.githubusercontent.com/haszno-labs/haszno-skill/main/install.sh | bash
```

Mit csinál:

1. Klónozza mindhárom repót a `~/.haszno/` mappába (`gh repo clone`-nal, ha a GitHub CLI be van jelentkezve, egyébként `git clone`-nal HTTPS-en)
2. Lefordítja a CLI-t és az MCP-szervert (`npm install && npm run build`)
3. `npm link`-kel globálisan elérhetővé teszi a `haszno` binárist (ha nem sikerül, `~/.local/bin/haszno` szimlinket hoz létre)
4. Regisztrálja az MCP-szervert a Claude Code-ban: `claude mcp add haszno --scope user -- node ~/.haszno/haszno-mcp/dist/index.js` (kihagyja, ha a `claude` nincs a PATH-on, vagy a `haszno` már regisztrálva van)
5. Átmásolja a skill fájlokat a `~/.claude/skills/haszno/` mappába

A telepítő nem állít be hitelesítési adatokat. A végén kiírja azt a két `export` sort (`HASZNO_API_URL`, `HASZNO_API_KEY`), amelyre a CLI-nek szüksége van.

> [!NOTE]
> A csomagok nincsenek közzétéve npm-en. Használd a fenti telepítőt, vagy a [CLI-referenciában](cli.md) és az [MCP-szerver](mcp.md) oldalon megadott GitHub-telepítési útvonalakat.

### Helyi forrás felülbírálása

```bash
HASZNO_SRC_DIR=~/Documents/medusa-shops/haszno-labs bash install.sh
```

### Eltávolítás

```bash
bash ~/.haszno/haszno-skill/install.sh --uninstall
```

Törli a `~/.haszno/` mappát, a `~/.local/bin/haszno` szimlinket, az `npm link`-et (ha tudja), a `~/.claude/skills/haszno/` mappát és az MCP-regisztrációt. A `~/.config/haszno/config.json` fájlt nem törli.

## Mi működik hitelesítés nélkül

A `https://haszno.com` demó néhány nyilvános, csak olvasásos végpontot hitelesítés nélkül, szintetikus adatokkal szolgál ki. A többi végpont `401`-et ad.

> [!NOTE]
> A nyilvános demón minden ár, SKU és piaci adat szintetikus. Csak az `/api/settings` és az `/api/impact` válaszában van `"demo": true` mező. Lásd a [Hitelesítés](authentication.md) oldalt valódi adatokhoz való hozzáférésért.

| Képesség | Hitelesítés nélkül (demó) | Hitelesítés szükséges |
|---|---|---|
| Kategóriák listázása | Igen | — |
| Termékek listázása árral és piaci összehasonlítással | Igen | — |
| Irányítópult-összesítő, Haszon-mérő, árazási beállítások | Igen | — |
| Rendelések és árjavaslatok megtekintése | Igen (üres listák) | — |
| Hálózati beszállítók böngészése vagy keresés a partnerkatalógusban | — | Igen |
| Szabályok, automatizálási állapot, termékötletek megtekintése | — | Igen |
| Beállítások vagy árak módosítása | — | Igen |
| Javaslatok jóváhagyása vagy elutasítása | — | Igen |
| Termékek küldése webshopba | — | Igen |
| Automatizálási szabályok létrehozása vagy futtatása | — | Igen |

## Biztonsági modell

Az olvasó eszközök és listázó parancsok mindig biztonságosak – nyugodtan hívd őket anélkül, hogy megkérdeznéd.

Minden adatmódosító parancs kifejezett megerősítést kér:

- **Az MCP-szerverben**: add át a `"confirm": true` argumentumot az eszközhívásban. Nélküle az írási eszközök előnézeti leírást adnak vissza, és nem hívják az API-t.
- **A CLI-ben**: add meg a `--yes`-t. Nélküle az árjavaslat-, szabály-, importlista-kiküldési és partnerparancsok előnézetet írnak ki, és semmit nem változtatva kilépnek; a fiók-, termék-, feed-, ötlet- és rendelésmódosító parancsok interaktív kérdéssel kérnek megerősítést. Kivétel a `haszno import add`: megerősítés nélkül ír. Lásd: [Írási parancsok és megerősítés](cli.md#write-confirmation).

Minden tömeges írás előtt (javaslatok jóváhagyása, szabályok futtatása) ellenőrizd az automatizálás kill switch-ét:

```bash
haszno rules automation --json
# or via MCP: haszno_automation_get
```

Ha a `paused` értéke `true`, ne hagyj jóvá javaslatokat és ne futtass szabályokat – először tájékoztasd a felhasználót.

Ha egy jóváhagyott javaslatbatch rossznak tűnik, hívd a `haszno proposals rollback --batch <batchId>` parancsot, vagy az `haszno_proposals_rollback` MCP-eszközt, mielőtt bármit csinálnál. A `batchId`-t a jóváhagyási parancs adja vissza.

## 5 perces gyors kezdés

### 1. lépés – telepítés

```bash
curl -fsSL https://raw.githubusercontent.com/haszno-labs/haszno-skill/main/install.sh | bash
```

Telepítés után indítsd újra a shelledet (vagy nyiss új terminált).

### 2. lépés – kapcsolat ellenőrzése

```bash
haszno account ping
```

Hitelesítés nem szükséges. Várt kimenet:

```
API: OK elérhető
```

### 3. lépés – az első olvasási parancs

Az irányítópult-összesítő kiírása – nem kell hitelesítés:

```bash
haszno account stats --json
```

Ha később a saját adataiddal dolgoznál, futtasd egyszer a `haszno login` parancsot: az API URL-t és a kulcsot a `~/.config/haszno/config.json` fájlba menti, amelyet a CLI és az MCP-szerver is olvas. Szkriptekben inkább exportáld a `HASZNO_API_KEY`-t (lásd: [CLI-beállítás](cli.md#configuration)).

### 4. lépés – kérdezd meg Claude-ot

Az MCP-szerver regisztrálásával nyiss meg egy Claude Code-munkamenetet, és próbáld ki:

> „Listázd a Haszno legfelső kategóriáit, és mutasd az egyes kategóriák termékszámát!"

> „Mik az aktuális árazási beállításaim?"

> „Mi az aktuális árhatás-összesítő?"

A Claude Code magától is betöltheti a skillt, ha megemlíted a Hasznót, a dropshippinget vagy kapcsolódó témákat.

## Géppel olvasható dokumentáció

### llms.txt

Minden dokumentációs oldal strukturált indexe:

```
https://docs.haszno.com/llms.txt
```

Ez az [llms.txt](https://llmstxt.org/) konvenciót követi. Azok az AI-agentek, amelyek kérdések megválaszolása előtt beolvassák a dokumentációt, ezt a fájlt kérjék le először, hogy megismerjék a rendelkezésre álló oldalakat.

### llms-full.txt

Egyetlen fájl, amely minden oldal teljes Markdown-tartalmát tartalmazza:

```
https://docs.haszno.com/llms-full.txt
```

Hasznos olyan agenteknek, amelyeknek egyetlen HTTP-kéréssel kell megszerezniük a teljes dokumentációt.

### Markdown-tükrök

Minden HTML-oldal rendelkezik egy egyszerű Markdown-tükörrel, ugyanazon az útvonalon `.md` kiterjesztéssel:

```
https://docs.haszno.com/en/agents.md
https://docs.haszno.com/en/cli.md
https://docs.haszno.com/en/mcp.md
https://docs.haszno.com/en/skill.md
```

Minden HTML-oldal bejelenti a tükrét egy HTTP `Link:` válaszfejléccel is:

```
Link: </en/agents.md>; rel="alternate"; type="text/markdown"
```

### Oldalmásolás

Minden oldalon van egy **Oldal másolása** gomb, amely a vágólapra írja az oldal Markdown-tartalmát. Böngészőbe ágyazott agentekben használd, hogy HTML renderelése nélkül olvasd be az aktuális oldalt.

## Lásd még

- [CLI-referencia](cli.md) – teljes parancshivatkozás az összes flaggel és példával
- [MCP-szerver](mcp.md) – teljes eszközhivatkozás bemeneti és kimeneti sémákkal
- [Agent skill](skill.md) – mit tanít a skill, biztonsági szabályok, munkafolyamat-receptek
- [Hitelesítés](authentication.md) – hogyan szerezhetsz API-hozzáférést a demón túl