ThunderPhone CLI

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ě:

npm install -g thunderphone
thunderphone --help

Přihlášení#

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í.

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.

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ů.

Nastavení MCP#

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:

{
  "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#

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ší.