@keypro/cli

Parancssori eszköz és MCP-szerver a KeyPro.hu B2B szoftverlicenc-webshophoz: rendelés leadása, visszamondása, fizetési mód módosítása, rendelések / számlák / termékkulcsok lekérdezése, KEP-egyenleg és profil kezelése. Regisztrált (jóváhagyott) viszonteladó fiók szükséges.

AI-ügynök barát: minden parancs támogatja a --json kimenetet, és a keypro mcp beépített MCP stdio szerverként natív tool-okat ad a ChatGPT, Claude, Gemini, Codex, OpenCode, Antigravity és más MCP-kompatibilis ügynököknek.

Biztonság és átláthatóság

• Nyílt forrás. Ez a repó a teljes forráskód — ellenőrizhető, hogy a csomag semmi rejtettet nem tartalmaz.
• Vékony kliens. Csak a HTTP API-t hívja; nincs benne titok, nincs telemetria, nem gyűjt és nem küld semmit rajtad kívül máshova.
• Csak az általad megadott szerverhez beszél (alap: https://keypro.hu).
• A kulcs a tiéd. Authorization: Bearer fejlécben megy, te hozod létre és bármikor visszavonhatod a fiókod /mcp-cli oldalán.
• Provenance. Az npm csomag GitHub Actions-ből, --provenance jelöléssel publikálódik, így kriptográfiailag igazolható, hogy a közzétett csomag ebből a forrásból, ebből a commitból épült.

Telepítés

npm install -g @keypro/cli

Node.js 20+ szükséges.

Gyors kezdés

keypro setup

A setup végigvezet: megkérdezi a szervert, majd a hitelesítést — API kulcs (ajánlott) vagy email + jelszó. Utána:

keypro whoami
keypro products search windows --limit 5

Hitelesítés

Négyféleképp adhatod meg a kulcsot (erősebb elöl):

keypro --api-key kp_live_... whoami        # per-parancs kapcsoló
export KEYPRO_API_KEY=kp_live_...           # környezeti változó (agentnek jó)
keypro config set api-key kp_live_...        # elmenti a configba
keypro login                                 # email + jelszó -> új kulcsot ment

• Kulcsot a weben a fiók MCP és CLI (/mcp-cli) oldalán készíthetsz, scope-okkal (olvasás / rendelés / profil) és lejárattal.
• A config a ~/.config/keypro/config.json fájlban van (0600 jog).

Szerver (API cím)

Alapértelmezés a production (https://keypro.hu). Váltás:

keypro config set api-base https://dev.keypro.hu
# vagy: KEYPRO_API_BASE=https://dev.keypro.hu, vagy --api-base

Parancsok

| Parancs | Leírás | |---|---| | keypro setup | interaktív beállítás (szerver + hitelesítés) | | keypro whoami | a bejelentkezett fiók adatai | | keypro rate | aktuális EUR/HUF árfolyam (amit a shop használ) | | keypro products search <szó> / products get <sku\|id> | termékkeresés / részletek | | keypro order preview --item <sku>=<db> --payment <mód> | rendelés előnézete (összegek + confirmToken) | | keypro order create --item ... --payment ... --yes | rendelés leadása | | keypro order list [--status ...] / order get <id> | rendelések | | keypro order cancel <id> | fizetetlen rendelés visszamondása | | keypro order change-payment <id> --payment <mód> [--yes] | fizetési mód módosítása | | keypro keys list [--order <id>] | kézbesített termékkulcsok | | keypro invoices list [--order <id>] / invoices get <id> | számlák / díjbekérők (PDF link) | | keypro wallet [transactions] | KEP-egyenleg + tranzakciók | | keypro profile get / profile set billing.city=... | profil | | keypro cards list | mentett bankkártyák | | keypro parcelshops search <város\|irsz> | GLS csomagpontok | | keypro key list / config get / logout | kulcsok, config, kijelentkezés | | keypro agent-docs | részletes AI-ügynök útmutató (stdout) |

Fizetési módok: bacs (átutalás / díjbekérő), cheque (8 napos, +5%), cod (utánvét), wallet (KEP-egyenleg), stripe (bankkártya).

Rendelés-biztonság: a create és a change-payment mindig előnézetet kér (összegekkel) és csak a preview-ból származó confirmToken-nel hajtódik végre, így véletlen rendelés nem történhet.

Gépi (JSON) kimenet

Minden parancs támogatja a --json-t: a stdout-ra gépi adat, a hibák a stderr-re mennek stabil error.code-dal (snake_case, angol). Példa:

keypro --json whoami

MCP (AI ügynök) bekötés

Bármely MCP-kompatibilis ügynök (Claude, ChatGPT, Codex, Gemini CLI, OpenCode, Antigravity ...) natív tool-ként éri el a KeyPro-t a helyi (stdio) MCP szerveren keresztül:

npx -y @keypro/cli mcp

Példák a regisztrációra:

Claude Code:

claude mcp add keypro -- npx -y @keypro/cli mcp

Claude Desktop (Settings → Developer → Edit Config) — a legtöbb kliens hasonló mcpServers configot használ:

{
  "mcpServers": {
    "keypro": { "command": "npx", "args": ["-y", "@keypro/cli", "mcp"] }
  }
}

Az MCP a beállított kulcsot (keypro setup / config / KEYPRO_API_KEY) használja. Webes ügynököknek (ChatGPT, claude.ai) a shop külön távoli MCP connectort ad (OAuth-tal); azt a fiókod /mcp-cli oldala írja le.

Fejlesztés

pnpm install
pnpm build        # tsup -> dist/
pnpm typecheck
pnpm test         # vitest

Ez a repó generált másolat. A forrás a KeyPro webshop privát monorepójában él (cli/), és onnan írja felül a kiadási szkript (pnpm cli:release), hogy a webshop beépített MCP-végpontja és az npm-re kiadott csomag garantáltan ugyanazt a kódot futtassa. Kézzel itt ne szerkessz: a következő kiadás felülírja. Hibajelentést és javaslatot issue-ban várunk.

Licenc

MIT — lásd LICENSE.