ThunderPhone CLI

Пријавите се, управљајте гласовним агентима и позивима, конфигуришите MCP клијенте и креирајте основну структуру пројеката из терминала.

CLI захтева Node.js 18.18 или новију верзију. Покрените га помоћу npx или га инсталирајте глобално:

npm install -g thunderphone
thunderphone --help

Пријава#

npx thunderphone login
thunderphone whoami --json

Пријава исписује верификациони кôд, отвара прегледач и чека одобрење. На рачунару без графичког интерфејса користите --no-browser и отворите исписани URL на другом месту. Пријава уређаја захтева доступност OAuth тока за уређаје API-ја. Кључ API-ја организације у THUNDERPHONE_API_KEY такође може да аутентификује команде и има предност над сачуваним акредитивима за пријаву.

Акредитиви се чувају по профилу у ~/.config/thunderphone/credentials.json са режимом датотеке 0600. XDG_CONFIG_HOME и THUNDERPHONE_CONFIG_DIR замењују директоријум. Приступни токени се аутоматски освежавају, а ротирајући токени за освежавање се чувају атомски. Токени се никада не исписују током пријаве.

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

THUNDERPHONE_PROFILE поставља подразумевани профил. Одјава уклања локалне акредитиве; не опозива серверско одобрење. Подразумевани API је https://api.thunderphone.com. Користите --api-base-url или THUNDERPHONE_API_BASE_URL за други API. Токен профила не може да се пошаље на други конфигурисани URL API-ја; пријавите се на тај URL помоћу засебног профила.

Команде#

Свака команда прихвата --json. Успешни подаци иду на stdout; грешке иду на stderr са излазним кодом различитим од нуле. Без --json, излаз је сажета табела или листа поља. JSON задржава структуру одговора API-ја, са редигованим пољима акредитива. Послуживање MCP-а резервише stdout за MCP протокол.

Одлазни позиви захтевају број повезаног провајдера телефоније. THUNDERPHONE_FROM_NUMBER може да обезбеди --from. Бројеви које је обезбедио ThunderPhone су само за долазне позиве. --wait подразумевано има временско ограничење од једног сата; подесите --timeout SECONDS да га промените. Истек ограничења престаје да чека без завршавања позива.

Увози подржавају vapi, retell, elevenlabs и bland. Други аргумент је путања до извоза JSON-а добављача, а не удаљени ID добављача. API асинхроно припрема пресликавање; прегледајте га помоћу imports get UUID и потврдите га тек када буде спремно и након што прегледате пресликана поља и упозорења. Погледајте увоз агената.

Подешавање 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

Клијенти: claude-code, codex, cursor, vscode, gemini, claude-desktop и windsurf. Опсег пројекта је подразумеван. Desktop и Windsurf захтевају кориснички опсег. Изоставите --client да бисте открили један клијент из пројекта; нејасно откривање тражи интерактивни унос или не успева са упутствима у неинтерактивној сесији. Подешавање исписује датотеку коју је записало и чува неповезане сервере. Постојећи JSON мора бити важећи строги JSON; Codex TOML вредности се чувају, али коментари могу бити преформатирани.

Подешавање преферира директни удаљени HTTP. Са --api-key-env записује референцу на променљиву, никада кључ. Без те опције, директни HTTP се ослања на OAuth подршку клијента; не користи датотеку акредитива CLI-ја. Да бисте поново користили акредитиве thunderphone login у било ком клијенту који подржава stdio, користите:

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

Омотач проверава THUNDERPHONE_API_KEY, затим тренутни CLI профил (освежавајући га по потреби), а затим препушта OAuth услузи mcp-remote. THUNDERPHONE_MCP_URL замењује крајњу тачку. Не шаље телеметрију. Самостално подешавање је доступно и путем npx -y @thunderphone/mcp setup --client cursor или thunderphone-mcp setup након глобалне инсталације @thunderphone/mcp.

Креирајте пројекат#

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

Шаблони су node и python; типови агента су receptionist, outbound и custom. Подразумевани агент је стоматолошки рецепционар на енглеском/шпанском језику са изричитим чињеницама за демонстрацију. Пројекти укључују agent.json, скрипте за распоређивање, MCP конфигурације за Claude Code, Cursor и VS Code, упутства за агента, .env.example и README. Генерисање структуре ради ван мреже и одбија да препише непразан директоријум.

Измените пословне чињенице пре распоређивања. Извезите API кључ, повезани број позиваоца и примаоца за тестирање, како је документовано у генерисаном README-ју. npm run deploy или python deploy.py креира или ажурира агента, распоређује његову радну верзију и упућује наплативи тестни позив. Скрипте користе аутентификацију API кључем; CLI и stdio MCP омотач такође подржавају пријављивање са уређаја. Python скрипте захтевају Python 3.9 или новију верзију.