ThunderPhone CLI

Ingia, simamia maejenti ya sauti na simu, sanidi wateja wa MCP, na anzisha miundo ya miradi kutoka kwenye terminal.

CLI inahitaji Node.js 18.18 au toleo jipya zaidi. Iendeshe kwa npx, au isakinishe kimataifa:

npm install -g thunderphone
thunderphone --help

Ingia#

npx thunderphone login
thunderphone whoami --json

Amri ya kuingia huchapisha msimbo wa uthibitishaji, hufungua kivinjari, na kusubiri uidhinishaji. Tumia --no-browser kwenye mashine isiyo na kiolesura cha picha na ufungue URL iliyochapishwa kwingineko. Kuingia kwa kifaa kunahitaji API iwe imewezeshwa kwa OAuth device-flow. Ufunguo wa API wa shirika katika THUNDERPHONE_API_KEY unaweza pia kuthibitisha amri na hupewa kipaumbele kuliko taarifa za kuingia zilizohifadhiwa.

Taarifa za uthibitishaji huhifadhiwa kwa wasifu katika ~/.config/thunderphone/credentials.json kwa ruhusa ya faili 0600. XDG_CONFIG_HOME na THUNDERPHONE_CONFIG_DIR hubatilisha saraka. Tokeni za ufikiaji hujisasisha kiotomatiki na tokeni za kusasisha zinazobadilika huhifadhiwa kwa atomiki. Tokeni hazichapishwi kamwe na amri ya kuingia.

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

THUNDERPHONE_PROFILE huweka wasifu chaguo-msingi. Kuondoka huondoa taarifa za uthibitishaji za ndani; hakubatilishi idhini ya seva. API chaguo-msingi ni https://api.thunderphone.com. Tumia --api-base-url au THUNDERPHONE_API_BASE_URL kwa API nyingine. Tokeni ya wasifu haiwezi kutumwa kwa URL tofauti ya API iliyosanidiwa; ingia kwenye URL hiyo kwa wasifu tofauti.

Amri#

Kila amri hukubali --json. Data iliyofanikiwa huenda kwenye stdout; hitilafu huenda kwenye stderr kwa msimbo wa kutoka usio sifuri. Bila --json, matokeo ni jedwali fupi au orodha ya sehemu. JSON huhifadhi muundo wa jibu la API, huku sehemu za taarifa za uthibitishaji zikifichwa. Utoaji wa MCP huhifadhi stdout kwa itifaki ya MCP.

Simu za kutoka zinahitaji nambari ya opereta iliyounganishwa. THUNDERPHONE_FROM_NUMBER inaweza kutoa --from. Nambari zilizotolewa na ThunderPhone ni za kupokea simu pekee. --wait kwa chaguo-msingi ina muda wa kuisha wa saa moja; weka --timeout SECONDS kuubadilisha. Muda wa kuisha husimamisha kusubiri bila kukatisha simu.

Uagizaji unaauni vapi, retell, elevenlabs, na bland. Hoja ya pili ni njia ya hamisho la JSON la mtoa huduma, si ID ya mbali ya mtoa huduma. API huandaa ulinganishaji kwa njia isiyo ya wakati mmoja; ukague kwa imports get UUID na uthibitishe tu baada ya kuwa tayari na baada ya kukagua sehemu zilizolinganishwa na maonyo. Tazama uagizaji wa ejenti.

Usanidi wa 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

Wateja: claude-code, codex, cursor, vscode, gemini, claude-desktop, na windsurf. Wigo wa mradi ndio chaguo-msingi. Desktop na Windsurf zinahitaji wigo wa mtumiaji. Ondoa --client ili kugundua mteja mmoja kutoka kwenye mradi; ugunduzi usio wazi huomba maelezo kwa kuingiliana au hushindwa pamoja na maagizo katika kipindi kisicho cha kuingiliana. Usanidi huchapisha faili iliyoandika na huhifadhi seva zisizohusiana. JSON iliyopo lazima iwe JSON halali na thabiti; thamani za TOML za Codex huhifadhiwa lakini maoni yanaweza kupangwa upya.

Usanidi hupendelea HTTP ya mbali ya moja kwa moja. Ukiwa na --api-key-env, huandika rejeleo la kigeu, kamwe si ufunguo. Bila chaguo hilo, HTTP ya moja kwa moja hutegemea usaidizi wa OAuth wa mteja; haitumii faili ya vitambulisho ya CLI. Ili kutumia tena vitambulisho vya thunderphone login katika mteja wowote unaoweza kutumia stdio, tumia:

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

Kifunika hukagua THUNDERPHONE_API_KEY, kisha wasifu wa sasa wa CLI (husasisha inapohitajika), kisha hukabidhi OAuth kwa mcp-remote. THUNDERPHONE_MCP_URL hubatilisha endpoint. Haitoi telemetria. Usanidi wa pekee pia unapatikana kupitia npx -y @thunderphone/mcp setup --client cursor au thunderphone-mcp setup baada ya kusakinisha @thunderphone/mcp kimataifa.

Unda mradi#

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

Violezo ni node na python; aina za ejenti ni receptionist, outbound, na custom. Ejenti chaguo-msingi ni mhudumu wa mapokezi wa meno wa Kiingereza/Kihispania mwenye taarifa za onyesho zilizo wazi. Miradi inajumuisha agent.json, hati za kusambaza, usanidi wa MCP wa Claude Code, Cursor na VS Code, maagizo ya ejenti, .env.example, na README. Uundaji wa msingi hufanyika bila mtandao na hukataa kuandika juu ya saraka isiyo tupu.

Hariri taarifa za biashara kabla ya usambazaji. Hamisha ufunguo wa API, nambari ya mpigaji iliyounganishwa, na mpokeaji wako wa majaribio kama ilivyoelezwa katika README iliyoundwa. npm run deploy au python deploy.py huunda au husasisha ejenti, husambaza rasimu yake, na hupiga simu ya majaribio inayotozwa. Hati hutumia uthibitishaji wa ufunguo wa API; CLI na kifunika cha stdio MCP pia vinaunga mkono kuingia kwa kifaa. Hati za Python zinahitaji Python 3.9 au toleo jipya zaidi.