ThunderPhone CLI

Prijavite se, upravljajte glasovne agente in klice, konfigurirajte odjemalce MCP ter ustvarite ogrodja projektov iz terminala.

CLI zahteva Node.js 18.18 ali novejšo različico. Zaženite ga z npx ali ga namestite globalno:

npm install -g thunderphone
thunderphone --help

Prijava#

npx thunderphone login
thunderphone whoami --json

Prijava izpiše kodo za preverjanje, odpre brskalnik in čaka na avtorizacijo. Na računalniku brez grafičnega vmesnika uporabite --no-browser in izpisani URL odprite drugje. Prijava z napravo zahteva uvedbo poteka OAuth za naprave v API-ju. Ključ API organizacije v THUNDERPHONE_API_KEY lahko prav tako preveri pristnost ukazov in ima prednost pred shranjenimi poverilnicami za prijavo.

Poverilnice so shranjene po profilih v ~/.config/thunderphone/credentials.json z načinom datoteke 0600. XDG_CONFIG_HOME in THUNDERPHONE_CONFIG_DIR preglasita imenik. Žetoni za dostop se samodejno osvežijo, rotirajoči žetoni za osvežitev pa se shranijo atomsko. Prijava nikoli ne izpiše žetonov.

thunderphone login --profile work
thunderphone agents list --profile work --json
thunderphone logout --profile work

THUNDERPHONE_PROFILE nastavi privzeti profil. Odjava odstrani lokalne poverilnice; ne prekliče odobritve na strežniku. Privzeti API je https://api.thunderphone.com. Za drug API uporabite --api-base-url ali THUNDERPHONE_API_BASE_URL. Žetona profila ni mogoče poslati na drug konfiguriran URL API-ja; v ta URL se prijavite z ločenim profilom.

Ukazi#

Vsak ukaz sprejme --json. Uspešni podatki se izpišejo v stdout; napake se izpišejo v stderr z izhodno kodo, ki ni nič. Brez --json je izhod strnjena tabela ali seznam polj. JSON ohrani strukturo odgovora API-ja, polja s poverilnicami pa so prikrita. Streženje MCP rezervira stdout za protokol MCP.

Odhodni klici zahtevajo povezano številko operaterja. THUNDERPHONE_FROM_NUMBER lahko zagotovi --from. Številke, ki jih zagotovi ThunderPhone, so samo za dohodne klice. --wait privzeto uporablja enourno časovno omejitev; za spremembo nastavite --timeout SECONDS. Časovna omejitev prekine čakanje, ne da bi končala klic.

Uvozi podpirajo vapi, retell, elevenlabs in bland. Drugi argument je pot do izvoza JSON ponudnika, ne oddaljeni ID ponudnika. API asinhrono pripravi preslikavo; preglejte jo z imports get UUID in jo uveljavite šele, ko je pripravljena ter ste pregledali preslikana polja in opozorila. Oglejte si uvoze agentov.

Nastavitev MCP#

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

Odjemalci: claude-code, codex, cursor, vscode, gemini, claude-desktop in windsurf. Obseg projekta je privzet. Desktop in Windsurf zahtevata uporabniški obseg. Izpustite --client, da zaznate enega odjemalca iz projekta; dvoumno zaznavanje interaktivno zahteva vnos ali pa v neinteraktivni seji ne uspe z navodili. Nastavitev izpiše datoteko, ki jo je zapisala, in ohrani nepovezane strežnike. Obstoječi JSON mora biti veljaven strogi JSON; vrednosti TOML za Codex se ohranijo, vendar se lahko komentarji preoblikujejo.

Nastavitev daje prednost neposrednemu oddaljenemu HTTP. Z možnostjo --api-key-env zapiše sklic na spremenljivko, nikoli ključa. Brez te možnosti se neposredni HTTP zanaša na podporo odjemalca za OAuth; ne uporablja datoteke s poverilnicami CLI. Za ponovno uporabo poverilnic thunderphone login v katerem koli odjemalcu, ki podpira stdio, uporabite:

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

Ovijalnik preveri THUNDERPHONE_API_KEY, nato trenutni profil CLI (po potrebi ga osveži), nato pa OAuth prepusti paketu mcp-remote. THUNDERPHONE_MCP_URL preglasi končno točko. Ne pošilja telemetrije. Samostojna nastavitev je na voljo tudi prek npx -y @thunderphone/mcp setup --client cursor ali thunderphone-mcp setup po globalni namestitvi @thunderphone/mcp.

Ustvarite projekt#

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

Predlogi so node in python; vrste agentov so receptionist, outbound in custom. Privzeti agent je angleško-španski zobozdravstveni recepcijski agent z izrecnimi dejstvi za predstavitev. Projekti vključujejo agent.json, skripte za uvedbo, konfiguracije MCP za Claude Code, Cursor in VS Code, navodila za agenta, .env.example in datoteko README. Generiranje ogrodja deluje brez povezave in ne dovoli prepisovanja nepraznega imenika.

Pred uvedbo uredite poslovna dejstva. Izvozite ključ API, povezano številko klicatelja in prejemnika testnega klica, kot je opisano v ustvarjeni datoteki README. npm run deploy ali python deploy.py ustvari ali posodobi agenta, uvede njegov osnutek in opravi obračunljiv testni klic. Skripte uporabljajo preverjanje pristnosti s ključem API; CLI in ovijalnik MCP stdio podpirata tudi prijavo z napravo. Skripte Python zahtevajo Python 3.9 ali novejši.