Open in
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 workTHUNDERPHONE_PROFILE задава профила по подразбиране. Излизането премахва локалните идентификационни данни;
то не отменя разрешението на сървъра. Промяната или нулирането на паролата ви или
промяната на имейла на акаунта ви го отменя; изпълнете отново thunderphone login. 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 протокола.
| Команда | Предназначение |
|---|---|
login [--no-browser] [--scope "scopes"] | Удостоверяване чрез код за устройство |
logout, whoami | Премахване на локалните идентификационни данни; изброяване на достъпните организации |
agents list, agents get ID | Преглед на агенти |
agents create --file agent.json | Създаване на агент |
agents update ID --file agent.json | Записване на чернова на агент |
agents deploy ID, agents delete ID | Внедряване на черновата; изтриване на агент |
numbers list | Преглед на телефонни номера |
numbers provision --country US --area-code 415 | Осигуряване на входящ номер от САЩ |
numbers assign NUMBER_ID --agent ID | Присвояване на входящ агент |
sms send TO --from FROM --body TEXT --idempotency-key KEY | Изпращане на SMS чрез номер на свързан с клиента оператор с безопасно повторно изпълнение |
sms list [--limit N], sms get UUID | Изброяване или преглед на SMS записи |
call TO --agent ID --from FROM [--wait] | Извършване на изходящо обаждане; по избор изчакване на транскрипцията му |
calls list [--limit N] [--agent ID] | Изброяване на обаждания (лимит 1–200) |
calls get ID, calls transcript ID | Преглед на едно обаждане или транскрипцията му |
test run AGENT_ID [--scenario ID] --consent-to-charge | Изпълнение на таксувани запазени сценарии чрез уеб канала |
test status RUN_ID [--agent ID] | Преглед на пакет със сведения за сценариите, когато е посочен агент |
import VENDOR export.json | Подготовка на JSON импорт от доставчик за преглед |
imports get UUID, imports commit UUID | Преглед на импорт; потвърждаване на избраните агенти след преглед |
mcp setup, mcp serve | Конфигуриране на клиент; стартиране на stdio мост |
init [directory] | Създаване на начална структура на проект |
Изходящите обаждания изискват номер с активирани изходящи обаждания. THUNDERPHONE_FROM_NUMBER може
да предостави --from. Клиентските VoIP номера продължават да поддържат изходящи обаждания.
Номерата, осигурени от ThunderPhone, първоначално са само за входящи обаждания; администратор на организацията може
да заяви изходящи обаждания от страницата „Телефонни номера“, където всяка заявка се
преглежда ръчно. --wait по подразбиране е с едночасово изчакване; задайте
--timeout SECONDS, за да го промените. Изтичането на времето за изчакване спира чакането, без да прекратява обаждането.
SMS също изисква номер с възможност за SMS във Вашия свързан акаунт в Twilio или Telnyx. Никога не се изпраща от номер, притежаван от ThunderPhone. Използвайте повторно ключ за идемпотентност само когато повтаряте опит за изпращане със същия подател, получател и текст.
Импортите поддържат vapi, retell, elevenlabs и bland. Вторият аргумент е
път към JSON експорт от доставчик, а не отдалечен идентификатор на доставчик. 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; TOML стойностите за Codex се запазват, но коментарите може да бъдат преформатирани.
Настройването предпочита директен отдалечен 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 или по-нова версия.