--- title: "ThunderPhone CLI" description: "Přihlaste se, spravujte hlasové agenty a hovory, konfigurujte klienty MCP a vytvářejte základní strukturu projektů z terminálu." --- CLI vyžaduje Node.js 18.18 nebo novější. Spusťte jej pomocí `npx` nebo jej nainstalujte globálně: ```bash npm install -g thunderphone thunderphone --help ``` ## Přihlášení ```bash npx thunderphone login thunderphone whoami --json ``` Přihlášení vypíše ověřovací kód, otevře prohlížeč a čeká na autorizaci. Na bezobslužném zařízení použijte `--no-browser` a vytištěnou adresu URL otevřete jinde. Přihlášení zařízení vyžaduje nasazení OAuth toku zařízení pro rozhraní API. Příkazy lze také ověřit pomocí klíče API organizace v proměnné `THUNDERPHONE_API_KEY`, který má přednost před uloženými přihlašovacími údaji. Přihlašovací údaje se ukládají podle profilu do `~/.config/thunderphone/credentials.json` s oprávněním souboru `0600`. Adresář přepisují proměnné `XDG_CONFIG_HOME` a `THUNDERPHONE_CONFIG_DIR`. Přístupové tokeny se automaticky obnovují a rotující obnovovací tokeny se ukládají atomicky. Tokeny se při přihlášení nikdy nevypisují. ```bash thunderphone login --profile work thunderphone agents list --profile work --json thunderphone logout --profile work ``` `THUNDERPHONE_PROFILE` nastavuje výchozí profil. Odhlášení odstraní místní přihlašovací údaje; nezruší oprávnění na serveru. Výchozí API je `https://api.thunderphone.com`. Pro jiné API použijte `--api-base-url` nebo `THUNDERPHONE_API_BASE_URL`. Token profilu nelze odeslat na jinou nakonfigurovanou adresu URL API; k této adrese URL se přihlaste pomocí samostatného profilu. ## Příkazy Každý příkaz přijímá `--json`. Úspěšná data se zapisují do standardního výstupu; chyby do standardního chybového výstupu s nenulovým návratovým kódem. Bez `--json` je výstupem kompaktní tabulka nebo seznam polí. JSON zachovává strukturu odpovědi API, přičemž údaje o přihlašovacích údajích jsou začerněny. Obsluha MCP vyhrazuje standardní výstup pro protokol MCP. | Příkaz | Účel | | --- | --- | | `login [--no-browser] [--scope "scopes"]` | Autorizace pomocí kódu zařízení | | `logout`, `whoami` | Odstranění místních přihlašovacích údajů; výpis dostupných organizací | | `agents list`, `agents get ID` | Načtení agentů | | `agents create --file agent.json` | Vytvoření agenta | | `agents update ID --file agent.json` | Uložení konceptu agenta | | `agents deploy ID`, `agents delete ID` | Nasazení konceptu; odstranění agenta | | `numbers list` | Načtení telefonních čísel | | `numbers provision --country US --area-code 415` | Zřízení amerického příchozího čísla | | `numbers assign NUMBER_ID --agent ID` | Přiřazení agenta pro příchozí hovory | | `sms send TO --from FROM --body TEXT --idempotency-key KEY` | Odeslání SMS přes číslo operátora připojené zákazníkem s bezpečným opakováním | | `sms list [--limit N]`, `sms get UUID` | Výpis nebo kontrola záznamů SMS | | `call TO --agent ID --from FROM [--wait]` | Zahájení odchozího hovoru; volitelné čekání na jeho přepis | | `calls list [--limit N] [--agent ID]` | Výpis hovorů (limit 1–200) | | `calls get ID`, `calls transcript ID` | Načtení jednoho hovoru nebo jeho přepisu | | `test run AGENT_ID [--scenario ID] --consent-to-charge` | Spuštění zpoplatněných uložených scénářů pomocí webového kanálu | | `test status RUN_ID [--agent ID]` | Kontrola dávky s podrobnostmi scénáře, pokud je zadán agent | | `import VENDOR export.json` | Příprava importu JSON od dodavatele ke kontrole | | `imports get UUID`, `imports commit UUID` | Kontrola importu; potvrzení vybraných agentů po kontrole | | `mcp setup`, `mcp serve` | Konfigurace klienta; spuštění mostu stdio | | `init [directory]` | Vytvoření základní struktury projektu | Odchozí hovory vyžadují číslo s povolenými odchozími hovory. `THUNDERPHONE_FROM_NUMBER` může poskytnout hodnotu pro `--from`. Zákaznická čísla VoIP nadále podporují odchozí hovory. Čísla zřízená službou ThunderPhone jsou zpočátku pouze pro příchozí hovory; administrátor organizace může požádat o odchozí volání na stránce Telefonní čísla, kde je každá žádost ručně posouzena. Výchozí hodnota `--wait` je časový limit jedna hodina; nastavte `--timeout SECONDS` pro jeho změnu. Časový limit ukončí čekání, aniž by ukončil hovor. SMS také vyžaduje číslo podporující SMS ve vašem připojeném účtu Twilio nebo Telnyx. Nikdy se neodesílá z čísla vlastněného službou ThunderPhone. Klíč idempotence opakovaně používejte pouze při opakování se zcela stejným odesílatelem, příjemcem a textem. Importy podporují `vapi`, `retell`, `elevenlabs` a `bland`. Druhý argument je cesta k exportu JSON od dodavatele, nikoli vzdálené ID dodavatele. API připraví mapování asynchronně; zkontrolujte je pomocí `imports get UUID` a potvrďte ho až poté, co bude připravené a zkontrolujete namapovaná pole a upozornění. Viz [importy agentů](/cs/guides/import-agents). ## Nastavení 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`. Výchozí je rozsah projektu. Desktop a Windsurf vyžadují uživatelský rozsah. Vynechte `--client`, chcete-li rozpoznat jednoho klienta z projektu; nejednoznačné rozpoznání interaktivně vyžádá volbu nebo v neinteraktivní relaci selže s pokyny. Nastavení vypíše soubor, který zapsalo, a zachová nesouvisející servery. Existující JSON musí být platný striktní JSON; hodnoty TOML pro Codex jsou zachovány, komentáře však mohou být přeformátovány. Nastavení upřednostňuje přímé vzdálené HTTP. S `--api-key-env` zapíše odkaz na proměnnou, nikdy klíč. Bez této možnosti se přímé HTTP spoléhá na podporu OAuth klienta; nepoužívá soubor přihlašovacích údajů CLI. Chcete-li v libovolném klientovi podporujícím stdio znovu použít přihlašovací údaje z `thunderphone login`, použijte: ```json { "mcpServers": { "thunderphone": { "command": "npx", "args": ["-y", "@thunderphone/mcp"] } } } ``` Obálka zkontroluje `THUNDERPHONE_API_KEY`, poté aktuální profil CLI (v případě potřeby jej obnoví) a následně předá OAuth nástroji `mcp-remote`. `THUNDERPHONE_MCP_URL` přepíše koncový bod. Neodesílá žádnou telemetrii. Samostatné nastavení je dostupné také pomocí `npx -y @thunderphone/mcp setup --client cursor` nebo `thunderphone-mcp setup` po globální instalaci `@thunderphone/mcp`. ## Vytvoření 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 ``` Šablony jsou `node` a `python`; typy agentů jsou `receptionist`, `outbound` a `custom`. Výchozí agent je anglicko-španělský zubní recepční s explicitně uvedenými ukázkovými fakty. Projekty obsahují `agent.json`, skripty pro nasazení, konfigurace MCP pro Claude Code, Cursor a VS Code, pokyny pro agenta, `.env.example` a README. Generování základní struktury funguje offline a odmítne přepsat neprázdný adresář. Před nasazením upravte údaje o firmě. Exportujte klíč API, připojené číslo volajícího a příjemce testu podle pokynů ve vygenerovaném README. `npm run deploy` nebo `python deploy.py` vytvoří nebo aktualizuje agenta, nasadí jeho koncept a uskuteční zpoplatněný testovací hovor. Skripty používají ověřování pomocí klíče API; CLI a obálka MCP pro stdio podporují také přihlášení ze zařízení. Skripty Python vyžadují Python 3.9 nebo novější.