ThunderPhone CLI

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:

npm install -g thunderphone
thunderphone --help

Bejelentkezés#

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.

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.

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.

MCP beállítása#

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:

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

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.