ThunderPhone CLI

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

CLI nõuab Node.js-i versiooni 18.18 või uuemat. Käivita see npx-iga 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 ilma graafilise liideseta 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äsklusi autentida ja sellel on salvestatud sisselogimisandmete ees eelis.

Autentimisandmed salvestatakse profiili järgi faili ~/.config/thunderphone/credentials.json failirežiimiga 0600. Muutujad XDG_CONFIG_HOME ja THUNDERPHONE_CONFIG_DIR asendavad kataloogi. Juurdepääsutõendeid värskendatakse automaatselt ning vahelduvad värskendustõendid salvestatakse atomaarselt. Sisselogimine ei kuva tõendeid kunagi.

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

THUNDERPHONE_PROFILE määrab vaikimisi profiili. Väljalogimine eemaldab kohalikud autentimisandmed; see ei tühista serveripoolset volitust. Vaikimisi API on https://api.thunderphone.com. Teise API jaoks kasuta --api-base-url või THUNDERPHONE_API_BASE_URL. Profiili tõendit ei saa saata teisele seadistatud API URL-ile; logi sellele URL-ile sisse eraldi profiiliga.

Käsklused#

Iga käsklus 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 ning autentimisandmete väljad varjatakse. MCP teenindamine reserveerib stdouti MCP-protokolli jaoks.

Väljaminevad kõned nõuavad ühendatud operaatorinumbrit. THUNDERPHONE_FROM_NUMBER võib anda väärtuse --from jaoks. ThunderPhone'i kaudu hangitud numbrid on ainult sissetulevate kõnede jaoks. --wait vaikimisi ajalõpp on üks tund; selle muutmiseks määra --timeout SECONDS. Ajalõpp lõpetab ootamise, kuid ei lõpeta kõnet.

Import toetab teenusepakkujaid vapi, retell, elevenlabs ja bland. Teine argument on teenusepakkuja JSON-ekspordi failitee, mitte kaugteenusepakkuja ID. API valmistab vastenduse ette asünkroonselt; kontrolli seda käsuga imports get UUID ja kinnita import alles siis, kui see on valmis ning oled vastendatud väljad ja hoiatused üle vaadanud. Vaata häälagentide 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 kasutajaulatust. Jäta --client välja, et tuvastada projektist üks klient; mitmetähenduslik tuvastamine küsib interaktiivselt või nurjub mitteinteraktiivses seansis koos juhistega. Seadistamine kuvab kirjutatud faili ja säilitab mitteseotud serverid. Olemasolev JSON peab olema kehtiv range JSON; Codexi TOML-väärtused säilitatakse, kuid kommentaaride vormindust võidakse muuta.

Seadistamine eelistab otsest kaug-HTTP-d. Valikuga --api-key-env kirjutab see muutujaviite, mitte kunagi võtit. Ilma selle valikuta tugineb otsene HTTP kliendi OAuthi toele; 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 väärtust, seejärel praegust CLI profiili (vajadusel värskendades) ning delegeerib OAuthi mcp-remote-ile. 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 paketi @thunderphone/mcp globaalset installimist käsuga thunderphone-mcp setup.

Loo 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

Mallid on node ja python; agenditüübid on receptionist, outbound ja custom. Vaikeagent on inglise- ja hispaaniakeelne hambaravi vastuvõtu häälagent, millel on selgelt määratletud demofaktid. Projektid sisaldavad faile agent.json, juurutusskripte, Claude Code'i, Cursori ja VS Code'i MCP-konfiguratsioone, agendi juhiseid, faili .env.example ja README-d. Projektiskeleti loomine toimub võrguühenduseta ega kirjuta mittetühja kataloogi üle.

Muuda ettevõtte faktid enne juurutamist. Ekspordi API-võti, ühendatud helistajanumber ja testi vastuvõtja vastavalt loodud README dokumentatsioonile. npm run deploy või python deploy.py loob või uuendab agendi, juurutab selle mustandi ja teeb tasulise testkõne. Skriptid kasutavad API-võtmega autentimist; CLI ja stdio MCP ümbris toetavad ka seadme kaudu sisselogimist. Pythoni skriptid nõuavad Pythonit 3.9 või uuemat.