--- title: "ThunderPhone CLI" description: "Jelentkezzen be, kezelje a hangalapú AI-ügynököket és a hívásokat, konfigurálja az MCP-klienseket, és hozzon létre projektvázakat a terminálból." --- A CLI Node.js 18.18-as vagy újabb verziót igényel. Futtassa `npx` használatával, vagy telepítse globálisan: ```bash npm install -g thunderphone thunderphone --help ``` ## Bejelentkezés ```bash npx thunderphone login thunderphone whoami --json ``` A bejelentkezés kiír egy ellenőrző kódot, megnyitja a böngészőt, majd engedélyezésre vár. Grafikus felület nélküli gépen használja a `--no-browser` kapcsolót, és máshol nyissa meg a kiírt URL-t. Az eszközös bejelentkezéshez szükség van az API OAuth eszközfolyamatának bevezetésére. A `THUNDERPHONE_API_KEY` változóban megadott szervezeti API-kulcs is hitelesítheti a parancsokat, és elsőbbséget élvez a tárolt bejelentkezési hitelesítő adatokkal szemben. A hitelesítő adatok profilok szerint a `~/.config/thunderphone/credentials.json` fájlban vannak tárolva, `0600` fájlmóddal. Az `XDG_CONFIG_HOME` és a `THUNDERPHONE_CONFIG_DIR` felülírja a könyvtárat. A hozzáférési tokenek automatikusan frissülnek, a forgó frissítési tokenek pedig atomikusan kerülnek mentésre. A bejelentkezés soha nem írja ki a tokeneket. ```bash thunderphone login --profile work thunderphone agents list --profile work --json thunderphone logout --profile work ``` A `THUNDERPHONE_PROFILE` állítja be az alapértelmezett profilt. A kijelentkezés eltávolítja a helyi hitelesítő adatokat; nem vonja vissza a szerveroldali engedélyezést. Az alapértelmezett API a `https://api.thunderphone.com`. Másik API használatához adja meg a `--api-base-url` kapcsolót vagy a `THUNDERPHONE_API_BASE_URL` változót. Egy profil tokenje nem küldhető el másik konfigurált API-URL-re; jelentkezzen be arra az URL-re külön profillal. ## Parancsok Minden parancs elfogadja a `--json` kapcsolót. A sikeres adatok a szabványos kimenetre kerülnek; a hibák nem nulla kilépési kóddal a szabványos hibakimenetre kerülnek. `--json` nélkül a kimenet tömör táblázat vagy mezőlista. A JSON megőrzi az API-válasz struktúráját, a hitelesítő adatok mezői azonban ki vannak takarva. Az MCP-kiszolgálás fenntartja a szabványos kimenetet az MCP-protokoll számára. | Parancs | Cél | | --- | --- | | `login [--no-browser] [--scope "scopes"]` | Engedélyezés eszközkódon keresztül | | `logout`, `whoami` | Helyi hitelesítő adatok eltávolítása; elérhető szervezetek listázása | | `agents list`, `agents get ID` | Ügynökök lekérése | | `agents create --file agent.json` | Ügynök létrehozása | | `agents update ID --file agent.json` | Ügynökpiszkozat mentése | | `agents deploy ID`, `agents delete ID` | Piszkozat üzembe helyezése; ügynök törlése | | `numbers list` | Telefonszámok lekérése | | `numbers provision --country US --area-code 415` | Amerikai bejövő telefonszám kiépítése | | `numbers assign NUMBER_ID --agent ID` | Bejövő hívásokhoz tartozó ügynök hozzárendelése | | `sms send TO --from FROM --body TEXT --idempotency-key KEY` | SMS küldése ügyfél által csatlakoztatott szolgáltatói számról biztonságos újrajátszással | | `sms list [--limit N]`, `sms get UUID` | SMS-rekordok listázása vagy vizsgálata | | `call TO --agent ID --from FROM [--wait]` | Kimenő hívás indítása; opcionálisan várakozás az átiratára | | `calls list [--limit N] [--agent ID]` | Hívások listázása (korlát: 1–200) | | `calls get ID`, `calls transcript ID` | Egy hívás vagy annak átiratának lekérése | | `test run AGENT_ID [--scenario ID] --consent-to-charge` | Díjköteles mentett forgatókönyvek futtatása a webcsatorna használatával | | `test status RUN_ID [--agent ID]` | Köteg vizsgálata, megadott ügynök esetén forgatókönyv-részletekkel | | `import VENDOR export.json` | Szolgáltatói JSON-import előkészítése ellenőrzésre | | `imports get UUID`, `imports commit UUID` | Import vizsgálata; a kiválasztott ügynökök véglegesítése ellenőrzés után | | `mcp setup`, `mcp serve` | Kliens konfigurálása; a stdio-híd elindítása | | `init [directory]` | Projektváz létrehozása | A kimenő hívásokhoz kimenő hívásokra engedélyezett szám szükséges. A `THUNDERPHONE_FROM_NUMBER` megadhatja a `--from` értékét. Az ügyfél VoIP-számai továbbra is támogatják a kimenő hívásokat. A ThunderPhone által kiépített számok kezdetben csak bejövő hívásokra használhatók; egy szervezeti rendszergazda kimenő hívást kérhet a Telefonos számok oldalon, ahol minden kérelmet manuálisan vizsgálnak felül. A `--wait` alapértelmezett időkorlátja egy óra; ennek módosításához állítsa be a `--timeout SECONDS` értékét. Az időkorlát lejárta leállítja a várakozást, de nem fejezi be a hívást. Az SMS-hez az Ön csatlakoztatott Twilio- vagy Telnyx-fiókján egy SMS-képes szám is szükséges. Soha nem küld SMS-t ThunderPhone tulajdonú számról. Idempotenciakulcsot csak pontosan ugyanazon feladó, címzett és üzenettörzs újrapróbálásakor használjon újra. Az importok támogatják a `vapi`, `retell`, `elevenlabs` és `bland` szolgáltatásokat. A második argumentum egy szolgáltatói JSON-export elérési útja, nem távoli szolgáltatói azonosító. Az API aszinkron módon készít elő egy leképezést; vizsgálja meg az `imports get UUID` paranccsal, és csak akkor véglegesítse, ha elkészült, és Ön átnézte a leképezett mezőket és figyelmeztetéseket. Lásd: [ügynökimportok](/hu/guides/import-agents). ## MCP beállítása ```bash thunderphone mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY thunderphone mcp setup --client codex --scope user --api-key-env THUNDERPHONE_API_KEY thunderphone mcp setup --client claude-desktop --scope user ``` Kliensprogramok: `claude-code`, `codex`, `cursor`, `vscode`, `gemini`, `claude-desktop` és `windsurf`. Alapértelmezés szerint a projekt hatóköre érvényes. A Desktop és a Windsurf felhasználói hatókört igényel. Hagyja el a `--client` paramétert, ha egyetlen klienst szeretne észlelni a projektből; a kétértelmű észlelés interaktívan kérdez rá, nem interaktív munkamenetben pedig utasításokkal sikertelen lesz. A beállítás kiírja az általa létrehozott fájlt, és megőrzi a nem kapcsolódó szervereket. A meglévő JSON-nak érvényes, szigorú JSON-nak kell lennie; a Codex TOML-értékei megmaradnak, de a megjegyzések formázása megváltozhat. A beállítás előnyben részesíti a közvetlen távoli HTTP-t. A `--api-key-env` használatával változóhivatkozást ír ki, soha nem magát a kulcsot. E nélkül a beállítás nélkül a közvetlen HTTP a kliens OAuth-támogatására támaszkodik; nem használja a CLI hitelesítőadat-fájlját. A `thunderphone login` hitelesítőadatainak újrahasználatához bármely stdio-kompatibilis kliensben használja az alábbit: ```json { "mcpServers": { "thunderphone": { "command": "npx", "args": ["-y", "@thunderphone/mcp"] } } } ``` A burkoló ellenőrzi a `THUNDERPHONE_API_KEY` változót, majd az aktuális CLI-profilt (szükség esetén frissítve), ezután pedig az OAuth-ot az `mcp-remote` számára delegálja. A `THUNDERPHONE_MCP_URL` felülírja a végpontot. Nem küld telemetriát. Az önálló beállítás a következővel is elérhető: `npx -y @thunderphone/mcp setup --client cursor`, illetve az `@thunderphone/mcp` globális telepítése után a `thunderphone-mcp setup` használatával. ## Projekt létrehozása ```bash npx create-thunderphone-agent my-receptionist npx create-thunderphone-agent my-outbound --template python --agent-type outbound # Equivalent: thunderphone init my-receptionist --template node --agent-type receptionist ``` A sablonok: `node` és `python`; az ügynöktípusok: `receptionist`, `outbound` és `custom`. Az alapértelmezett ügynök egy angol/spanyol fogászati recepciós, kifejezetten megadott demóadatokkal. A projektek tartalmaznak `agent.json` fájlt, telepítési szkripteket, MCP-konfigurációkat a Claude Code, Cursor és VS Code számára, ügynökutasításokat, `.env.example` fájlt és README-t. A projektváz létrehozása offline történik, és nem ír felül nem üres könyvtárat. Telepítés előtt szerkessze az üzleti adatokat. Exportálja az API-kulcsot, a csatlakoztatott hívószámot és a teszthívás címzettjét a létrehozott README-ben dokumentáltak szerint. Az `npm run deploy` vagy a `python deploy.py` létrehozza vagy frissíti az ügynököt, telepíti annak piszkozatát, és számlázható teszthívást indít. A szkriptek API-kulcsos hitelesítést használnak; a CLI és az stdio MCP-burkoló eszközös bejelentkezést is támogat. A Python-szkriptekhez Python 3.9 vagy újabb verzió szükséges.