---
title: "ThunderPhone CLI"
description: "Prihláste sa, spravujte hlasových agentov a hovory, konfigurujte klientov MCP a vytvárajte kostry projektov z terminálu."
---

CLI vyžaduje Node.js 18.18 alebo novší. Spustite ho pomocou `npx` alebo ho nainštalujte globálne:

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

## Prihlásenie

```bash
npx thunderphone login
thunderphone whoami --json
```

Prihlásenie vytlačí overovací kód, otvorí prehliadač a čaká na autorizáciu.
Na zariadení bez grafického rozhrania použite `--no-browser` a vytlačenú URL otvorte inde.
Prihlásenie zariadenia vyžaduje nasadenie OAuth toku zariadenia API. Príkazy môže
autentifikovať aj kľúč API organizácie v `THUNDERPHONE_API_KEY`, ktorý má prednosť
pred uloženými prihlasovacími údajmi.

Prihlasovacie údaje sa ukladajú podľa profilov do `~/.config/thunderphone/credentials.json`
s režimom súboru `0600`. Premenné `XDG_CONFIG_HOME` a `THUNDERPHONE_CONFIG_DIR` nahrádzajú
adresár. Prístupové tokeny sa obnovujú automaticky a rotujúce obnovovacie tokeny sa
ukladajú atómovo. Prihlásenie nikdy nevytlačí tokeny.

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

`THUNDERPHONE_PROFILE` nastavuje predvolený profil. Odhlásenie odstráni miestne prihlasovacie údaje;
nezruší oprávnenie na serveri. Predvolené API je `https://api.thunderphone.com`.
Pre iné API použite `--api-base-url` alebo `THUNDERPHONE_API_BASE_URL`. Token profilu
nemožno odoslať na inú nakonfigurovanú URL API; do tejto URL sa prihláste pomocou samostatného profilu.

## Príkazy

Každý príkaz prijíma `--json`. Úspešné údaje sa odosielajú na stdout; chyby na stderr
s nenulovým návratovým kódom. Bez `--json` je výstup kompaktná tabuľka alebo zoznam polí.
JSON zachováva štruktúru odpovede API s redigovanými poľami prihlasovacích údajov. Obsluha MCP
vyhradzuje stdout pre protokol MCP.

| Príkaz | Účel |
| --- | --- |
| `login [--no-browser] [--scope "scopes"]` | Autorizovať pomocou kódu zariadenia |
| `logout`, `whoami` | Odstrániť miestne prihlasovacie údaje; zobraziť dostupné organizácie |
| `agents list`, `agents get ID` | Zobraziť agentov |
| `agents create --file agent.json` | Vytvoriť agenta |
| `agents update ID --file agent.json` | Uložiť koncept agenta |
| `agents deploy ID`, `agents delete ID` | Nasadiť koncept; odstrániť agenta |
| `numbers list` | Zobraziť telefónne čísla |
| `numbers provision --country US --area-code 415` | Zriadiť prichádzajúce číslo v USA |
| `numbers assign NUMBER_ID --agent ID` | Priradiť prichádzajúceho agenta |
| `call TO --agent ID --from FROM [--wait]` | Uskutočniť odchádzajúci hovor; voliteľne čakať na jeho prepis |
| `calls list [--limit N] [--agent ID]` | Zobraziť hovory (limit 1–200) |
| `calls get ID`, `calls transcript ID` | Zobraziť jeden hovor alebo jeho prepis |
| `test run AGENT_ID [--scenario ID] --consent-to-charge` | Spustiť spoplatnené uložené scenáre pomocou webového kanála |
| `test status RUN_ID [--agent ID]` | Skontrolovať dávku s podrobnosťami scenára po zadaní agenta |
| `import VENDOR export.json` | Pripraviť import JSON dodávateľa na kontrolu |
| `imports get UUID`, `imports commit UUID` | Skontrolovať import; po kontrole potvrdiť vybraných agentov |
| `mcp setup`, `mcp serve` | Nakonfigurovať klienta; spustiť most stdio |
| `init [directory]` | Vytvoriť základ projektu |

Odchádzajúce hovory vyžadujú číslo pripojeného poskytovateľa. `THUNDERPHONE_FROM_NUMBER` môže
poskytnúť `--from`. Čísla zriadené službou ThunderPhone sú len pre prichádzajúce hovory. Predvolená hodnota `--wait`
je časový limit jedna hodina; na jeho zmenu nastavte `--timeout SECONDS`. Časový limit prestane čakať
bez ukončenia hovoru.

Importy podporujú `vapi`, `retell`, `elevenlabs` a `bland`. Druhý argument je
cesta k exportu JSON dodávateľa, nie vzdialené ID dodávateľa. API pripravuje mapovanie
asynchrónne; skontrolujte ho pomocou `imports get UUID` a potvrďte ho až po jeho pripravení
a po kontrole namapovaných polí a upozornení. Pozrite si [importy agentov](/sk/guides/import-agents).

## Nastavenie MCP

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

Klienti: `claude-code`, `codex`, `cursor`, `vscode`, `gemini`, `claude-desktop` a
`windsurf`. Predvolené je nastavenie na úrovni projektu. Desktop a Windsurf vyžadujú rozsah používateľa.
Vynechajte `--client`, ak chcete z projektu zistiť jedného klienta; pri nejednoznačnej detekcii
sa zobrazí interaktívna výzva alebo relácia bez interakcie zlyhá s pokynmi.
Nastavenie vypíše súbor, ktorý zapísalo, a zachová nesúvisiace servery. Existujúci JSON
musí byť platný striktne podľa JSON; hodnoty TOML pre Codex sa zachovajú, ale komentáre môžu byť preformátované.

Nastavenie uprednostňuje priame vzdialené HTTP. S `--api-key-env` zapíše odkaz na premennú,
nikdy nie kľúč. Bez tejto možnosti sa priame HTTP spolieha na podporu
OAuth klienta; nepoužíva súbor poverení CLI. Ak chcete znova použiť poverenia z `thunderphone login`
v ľubovoľnom klientovi podporujúcom stdio, použite:

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

Obálka kontroluje `THUNDERPHONE_API_KEY`, potom aktuálny profil CLI (v prípade potreby ho obnoví)
a následne deleguje OAuth na `mcp-remote`. `THUNDERPHONE_MCP_URL` prepíše
koncový bod. Neodosiela žiadnu telemetriu. Samostatné nastavenie je dostupné aj cez
`npx -y @thunderphone/mcp setup --client cursor` alebo `thunderphone-mcp setup` po
globálnej inštalácii `@thunderphone/mcp`.

## Vytvorenie projektu

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

Šablóny sú `node` a `python`; typy agentov sú `receptionist`, `outbound` a
`custom`. Predvolený agent je anglicko-španielsky zubný recepčný s explicitnými
ukážkovými údajmi. Projekty obsahujú `agent.json`, skripty na nasadenie, konfigurácie MCP pre
Claude Code, Cursor a VS Code, pokyny pre agenta, `.env.example` a README.
Generovanie kostry funguje offline a odmietne prepísať neprázdny adresár.

Pred nasadením upravte obchodné údaje. Exportujte kľúč API, pripojené číslo volajúceho
a príjemcu testu podľa pokynov vo vygenerovanom README. `npm run deploy`
alebo `python deploy.py` vytvorí alebo aktualizuje agenta, nasadí jeho koncept a uskutoční
spoplatnený testovací hovor. Skripty používajú autentifikáciu pomocou kľúča API; CLI a stdio MCP
obálka podporujú aj prihlásenie zariadenia. Skripty v Pythone vyžadujú Python 3.9 alebo novší.