ThunderPhone CLI

Logi sisse, halda häälagente ja kõnesid, seadista MCP-kliente ning loo terminalist projektide alusstruktuure.

CLI nõuab Node.js-i versiooni 18.18 või uuemat. Käivita see npx abil või installi globaalselt:

npm install -g thunderphone
thunderphone --help

Logi sisse#

npx thunderphone login
thunderphone whoami --json

Sisselogimine kuvab kinnituskoodi, avab brauseri ja ootab autoriseerimist. Kasuta peata masinas --no-browser ja ava kuvatud URL mujal. Seadmega sisselogimine nõuab API OAuthi seadmevoo kasutuselevõttu. Organisatsiooni API-võti muutujas THUNDERPHONE_API_KEY saab samuti käske autentida ja on salvestatud sisselogimisandmete suhtes ülimuslik.

Sisselogimisandmed salvestatakse profiilipõhiselt faili ~/.config/thunderphone/credentials.json failirežiimiga 0600. XDG_CONFIG_HOME ja THUNDERPHONE_CONFIG_DIR alistavad kataloogi. Juurdepääsutokenid uuendatakse automaatselt ning roteeruvad värskendustokenid salvestatakse atomaarse toiminguga. Sisselogimine ei kuva tokeneid kunagi.

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

THUNDERPHONE_PROFILE määrab vaikeprofiili. Väljalogimine eemaldab kohalikud sisselogimisandmed; see ei tühista serveripoolset volitust. Parooli muutmine või lähtestamine või konto e-posti aadressi muutmine tühistab selle; käivita uuesti thunderphone login. Vaikimisi API on https://api.thunderphone.com. Teise API jaoks kasuta --api-base-url või THUNDERPHONE_API_BASE_URL. Profiili tunnust ei saa saata teisele seadistatud API URL-ile; logi sellele URL-ile sisse eraldi profiiliga.

Käsud#

Iga käsk aktsepteerib --json. Edukad andmed saadetakse stdouti; vead stderrisse nullist erineva väljumiskoodiga. Ilma --json-ita on väljund kompaktne tabel või väljade loend. JSON säilitab API vastuse struktuuri, kusjuures mandaadiväljad on varjatud. MCP teenindamisel on stdout reserveeritud MCP-protokolli jaoks.

Väljaminevate kõnede jaoks on vaja väljaminevate kõnede toega numbrit. THUNDERPHONE_FROM_NUMBER saab anda väärtuse suvandile --from. Kliendi VoIP-numbrid toetavad jätkuvalt väljaminevaid kõnesid. ThunderPhone'i hangitud numbrid on algselt ainult sissetulevate kõnede jaoks; organisatsiooni administraator saab taotleda väljaminevate kõnede lubamist Telefoninumbrite lehel, kus iga taotlus vaadatakse käsitsi üle. --wait kasutab vaikimisi ühe tunni pikkust ajalõppu; selle muutmiseks määra --timeout SECONDS. Ajalõpp lõpetab ootamise, kuid ei lõpeta kõnet.

SMS-i jaoks on vaja ka SMS-võimekusega numbrit sinu ühendatud Twilio või Telnyxi kontol. Seda ei saadeta kunagi ThunderPhone'ile kuuluvalt numbrilt. Kasuta idempotentsusvõtit uuesti ainult siis, kui proovid uuesti täpselt sama saatja, adressaadi ja sisuga.

Import toetab teenusepakkujaid vapi, retell, elevenlabs ja bland. Teine argument on tee teenusepakkuja JSON-ekspordini, mitte teenusepakkuja kaughalduse ID. API valmistab vastenduse asünkroonselt ette; vaata seda käsuga imports get UUID ja kinnita see alles siis, kui see on valmis ning oled vastendatud väljad ja hoiatused üle vaadanud. Vaata agendi importimist.

MCP-i seadistamine#

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

Kliendid: claude-code, codex, cursor, vscode, gemini, claude-desktop ja windsurf. Vaikimisi kasutatakse projekti ulatust. Desktop ja Windsurf nõuavad kasutaja ulatust. Ühe kliendi tuvastamiseks projektist jäta --client välja; mitmetähenduslik tuvastus küsib interaktiivselt või nurjub mitteinteraktiivses seansis koos juhistega. Seadistamine väljastab kirjutatud faili nime ja säilitab mitteseotud serverid. Olemasolev JSON peab olema kehtiv range JSON; Codexi TOML-väärtused säilitatakse, kuid kommentaaride vormindus võib muutuda.

Seadistamine eelistab otsest kaug-HTTP-d. Valikuga --api-key-env kirjutatakse muutuja viide, mitte kunagi võti. Ilma selle valikuta kasutab otsene HTTP kliendi OAuthi tuge; see ei kasuta CLI mandaadifaili. thunderphone login mandaatide taaskasutamiseks mis tahes stdio-toega kliendis kasuta järgmist:

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

Ümbris kontrollib THUNDERPHONE_API_KEY, seejärel praegust CLI profiili (vajadusel seda värskendades) ja delegeerib seejärel OAuthi teenusele mcp-remote. THUNDERPHONE_MCP_URL alistab lõpp-punkti. See ei saada telemeetriat. Eraldiseisev seadistamine on saadaval ka käsuga npx -y @thunderphone/mcp setup --client cursor või pärast @thunderphone/mcp globaalset installimist käsuga thunderphone-mcp setup.

Projekti loomine#

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

Mallid on node ja python; häälagendi tüübid on receptionist, outbound ja custom. Vaikimisi häälagent on inglise- ja hispaaniakeelne hambaravikliiniku vastuvõtuagent selgelt määratletud demofaktidega. Projektid sisaldavad faile agent.json, juurutusskripte, MCP seadistusi Claude Code'i, Cursor'i ja VS Code'i jaoks, häälagendi juhiseid, faili .env.example ja README-faili. Karkassi loomine toimub võrguühenduseta ega kirjuta üle mittetühja kataloogi.

Muuda enne juurutamist ettevõtte andmeid. Ekspordi API-võti, ühendatud helistajanumber ja testkõne saaja, nagu on kirjeldatud loodud README-failis. npm run deploy või python deploy.py loob või uuendab häälagendi, juurutab selle mustandi ja teeb arveldatava testkõne. Skriptid kasutavad API-võtmega autentimist; CLI ja stdio MCP ümbris toetavad ka seadmesse sisselogimist. Pythoni skriptid nõuavad Python 3.9 või uuemat versiooni.