Open in
ThunderPhone CLI
Prijavite se, upravljajte glasovnim agentima i pozivima, konfigurirajte MCP klijente i postavite kostur projekata iz terminala.
CLI zahtijeva Node.js 18.18 ili noviji. Pokrenite ga pomoću npx ili ga instalirajte globalno:
npm install -g thunderphone
thunderphone --helpPrijava
npx thunderphone login
thunderphone whoami --jsonPrijava ispisuje kontrolni kôd, otvara preglednik i čeka autorizaciju.
Na računalu bez grafičkog sučelja upotrijebite --no-browser i ispisani URL otvorite na drugom mjestu.
Prijava uređaja zahtijeva uvođenje OAuth tijeka za uređaje API-ja. Organizacijski API
ključ u THUNDERPHONE_API_KEY također može autentificirati naredbe i ima prednost
pred pohranjenim vjerodajnicama za prijavu.
Vjerodajnice se po profilima pohranjuju u ~/.config/thunderphone/credentials.json
s načinom rada datoteke 0600. Varijable XDG_CONFIG_HOME i THUNDERPHONE_CONFIG_DIR nadjačavaju
direktorij. Pristupni tokeni automatski se osvježavaju, a rotirajući tokeni za osvježavanje
spremaju se atomski. Tokeni se nikada ne ispisuju pri prijavi.
thunderphone login --profile work
thunderphone agents list --profile work --json
thunderphone logout --profile workTHUNDERPHONE_PROFILE postavlja zadani profil. Odjava uklanja lokalne vjerodajnice;
ne opoziva autorizaciju poslužitelja. Promjena ili ponovno postavljanje lozinke ili
promjena e-adrese računa opoziva je; ponovno pokrenite thunderphone login. Zadani API je https://api.thunderphone.com.
Za drugi API upotrijebite --api-base-url ili THUNDERPHONE_API_BASE_URL. Token profila
ne može se poslati na drugi konfigurirani API URL; prijavite se na taj URL putem zasebnog profila.
Naredbe
Svaka naredba prihvaća --json. Uspješni podaci šalju se na stdout; pogreške na stderr
s izlaznim kodom različitim od nule. Bez --json, izlaz je sažeta tablica ili popis polja.
JSON zadržava strukturu API odgovora, pri čemu su polja vjerodajnica skrivena. MCP poslužitelj
rezervira stdout za MCP protokol.
| Naredba | Svrha |
|---|---|
login [--no-browser] [--scope "scopes"] | Autorizirajte se putem koda uređaja |
logout, whoami | Uklonite lokalne vjerodajnice; prikažite dostupne organizacije |
agents list, agents get ID | Dohvatite agente |
agents create --file agent.json | Stvorite agenta |
agents update ID --file agent.json | Spremite skicu agenta |
agents deploy ID, agents delete ID | Objavite skicu; izbrišite agenta |
numbers list | Dohvatite telefonske brojeve |
numbers provision --country US --area-code 415 | Dodijelite američki broj za dolazne pozive |
numbers assign NUMBER_ID --agent ID | Dodijelite agenta za dolazne pozive |
sms send TO --from FROM --body TEXT --idempotency-key KEY | Pošaljite SMS putem broja operatera povezanog s korisnikom uz sigurno ponavljanje |
sms list [--limit N], sms get UUID | Prikažite ili pregledajte SMS zapise |
call TO --agent ID --from FROM [--wait] | Uputite odlazni poziv; po želji pričekajte njegov prijepis |
calls list [--limit N] [--agent ID] | Prikažite pozive (ograničenje 1–200) |
calls get ID, calls transcript ID | Dohvatite jedan poziv ili njegov prijepis |
test run AGENT_ID [--scenario ID] --consent-to-charge | Pokrenite spremljene scenarije koji se naplaćuju putem web-kanala |
test status RUN_ID [--agent ID] | Pregledajte skup, s pojedinostima scenarija kada je naveden agent |
import VENDOR export.json | Pripremite uvoz JSON-a dobavljača za pregled |
imports get UUID, imports commit UUID | Pregledajte uvoz; potvrdite odabrane agente nakon pregleda |
mcp setup, mcp serve | Konfigurirajte klijent; pokrenite stdio most |
init [directory] | Stvorite kostur projekta |
Odlazni pozivi zahtijevaju broj s omogućenim odlaznim pozivima. THUNDERPHONE_FROM_NUMBER može
navesti --from. Korisnički VoIP brojevi i dalje podržavaju odlazne pozive.
Brojevi koje je dodijelio ThunderPhone u početku podržavaju samo dolazne pozive; administrator organizacije može
zatražiti odlazne pozive na stranici Telefonski brojevi, gdje se svaki zahtjev
ručno pregledava. --wait prema zadanim postavkama ima vremensko ograničenje od jednog sata; postavite
--timeout SECONDS da biste ga promijenili. Istek vremena prekida čekanje bez završavanja poziva.
SMS također zahtijeva broj koji podržava SMS na vašem povezanom Twilio ili Telnyx računu. SMS se nikada ne šalje s broja u vlasništvu ThunderPhonea. Ključ idempotentnosti ponovno upotrijebite samo kada ponavljate potpuno istog pošiljatelja, primatelja i sadržaj poruke.
Uvozi podržavaju vapi, retell, elevenlabs i bland. Drugi argument je
put do izvoza JSON-a dobavljača, a ne udaljeni ID dobavljača. API asinkrono priprema mapiranje;
pregledajte ga s imports get UUID i potvrdite ga tek kada bude spremno
i kada pregledate mapirana polja i upozorenja. Pogledajte uvoze agenata.
Postavljanje MCP-a
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 userKlijenti: claude-code, codex, cursor, vscode, gemini, claude-desktop i
windsurf. Opseg projekta zadani je. Desktop i Windsurf zahtijevaju korisnički opseg.
Izostavite --client kako biste otkrili jednog klijenta iz projekta; dvosmisleno otkrivanje
interaktivno traži odabir ili ne uspijeva s uputama u neinteraktivnoj sesiji.
Postavljanje ispisuje datoteku koju je zapisalo i zadržava nepovezane poslužitelje. Postojeći JSON
mora biti valjan strogi JSON; vrijednosti Codex TOML-a zadržavaju se, ali komentari se mogu preoblikovati.
Postavljanje preferira izravni udaljeni HTTP. Uz --api-key-env zapisuje referencu
na varijablu, nikada ključ. Bez te opcije izravni HTTP oslanja se na podršku klijenta
za OAuth; ne koristi datoteku vjerodajnica CLI-ja. Za ponovnu upotrebu vjerodajnica iz thunderphone login
u bilo kojem klijentu koji podržava stdio, upotrijebite:
{
"mcpServers": {
"thunderphone": {
"command": "npx",
"args": ["-y", "@thunderphone/mcp"]
}
}
}Omotač provjerava THUNDERPHONE_API_KEY, zatim trenutačni CLI profil (osvježavajući ga
po potrebi), a zatim delegira OAuth na mcp-remote. THUNDERPHONE_MCP_URL nadjačava
krajnju točku. Ne šalje telemetriju. Samostalno postavljanje dostupno je i putem
npx -y @thunderphone/mcp setup --client cursor ili thunderphone-mcp setup nakon
globalne instalacije paketa @thunderphone/mcp.
Izradite 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 receptionistPredlošci su node i python; vrste agenata su receptionist, outbound i
custom. Zadani agent je englesko-španjolski stomatološki glasovni agent za prijem s eksplicitnim
činjenicama za demonstraciju. Projekti uključuju agent.json, skripte za implementaciju, MCP konfiguracije za
Claude Code, Cursor i VS Code, upute za agenta, .env.example i README.
Generiranje kostura radi izvan mreže i odbija prepisati neprazan direktorij.
Uredite poslovne činjenice prije implementacije. Izvezite API ključ, povezani broj
pozivatelja i primatelja testnog poziva kako je dokumentirano u generiranom README-u. npm run deploy
ili python deploy.py stvara ili ažurira agenta, implementira njegov nacrt i upućuje
naplativ testni poziv. Skripte koriste autentifikaciju API ključem; CLI i stdio MCP
omotač također podržavaju prijavu uređajem. Python skripte zahtijevaju Python 3.9 ili noviji.