---
title: "ThunderPhone CLI"
description: "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:

```bash
npm install -g thunderphone
thunderphone --help
```

## Logi sisse

```bash
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.

```bash
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.

| Käsklus | Eesmärk |
| --- | --- |
| `login [--no-browser] [--scope "scopes"]` | Autoriseeri seadmekoodi kaudu |
| `logout`, `whoami` | Eemalda kohalikud autentimisandmed; kuva ligipääsetavad organisatsioonid |
| `agents list`, `agents get ID` | Vaata häälagente |
| `agents create --file agent.json` | Loo häälagent |
| `agents update ID --file agent.json` | Salvesta häälagendi mustand |
| `agents deploy ID`, `agents delete ID` | Juuruta mustand; kustuta häälagent |
| `numbers list` | Vaata telefoninumbreid |
| `numbers provision --country US --area-code 415` | Hangi USA sissetulev number |
| `numbers assign NUMBER_ID --agent ID` | Määra sissetuleva kõne häälagent |
| `call TO --agent ID --from FROM [--wait]` | Tee väljaminev kõne; soovi korral oota selle transkriptsiooni |
| `calls list [--limit N] [--agent ID]` | Kuva kõned (piirang 1–200) |
| `calls get ID`, `calls transcript ID` | Vaata üht kõnet või selle transkriptsiooni |
| `test run AGENT_ID [--scenario ID] --consent-to-charge` | Käivita tasulised salvestatud stsenaariumid veebikanali abil |
| `test status RUN_ID [--agent ID]` | Kontrolli paketti; häälagendi määramisel kuva stsenaariumi üksikasjad |
| `import VENDOR export.json` | Valmista teenusepakkuja JSON-import ülevaatamiseks ette |
| `imports get UUID`, `imports commit UUID` | Kontrolli importi; kinnita pärast ülevaatust valitud häälagendid |
| `mcp setup`, `mcp serve` | Seadista klient; käivita stdio-sild |
| `init [directory]` | Loo projekti põhistruktuur |

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](/et/guides/import-agents).

## MCP-i seadistamine

```bash
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:

```json
{
  "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

```bash
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.