Open in
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 --helpPrijava
npx thunderphone login
thunderphone whoami --jsonPrijava izpiše potrditveno kodo, odpre brskalnik in čaka na avtorizacijo.
Na napravi brez grafičnega vmesnika uporabite --no-browser in izpisani URL odprite drugje.
Prijava naprave zahteva uvedbo poteka OAuth za naprave v API-ju. Ključ API organizacije
v THUNDERPHONE_API_KEY lahko prav tako overi ukaze in ima prednost pred
shranjenimi prijavnimi podatki.
Prijavni podatki so shranjeni 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, rotacijski ž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 workTHUNDERPHONE_PROFILE nastavi privzeti profil. Odjava odstrani lokalne poverilnice;
ne prekliče pa odobritve na strežniku. Sprememba ali ponastavitev gesla oziroma
sprememba e-poštnega naslova računa odobritev prekliče; znova zaženite thunderphone login. 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 neničelno izhodno kodo. Brez --json je izhod strnjena tabela ali seznam polj.
JSON ohrani strukturo odgovora API-ja, pri čemer so polja s poverilnicami redigirana. Streženje MCP
rezervira stdout za protokol MCP.
| Ukaz | Namen |
|---|---|
login [--no-browser] [--scope "scopes"] | Avtorizirajte se s kodo naprave |
logout, whoami | Odstranite lokalne poverilnice; navedite dostopne organizacije |
agents list, agents get ID | Preberite agente |
agents create --file agent.json | Ustvarite agenta |
agents update ID --file agent.json | Shranite osnutek agenta |
agents deploy ID, agents delete ID | Objavite osnutek; izbrišite agenta |
numbers list | Preberite telefonske številke |
numbers provision --country US --area-code 415 | Zagotovite dohodno številko v ZDA |
numbers assign NUMBER_ID --agent ID | Dodelite dohodnega agenta |
sms send TO --from FROM --body TEXT --idempotency-key KEY | Pošljite SMS prek številke operaterja, povezanega s stranko, z varnim ponovnim predvajanjem |
sms list [--limit N], sms get UUID | Navedite ali preglejte zapise SMS |
call TO --agent ID --from FROM [--wait] | Opravite odhodni klic; po želji počakajte na njegov prepis |
calls list [--limit N] [--agent ID] | Navedite klice (omejitev 1–200) |
calls get ID, calls transcript ID | Preberite en klic ali njegov prepis |
test run AGENT_ID [--scenario ID] --consent-to-charge | Zaženite plačljive shranjene scenarije prek spletnega kanala |
test status RUN_ID [--agent ID] | Preglejte paket s podrobnostmi scenarija, kadar je naveden agent |
import VENDOR export.json | Pripravite uvoz JSON od ponudnika za pregled |
imports get UUID, imports commit UUID | Preglejte uvoz; po pregledu potrdite izbrane agente |
mcp setup, mcp serve | Konfigurirajte odjemalca; zaženite most stdio |
init [directory] | Ustvarite osnovno strukturo projekta |
Odhodni klici zahtevajo številko z omogočenimi odhodnimi klici. THUNDERPHONE_FROM_NUMBER lahko
zagotovi --from. VoIP-številke strank še naprej podpirajo odhodne klice.
Številke, ki jih zagotovi ThunderPhone, so sprva samo dohodne; skrbnik organizacije lahko
zahteva odhodne klice na strani Telefonske številke, kjer se vsaka zahteva
pregleda ročno. Privzeta vrednost --wait je enourna časovna omejitev; nastavite
--timeout SECONDS, da jo spremenite. Časovna omejitev preneha čakati, ne da bi končala klic.
SMS zahteva tudi številko, ki podpira SMS, v vašem povezanem računu Twilio ali Telnyx. Nikoli ne pošilja s številke v lasti ThunderPhone. Ključ idempotentnosti znova uporabite le pri ponovnem poskusu s popolnoma enakim pošiljateljem, prejemnikom in besedilom.
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 potrdite š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 userOdjemalci: 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 izbiro 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 --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. Če želite poverilnice iz thunderphone login
znova uporabiti 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 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 receptionistPredlogi so node in python; vrste agentov so receptionist, outbound in
custom. Privzeti agent je angleško-španski zobozdravstveni receptor 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 README.
Ustvarjanje ogrodja deluje brez povezave in ne dovoli prepisovanja nepraznega imenika.
Pred uvedbo uredite podatke o podjetju. Izvozite ključ API, povezano številko
klicatelja in prejemnika za testiranje, kot je dokumentirano v ustvarjenem README. npm run deploy
ali python deploy.py ustvari ali posodobi agenta, uvede njegov osnutek in izvede
plačljiv testni klic. Skripte uporabljajo preverjanje pristnosti s ključem API; CLI in ovijalnik MCP
za stdio podpirata tudi prijavo z napravo. Skripte Python zahtevajo Python 3.9 ali novejši.