Open in
Користите ThunderPhone као MCP сервер
Правите, тестирате, проверавате и користите ThunderPhone гласовне агенте из Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code или другог Streamable HTTP MCP клијента.
ThunderPhone пружа сервер протокола контекста модела са стриминг HTTP-ом на адреси:
https://api.thunderphone.com/v1/mcpОво је супротан смер од повезивања удаљеног MCP сервера са гласовним агентом:
| Смер | Резултат |
|---|---|
| Удаљени MCP сервер → ThunderPhone агент | Гласовни агент може да позове алате удаљеног сервера. |
| ThunderPhone → ваш MCP клијент | Ваш агент за кодирање може да израђује, тестира и управља ThunderPhone-ом. |
Потврдите идентитет
Подразумевано користите OAuth за клијенте директоријума: пријавите се, изаберите организацију и одобрите затражене дозволе. Прекините везу у оквиру Подешавања → Безбедност → Апликације које сте повезали. Промена или ресетовање лозинке, као и промена е-адресе налога, такође опозива везу, па након тога поново повежите клијент.
За клијенте конфигурисане помоћу API кључа, креирајте кључ sk_live_ у оквиру Интеграције → API кључеви и изложите га MCP клијенту као THUNDERPHONE_API_KEY. Кључ је повезан са једном организацијом; id у власништву друге организације понаша се као да није пронађен.
Организације које обрађују PHI
Ако позиви ваше организације могу да садрже заштићене здравствене информације (PHI),
зато што имате BAA са ThunderPhone или су ваши агенти означени као они који
обрађују PHI, горенаведени URL никада не враћа садржај позива: транскрипте,
снимке, оцене, листе позива, извозе, исходе кампања, аналитику позива и
увиде, разговоре направљене на основу стварних позива и резултате поновљене репродукције. Ти алати враћају грешку са
code: "phi_content_unavailable". Прављење, тестирање и конфигурисање агената
ради као и обично.
Тај URL је наведен у јавним директоријумима помоћника, који не смеју да садрже PHI. Ако ваша организација има сопствени BAA са добављачем помоћника који покрива радни простор који користите:
- Администратор организације отвара Организација → Опште → Приступ AI помоћнику у ThunderPhone и потврђује ту покривеност.
- Уместо тога, повежите помоћника као прилагођени конектор са овим URL-ом:
https://api.thunderphone.com/v1/mcp/baaСадржај позива је тада доступан тамо, укључујући позиве који могу да садрже PHI. Повлачење потврде зауставља то при следећем захтеву помоћника. Позив који је ваша организација обрадила као онај који не садржи PHI доступан је на оба URL-а.
CLI и stdio алтернативе
ThunderPhone CLI може да упише конфигурацију клијента уз очување неповезаних сервера:
npx -y @thunderphone/mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
npx thunderphone mcp setup --client claude-desktop --scope userНакон глобалне инсталације @thunderphone/mcp, користите thunderphone-mcp setup са
истим опцијама. Подешавање подржава Claude Code, Codex, Cursor, VS Code, Gemini, Claude
Desktop и Windsurf. Директан HTTP има предност; Desktop користи stdio.
За сваки клијент који подржава stdio, подесите command: "npx" са
args: ["-y", "@thunderphone/mcp"]. Омотач прво користи THUNDERPHONE_API_KEY,
затим акредитиве из thunderphone login, освежавајући истекле токене, а потом
OAuth преко mcp-remote. Пријава уређајем и OAuth захтевају одговарајуће увођење API
OAuth-а. Путања са API кључем то не захтева. Конфигурације за директни HTTP не читају
складиште акредитива CLI-ја; користите stdio омотач да поново искористите пријаву уређајем.
Ово су алтернативе ручним конфигурацијама клијента у наставку.
Конфигурација клијента
Claude и ChatGPT се пријављују помоћу OAuth-а; API кључ није потребан. Ако још немате ThunderPhone налог, на страници за пријаву изаберите Направите налог, а након потврде имејл адресе вратићете се на екран за одобравање.
Claude (веб, рачунар и мобилни уређаји)
- Отворите Прилагођавање → Конектори (Подешавања → Конектори у старијим верзијама). Ако се ThunderPhone појављује у директоријуму конектора, изаберите га. У супротном, изаберите Додај прилагођени конектор, назовите га
ThunderPhoneи унеситеhttps://api.thunderphone.com/v1/mcp. - Изаберите Повежи, пријавите се на ThunderPhone, изаберите организацију и одобрите дозволе.
- У ћаскању омогућите ThunderPhone из менија алатки и затражите оно што Вам је потребно, на пример „Прикажи моје агенте“.
Claude тражи потврду пре прве употребе сваке алатке. Да бисте прескочили већину тих упита, отворите Прилагођавање → Конектори → ThunderPhone и подесите Алатке само за читање на увек дозволи. Те алатке само траже податке: агенте, позиве, транскрипте, стања, документацију. Оставите Алатке за писање/брисање на одобравању ако желите да видите сваку промену пре него што се изврши.
Прилагођени конектори захтевају плаћени Claude план. На Team и Enterprise плановима власник најпре додаје конектор у подешавањима конектора организације, а затим сваки члан повезује свој ThunderPhone налог.
Шта је другачије у Claude-у
Claude (конектор и додатак Claude Code) има ужи скуп алатки, у складу са политиком директоријума Claude конектора:
- Сваки позив и порука потврђују се појединачно.
place_callиsend_smsнајпре враћају преглед (агента, бројеве са којих се позива и на које се позива, а за поруку и њен садржај) узconfirmation_token; ништа се не позива нити шаље док Claude не понови захтев са токеном након Ваше потврде. - Нема управљања кампањама.
create_campaign,add_campaign_contactsиcampaign_actionнису доступни; креирајте, учитајте и покрените кампање на контролној табли.list_campaigns,get_campaign_statsиcheck_campaignи даље раде. - Нема
test_integration. Тестирајте захтев интеграције са њене странице на контролној табли. preview_voiceрепродукује фиксни пример поздрава гласом и на језику које изаберете; не изговара прилагођени текст.list_voicesиlist_agentsвраћају сажетак;get_agentсадржи потпуну конфигурацију агента.
AI обавештење
Сваки позив који ThunderPhone агент упути или на који одговори почиње говорним AI обавештењем. Подразумевано гласи: „Овај позив је са AI асистентом и биће снимљен и транскрибован.“ Искључивање (consent_announcement_enabled на false или ai_live_processing_disclosure_override на off) се одбија осим ако администратор организације претходно није забележио потписану потврду на контролној табли, из било ког клијента, укључујући Claude.
ChatGPT
- Ако се ThunderPhone појављује у директоријуму ChatGPT апликација, изаберите га и повежите.
- У супротном, отворите Подешавања → Апликације и конектори → Напредна подешавања, укључите Режим за програмере и направите конектор са URL-ом
https://api.thunderphone.com/v1/mcpи OAuth аутентификацијом. - Пријавите се на ThunderPhone, изаберите организацију и одобрите дозволе. Додајте ThunderPhone у ћаскање из менија алатки.
Брисање агента или броја телефона, одбацивање нацрта, покретање кампање и слање тест захтева који може да пише у спољни систем захтевају другу потврду у било којој апликацији; погледајте Потврђивање деструктивних радњи.
Claude Code
claude mcp add --transport http thunderphone https://api.thunderphone.com/v1/mcp \
--header "Authorization: Bearer $THUNDERPHONE_API_KEY"Codex
Додајте ово у ~/.codex/config.toml:
[mcp_servers.thunderphone]
url = "https://api.thunderphone.com/v1/mcp"
bearer_token_env_var = "THUNDERPHONE_API_KEY"Cursor
Направите .cursor/mcp.json:
{
"mcpServers": {
"thunderphone": {
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}Claude Desktop
Додајте mcp-remote мост у конфигурацију Claude Desktop-а:
{
"mcpServers": {
"thunderphone": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.thunderphone.com/v1/mcp",
"--header",
"Authorization: Bearer ${THUNDERPHONE_API_KEY}"
],
"env": {
"THUNDERPHONE_API_KEY": "sk_live_YOUR_API_KEY"
}
}
}
}VS Code
Направите .vscode/mcp.json и унесите кључ путем VS Code упита за унос:
{
"inputs": [
{
"type": "promptString",
"id": "thunderphone-api-key",
"description": "ThunderPhone organization API key",
"password": true
}
],
"servers": {
"thunderphone": {
"type": "http",
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${input:thunderphone-api-key}"
}
}
}
}Алатке
Свака алатка садржи MCP напомене. У табелама R значи само за читање, D деструктивно, I идемпотентно, а O интеракцију са отвореним светом/мрежом. Цртица значи да напомена није постављена.
Веза
| Алатка | Главни аргументи | Напомене | Шта ради |
|---|---|---|---|
get_connection_identity | — | R, I | Проверава акредитив и враћа његову организацију и безбедне метаподатке акредитива. |
Агенти
| Алатка | Главни аргументи | Напомене | Шта ради |
|---|---|---|---|
list_agents | — | R, I | Приказује агенте. |
get_agent | agent_id | R, I | Преузима једног агента. |
create_agent | конфигурација агента | — | Креира агента. Прихвата иста подешавања као update_agent, укључујући steps, handoffs, intro_clip и intro_ring_count. |
update_agent | agent_id, измењена поља, опционално prompt_edits, expected_prompt_sha256 | D | Припрема поља у нацрту агента и замењује оно што је нацрт претходно садржао. Покреће се без корака потврде: објављени агент остаје непромењен до deploy_agent, а discard_agent_draft враћа нацрт на претходно стање. Можете подесити и max_hold_seconds, system_tool_settings и words. Да бисте изменили део упита, пошаљите prompt_edits (погледајте Уређивање упита на месту). |
deploy_agent | agent_id, опционално if_updated_at | D, I | Објављује нацрт у продукцији. |
discard_agent_draft | agent_id, опционално if_updated_at, confirmation_token у другом захтеву | D, I | Одбацује припремљене измене. У два корака, погледајте Потврђивање деструктивних радњи. |
duplicate_agent | agent_id, опционално name | — | Копира агента унутар организације. |
delete_agent | agent_id, confirmation_token у другом захтеву | D, I | Трајно брише агента. У два корака. |
list_agent_versions | agent_id | R, I | Приказује објављене верзије конфигурације. |
list_prompt_revisions | agent_id, опционално source, limit, offset | R, I | Приказује сваку измену текста упита агента, укључујући нацрте, са разликом у односу на ревизију коју је заменила. Доступно када је комплет алата за итерације агента доступан вашој вези (погледајте у наставку). |
review_prompt | agent_id, опционално prompt, previous_prompt, quote_id, max_cost_cents | — | Проверава нацрт упита (или текст који пошаљете) у односу на водич за стил упита. Сваки налаз наводи одломак, именује смерницу и нуди измену „пронађи и замени“; резултат такође наводи понашања која упит захтева, са стабилним идентификаторима, да ли је потребно рефакторисање и, за сопствени упит агента, да ли је потребно освежити његове тестне разговоре. Не мења ништа на агенту; инвентар се чува уз ревизију његовог упита. Плаћа се, па није означено као само за читање: прво затражите понуду помоћу dry_run, а затим га поново покрените без dry_run, са враћеним quote_id и max_cost_cents. Ова плаћена покретања сада се рачунају у исти лимит комплета алата организације као и друга покретања комплета алата. Доступно када је комплет алата за итерације агента доступан вашој вези (погледајте у наставку). |
refactor_prompt | agent_id, опционално prompt, inventory, instructions, quote_id, max_cost_cents | — | Преписује упит у облик из водича за стил и мапира свако понашање као задржано, спојено, преформулисано или одбачено. Враћа нови текст и разлику, а подразумевано га поново чита да пријави behavior_changes (додато, уклоњено или измењено) и behavior_preserved; примените га помоћу update_agent. Плаћа се: затражите понуду помоћу dry_run, а затим га једном покрените са враћеним quote_id и max_cost_cents. Доступно када је комплет алата за итерације агента доступан вашој вези (погледајте у наставку). |
list_reusable_instructions | — | R, I | Приказује поновно употребљиве инструкције: дељена правила упита повезана са више агената преко reusable_instruction_ids алатке update_agent. |
create_reusable_instruction | name, content | — | Креира неповезану поновно употребљиву инструкцију. Само за администраторе. |
Бројеви телефона и оператери
| Алатка | Главни аргументи | Ознаке | Шта ради |
|---|---|---|---|
list_phone_numbers | — | R, I | Наводи бројеве организације и њихово рутирање. |
get_phone_number_limits | — | R, I | Приказује коришћење и ограничења управљаних бројева. |
provision_phone_number | опциони area_code, city, state, idempotency_key | D, O | Купује долазни број којим управља ThunderPhone. |
list_voip_connections | — | R, I | Наводи повезане оператере корисника. |
search_voip_numbers | connection_id, country, type, опциони area_code | R, I, O | Претражује инвентар бројева оператера. |
import_voip_numbers | connection_id, numbers | D, O | Увози бројеве који су већ у власништву код оператера. |
update_phone_number | phone_number_id, поља за рутирање/ознаку/веб-куку | D | Ажурира рутирање броја, укључујући доделу агенту. |
delete_phone_number | phone_number_id, confirm, опциони release_at_provider, confirmation_token у другом захтеву | D, I, O | Ослобађа број. У два корака. |
get_voip_setup_session | опциони session_id | R, I | Чита вођено подешавање оператера (статус, контролну листу, питање на које чека одговор) или наводи отворена подешавања. Подешавање се покреће на контролној табли јер је потребна лозинка оператера. Само за администраторе. |
answer_voip_setup_question | session_id, question_id, answer | O | Прослеђује одговор корисника подешавању. На лозинке, сагласност за пробни позив, адресу сервера, корисничко име и дозволу да се ThunderPhone пријави на налог код добављача одговара се само у чаробњаку за подешавање; за њих враћа везу до чаробњака и не шаље ништа. |
save_voip_setup | session_id, опциони name, confirmation_token у другом захтеву | D, I, O | Чува повезану радну верзију везе да би могла да се користи. У два корака. |
check_phone_number | phone_number или phone_number_id | R, I, O | Дијагностикује један од сопствених бројева организације на основу доказа: рутирања, везе, верификације, недавних позива оператера и пробних позива, као и одредишта на које га оператер шаље. |
SMS
| Алатка | Главни аргументи | Напомене | Шта ради |
|---|---|---|---|
send_sms | from_number, to, body, idempotency_key | D, I, O | Шаље једну SMS поруку у обичном тексту преко повезаног Twilio или Telnyx броја. |
Позиви
| Алатка | Главни аргументи | Напомене | Шта ради |
|---|---|---|---|
list_calls | опциони филтери, limit, offset | R, I | Приказује позиве помоћу REST филтера историје позива, укључујући exclude_test_calls. |
get_call | call_id | R, I | Преузима статус и метаподатке позива. |
get_call_transcript | call_id, опциони live | R, I | Преузима транскрипт позива. |
get_call_audio_url | call_id, опциони download | R, I, O | Враћа потписани URL за аудио; никада не стримује аудио преко MCP-а. |
get_call_grade | call_id | R, I | Преузима најновију оцену позива. |
place_call | agent_id, from_number, to_number | D, O | Упућује један неидемпотентан одлазни позив. |
export_calls | филтери позива, export_format | R, I | Извози до ограничења REST крајње тачке као JSON или CSV. |
get_call_analytics | опциони since_days, agent_id | R, I | Обједињује стварне позиве према статусу, смеру, исходу, оцени и проблему, при чему се тестни позиви броје засебно. |
get_call_insights | call_ids (до 10) | R, I | Преузима оцену, исход, сажетак и откривене проблеме за више позива одједном. |
Тестирање и валидација
| Алат | Главни аргументи | Напомене | Шта ради |
|---|---|---|---|
list_test_scenarios | agent_id | R, I | Наводи сценарије за тестирање. |
create_test_scenario | agent_id, title, scenario_prompt, опциони услови | — | Креира сценарио. |
generate_test_scenarios | agent_id, опциони count, include_edge_cases, locale | O | Генерише сценарије из упита агента. |
run_agent_tests | agent_id, channel, consent_to_charge, опциони избор/матрица | D, O | Извршава сценарије путем веба или телефоније. |
get_test_run | agent_id, batch_id | R, I | Преузима статус групе и резултате по сценарију. |
test_my_agent | agent_id, consent_to_charge, опциони scenario_ids, count, wait_seconds | D, O | Тестира агента у једном позиву: покреће његове сачуване сценарије (генерише неке ако их нема) и чека до једног минута на оцене или враћа batch_id за get_test_run. Наплаћује се као run_agent_tests. |
test_in_text | agent_id, callers (од 1 до 3 описа), опциони version, direction | O | Бесплатан текстуални тест: симулирани позиваоци разговарају са радном верзијом агента (или активном верзијом) текстом кроз стварни процес, а транскрипти стижу за око један минут. Резултати алата су симулирани. |
run_simulation | agent_id, consent_to_charge, опциони scenario_prompt, direction, language | D, O | Покреће један симулирани телефонски позив између AI позиваоца и радне верзије агента, тако да особа може да преслуша измену. Враћа покретање са статусом in_progress. Снима се када агент снима позиве и оцењује након завршетка. Наплаћује се као пробни позив, прво из бесплатног буџета за тестирање. |
get_simulation | simulation_id | R, I | Преузима статус симулираног позива и, када се заврши, оно што је произвео: URL снимка кратког трајања и транскрипт када агент снима позиве, као и оцену када се оцењивање заврши (null пре тога). |
list_validation_runs | agent_id | R, I | Наводи недавна покретања валидације радне верзије. |
get_validation_status | agent_id | R, I | Преузима најновије стање валидације и подударање радне верзије. |
list_conversations | agent_id, опциони split, source | R, I | Наводи разговоре на којима се агент тестира. Захтева комплет алата за итерације агента. |
get_conversation | conversation_id | R, I | Преузима један пробни разговор са његовим тренутним разменама. Захтева комплет алата за итерације агента. |
get_conversation_revisions | conversation_id, опциони limit, offset | R, I | Наводи сваку ревизију пробног разговора: како и зашто је измењен (освежен због измене упита, враћен из раније ревизије), додата, уклоњена и измењена понашања, премештене или повучене примере и разлику реда. Захтева комплет алата за итерације агента. |
generate_conversations | agent_id, опциони count, style | O | Пише симулиране пробне разговоре са радном верзијом агента и њихове најтеже тренутке претвара у примере за валидацију са кључевима одговора. Прво затражите понуду помоћу dry_run; за стварно покретање потребни су његов quote_id и max_cost_cents. Захтева комплет алата за итерације агента. |
import_conversations | agent_id, опциони since_days, max_calls | O | Претвара недавне позиве агента у пробне разговоре (највише два по позиваоцу, позиви без снимања се прескачу) и њихове најтеже тренутке у примере. Прво затражите понуду помоћу dry_run; за стварно покретање потребни су његов quote_id и max_cost_cents. Захтева комплет алата за итерације агента. |
refresh_conversations | agent_id, опциони conversation_ids, from_prompt_revision_id | O | Усклађује пробне разговоре агента са његовим тренутним упитом након додавања, уклањања или измене понашања: поново их усмерава, враћа ранију ревизију (укључујући стварни звук) или преписује застареле размене и повлачи примере чија је размена позиваоца нестала. Прво затражите понуду помоћу dry_run; за стварно покретање потребни су његов quote_id и max_cost_cents. Захтева комплет алата за итерације агента. |
get_conversation_job | job_id | R, I | Преузима посао генерисања, увоза или освежавања: статус, досадашњи трошак у односу на ограничење и оно што је написао или освежио. Захтева комплет алата за итерације агента. |
run_replays | agent_id, опциони overrides, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_run | D, O | Поново репродукује узорак примера агента са његовом радном верзијом или са заменама као што су кандидатски упит, глас или ниво и оцењује сваки одговор према кључу одговора примера. Тачне репродукције покрећу снимљени звук размене као што би то учинио активни позив; стопе пролазности пријављују се по механизму. Репродукције PHI позива извршавају се као PHI, а конфигурација коју не могу да покрену (глас ElevenLabs-а, експериментални производ) се одбија. dry_run враћа процену, изабрани sample_seed и quote_id; стварно покретање шаље исти захтев са тим quote_id и sample_seed, као и max_cost_cents, строгим ограничењем: сваки захтев резервише своју горњу границу пре слања, а покретање се зауставља уместо да пошаље захтев који не одговара, зато оставите процењени largest_reservation_cents слободног простора по раднику. Тачна репродукција резервише свој најгори случај, око 85 центи до $1.25 по репродукцији у току за типичну размену (две се извршавају истовремено), у односу на стварни трошак од неколико центи; покретање се наплаћује према стварном трошку репродукција, зато поставите max_cost_cents са резервом. Тачна репродукција се извршава у оквиру буџета одређеног за нормалну размену плус једно поновно покретање какво се дешава у продукцији (трка за одговором поново и поновни покушај надзорника); размена којој је потребно више бележи се као грешка replay_budget_exhausted, засебно се броји као budget_exhausted, не улази у стопу пролазности и, у тест скупу, не троши ниједну кохорту. У тест скупу, кохорта са снимљеним звуком позиваоца под конфигурацијом која није Bolt v2 се одбија (test_needs_exact_replay) и остаје неискоришћена: ту конфигурацију мерите у развојном скупу. Захтева комплет алата за итерације агента. |
compare_configs | agent_id, configs (од 2 до 4, прва је основна), опциони sample_size, sample_seed, max_cost_cents, quote_id, dry_run | O | Поново репродукује исте примере под сваком конфигурацијом и пријављује стопу пролазности, примере исправљене и покварене у односу на основну конфигурацију, кашњење до првог звука, колико често је позивалац чекао на потврду, сигнале или тишину и трошак по размени, по механизму. Затражите понуду помоћу dry_run као за run_replays. Само развојни скуп: у тест скупу се одбија (comparison_dev_only); упоредите у развојном скупу, а затим измерите избор помоћу run_replays. Захтева комплет алата за итерације агента. |
get_replay_run | run_id, опциони include_trace | R, I | Преузима укупне резултате покретања репродукције, промене и резултате по примеру, као и његову групу за поређење. Тачне репродукције којима је требало више од буџета броје се засебно (budget_exhausted), ван стопе пролазности. Захтева комплет алата за итерације агента. |
create_talk_link | agent_id, опциони variant_id, language, expires_in_minutes | O | Креира везу за једнократну употребу коју особа отвара у прегледачу да би разговарала са тренутном радном верзијом агента, као помоћу дугмета „Разговор“ на контролној табли. Веза подразумевано истиче после 30 минута (највише 120); разговор се наплаћује као пробни позив за разговор. Погледајте Везе за разговор. |
Алати означени као они којима је потребан комплет алата за итерацију агента његов су део; комплет алата се омогућава по организацији док је у бета верзији, а без њега враћају feature_not_enabled са упутствима за следеће кораке. Сваки разговор агента налази се у његовом развојном или тест скупу. Тест скуп служи за мерење измене, а не за њено подешавање, па алати за разговоре враћају разговор из тест скупа само са његовим идентификатором, скупом, извором, статусом и бројачима. Покретање репродукције на тест скупу репродукује једну целу тест кохорту (sample_size и sample_seed се занемарују), сваки пример на механизму који његови подаци дозвољавају, одређеном пре покретања на основу примера (тачно за снимљени звук позиваоца, текстуално за пример само са текстом; конфигурација различита од Bolt v2 нема тачну путању, па се кохорта са снимљеним звуком за њу одбија са test_needs_exact_replay и остаје неискоришћена; engine се изоставља или поставља на auto, јер се exact или text одбијају са test_engine_per_example, а ништа не прелази на текст), и враћа само укупне вредности по механизму: стопу пролазности, неуспехе по озбиљности и врсти, кашњење и трошак. Његов први резултат који сачува репродукцију троши кохорту, па следеће тест покретање, за било који промпт, узима другу, а ако ниједна не преостане одбија се са no_test_cohort (увоз позива или генерисање разговора попуњава нове кохорте); покретање које се заврши пре чувања репродукције (Core не може тачно да репродукује његове аудио-примере, exact_replay_unavailable, капацитет за репродукцију је и даље заузет, core_busy, или је сваком кораку истекао буџет, replay_budget_exhausted) оставља кохорту неискоришћеном. У развојном скупу, тачна репродукција коју Core не може да изврши прелази на текст и покретање се означава као degraded. Поређења се извршавају само у развојном скупу. Сваки алат који се плаћа прихвата quote_id из свог пробног покретања, који важи за једно покретање: трајно се потроши једном, када покретање започне, а покретање које је одбијено или не успе пре тога оставља га употребљивим; покретање које не успе након тога то наводи и понавља се новим пробним покретањем за нови quote_id. Са OAuth-ом, review_prompt и refactor_prompt захтевају опсег agents:write, укључујући пробна покретања, а алати за разговоре и репродукције захтевају testing:write за покретање. Корисници виде цео тест скуп на контролној табли. Позив чији је позивалац у тест скупу агента издваја се, јер је део тест скупа података. У организацији са комплетом алата, list_calls, get_call, get_call_transcript, get_call_audio_url, get_call_grade и export_calls враћају га тачно као {"call_id", "start_time", "held_out": true} (started_at уместо start_time у редовима извоза), без транскрипта, снимка, историје, оцене или извештаја; свако друго поље позива изостаје, па издвојени ред најпре препознајте по његовом held_out. REST API чини исто за API кључеве и OAuth токене, а његови прикази преко више позива (сажети извештаји, кластери проблема, истраге, извештаји о цевоводу) изостављају издвојене позиве из бројања, кластера и узорака и задржавају сваки текст који је модел из њих написао. Упис у издвојени позив (оцењивање, промовисање у тест сценарио, поновно генерисање корака) одбија се са held_out_call. Тест сценарио који је неко промовисао из издвојеног позива враћа се из list_test_scenarios и у тест покретањима тачно као {"id", "held_out": true}, а покретање симулације из њега, из get_test_run и алата за симулацију, тачно као {"id", "scenario_id", "held_out": true}; и његови симулирани позиви су издвојени, а тест покретања га и даље извршавају. Развојни разговор, пример или резултат репродукције копиран из позива издвојеног позиваоца (скупови су по агенту, па тај позивалац може бити у тест скупу другог агента) чита се као онај из тест скупа. Корисници виде издвојене позиве у целости на контролној табли, а администратор може дозволити једном API кључу да их види у целости (include_held_out_calls, подразумевано искључено, подешава се само на контролној табли), за интеграцију којој је потребан сваки позив; MCP то никада не користи. Веб-хукови су непромењени. Организације без комплета алата не виде поље held_out нити било какву промену.
generate_conversations, import_conversations и refresh_conversations троше кредите модела. Прво их позовите са dry_run: true: одговор је понуда трошкова, корак по корак, са quote_id, и ништа се не покреће. Понуда обухвата сваки захтев који покретање може да упути при уобичајеној величини. За стварно покретање потребни су тај quote_id (истиче после 15 минута и ради само са истим аргументима) и max_cost_cents, чврсти лимит: пре сваког захтева посао резервише највиши износ који тај захтев може да кошта и зауставља се уместо да пошаље онај који не стаје у лимит, задржавајући оно што је написао. Због те резервације, покретање може да се заустави са делом лимита непотрошеним; largest_reservation_cents из понуде говори колико резерве треба оставити. Симулирани позиваоци се осмишљавају на основу промпта агента; style: "adversarial" генерише захтевне позиваоце који притискају слабе тачке промпта, а ти разговори увек иду у развојни скуп. target: "changed_behaviors" усмерава позиваоце на оно што је промењено у последњој измени промпта. Сваки агент истовремено покреће један од ових послова или једно поновно извођење, тако да освежавање никада не мења примере на којима се изводи поновно извођење; покретање док је друго активно враћа job_active, replay_run_active или conversation_job_active са информацијом шта треба сачекати.
После измене промпта која додаје, уклања или мења понашање, review_prompt на нацрту агента пријављује колико је тестних разговора написано за промпт са другим понашањима (conversations.refresh_suggested). refresh_conversations их затим усклађује са нацртом, тако да развојни и тестни скупови мере нови промпт на историјама које је могао да произведе. Освежавање никада ништа не губи: сваки разговор задржава сваку ранију ревизију, а када се уклоњено правило врати, враћа се ревизија из времена када је постојало, са стварним звуком позиваоца. Освежавање које покрене програмерски агент изоставља разговоре из тестног скупа и разговоре копиране из изузетих позива из избора, понуде, напретка и трошка; навођење једног у conversation_ids враћа 403 test_conversation. Особа их освежава са контролне табле, а програмерским агентима резултати тог посла приказују их само као идентификаторе и бројеве. active пример чију историју, одговор или кључ одговора освежавање препише враћа се у pending_review, са ознаком refreshed_needs_review. Понуда за освежавање обрачунава цену сваког разговора који чита као да ће бити преписан, сваког позива моделу на његовом излазном лимиту, и важи за промпт и разговоре за које је дата понуда: када се било шта од тога промени пре покретања, поново затражите понуду; када се промпт промени током покретања, посао се зауставља као failed, задржавајући оно што је освежио.
База знања
| Алатка | Главни аргументи | Напомене | Шта ради |
|---|---|---|---|
list_knowledge_bases | — | R, I | Приказује базе знања. |
create_knowledge_base | name, опционо description | — | Креира базу знања. |
add_knowledge_document | knowledge_base_id, name, content | — | Додаје текст или Markdown. |
import_knowledge_url | url, опционо name | O | Ставља јавну страницу у ред за безбедно уношење. |
search_knowledge | knowledge_base_id, query | R, I | Претражује продукциони систем за преузимање знања. |
Интеграције, веб-куке и удаљени MCP сервери
| Алатка | Главни аргументи | Напомене | Шта ради |
|---|---|---|---|
list_integrations | — | R, I | Приказује интеграције HTTP функција. |
create_integration | display_name, спецификација функције spec, опциона поља крајње тачке | — | Креира HTTP алатку. Додајте заглавља за аутентификацију на контролној табли. |
test_integration | url, опциони метод/тело/временско ограничење, integration_id са header_names, confirmation_token при другом захтеву | D, O | Шаље ограничен тестни захтев заштићен од SSRF-а. Сачуване вредности заглавља попуњавају се из интеграције и шаљу само њеном сопственом хосту. POST (подразумевано), PUT, PATCH и DELETE су поступци у два корака; GET се извршава одмах. |
list_webhook_endpoints | — | R, I | Приказује потписане крајње тачке вебхука. |
list_webhook_deliveries | опциони agent_id, опциони endpoint_id | R, I | Приказује недавне исходе испоруке вебхука без садржаја захтева. |
create_webhook_endpoint | label, url, опциони догађаји/статус | O | Креира потписану крајњу тачку вебхука. |
copy_webhook_endpoint | endpoint_id, target_agent_id | I | Копира вебхук агента, укључујући тајну за потписивање, на другог агента на серверу. Само за администраторе. |
test_webhook_endpoint | endpoint_id | O | Шаље синтетички догађај путем уобичајене испоруке. |
list_mcp_servers | — | R, I | Приказује удаљене сервере које могу да позивају гласовни агенти. |
create_mcp_server | display_name, url | O | Региструје и синхронизује удаљени сервер. Сервери којима су потребна заглавља за аутентификацију додају се на контролној табли. |
sync_mcp_server_tools | server_id | D, O | Освежава каталог алатки удаљеног сервера. |
Кампање
| Алат | Главни аргументи | Напомене | Шта ради |
|---|---|---|---|
list_campaigns | — | R, I | Приказује одлазне кампање. |
create_campaign | поља кампање | — | Креира кампању у нацрту. |
add_campaign_contacts | campaign_id, contacts | — | Додаје до 5.000 JSON контаката. |
campaign_action | campaign_id, action, опционо consent_to_charge, confirmation_token при другом захтеву | D, O | Покреће start, pause, resume или stop. start и resume имају два корака; pause и stop се извршавају одмах. |
get_campaign_stats | campaign_id | R, I | Преузима бројаче и недавне исходе. |
check_campaign | опционо campaign_id, contact_phone_number, contact_status | R, I | Објашњава зашто кампања не позива: њен прозор за позивање у сопственој временској зони, контакте који су тренутно на реду и шта зауставља бирање броја. |
Подешавања организације и блокирани позиваоци
| Алат | Главни аргументи | Ознаке | Шта ради |
|---|---|---|---|
get_org_settings | — | R, I | Чита временску зону, радно време, пробне бројеве, ознаке исхода позива, називе статуса и који су аларми искључени, са updated_at. |
update_org_settings | измењена подешавања, if_updated_at, confirmation_token када се затражи | D, I | Мења их (само администратори). Листе и објекти замењују сачувану вредност. Искључивање аларма или додавање пробног броја обавља се у два корака. Резултат садржи старе вредности за опозив. |
get_account_limits | — | R, I | Преузима ограничења платформе са вредностима специфичним за ову организацију. |
list_blocked_callers | опционални number, search | R, I | Приказује блокиране бројеве позивалаца. |
block_callers | numbers, опционални note, confirmation_token при другом захтеву | D, I | Одбија позиве са ових бројева пре него што се било који агент јави. У два корака, само за администраторе. |
unblock_callers | numbers, confirmation_token при другом захтеву | D, I | Уклања бројеве са листе блокираних. У два корака, само за администраторе. |
get_org_settings, update_org_settings и get_account_limits захтевају org:read или org:write OAuth опсег; од везе успостављене пре њиховог увођења тражи се да га одобри при првој употреби.
Могућности, помоћ и увози
| Алат | Главни аргументи | Ознаке | Шта ради |
|---|---|---|---|
get_supported_languages | — | R, I | Приказује језике којима агенти говоре, са кодовима. |
get_agent_capabilities | — | R, I | Наводи шта агент може да уради током позива и која подешавања и интеграције постоје. |
escalate_to_human | summary | O | Тражи помоћ од тима ThunderPhone. Они одговарају у ThunderPhone. За организације које могу да обрађују PHI, из ThunderPhone излази само неутрална напомена. |
request_feature | title, request, details | O | Подноси захтев за функцију тиму ThunderPhone. Највише три по организацији дневно. |
start_agent_import | platform | R, I | Враћа везу до контролне табле на којој уносите свој Vapi, Retell, ElevenLabs или Bland кључ и бирате агенте. Ниједан алат не прима кључ. |
get_agent_import | опционални import_id | R, I | Приказује недавне увозе или статус једног увоза и мапиране агенте. |
commit_agent_import | import_id, опционални item_ids | O | Прави агенте из спремног увоза, у позадини. Само администратори. |
Гласови, наплата и документација
| Алатка | Главни аргументи | Ознаке | Шта ради |
|---|---|---|---|
list_voices | — | R, I | Приказује гласове и подржане језике. |
preview_voice | voice, language, text | O | Генерише узорак и враћа потписани URL. |
list_voice_clones | — | R, I | Приказује прилагођене копије гласова. |
get_billing_summary | — | R, I | Преузима стање и меродавне цене нивоа; не излаже измене плаћања. |
search_docs | query, опциони limit | R, I, O | Претражује јавни индекс документације. |
get_doc_page | path | R, I, O | Преузима једну јавну страницу документације у Markdown формату. |
Резултати о агенту, позиву, броју, кампањи или подешавању садрже web_url, одговарајућу страницу контролне табле, тако да је можете отворити у ThunderPhone или тамо наставити са Zeus.
Све алатке производа користе исте REST путање кода као јавни API. REST валидација, опсег организације, улоге, одобравање наплате, квоте, TCPA потврда, безбедност добављача и понашање ревизије се стога примењују без измена.
Уређивање упита на месту
update_agent може да измени део нацрта упита без поновног слања целог текста. prompt_edits је уређена листа парова за проналажење и замену, у истом формату који враћају review_prompt и refactor_prompt:
{
"agent_id": 123,
"expected_prompt_sha256": "9c1f…",
"prompt_edits": [
{
"find": "Ask for their name and their phone number, then tell them we will call back.",
"replace": "Tell them we will call back, then ask for their name. Once they answer, ask for their phone number."
}
]
}Сервер примењује измене редом на тренутни нацрт упита агента (објављени упит када нацрт не постоји) и уписује резултат у нацрт истим путем као и update_agent за цео упит. Сваки find мора да се појави тачно једном у упиту у стању у ком се налази када дође ред на ту измену. Ако се не појављује, ништа се не уписује, а грешка наводи измену:
| Кôд | Значење | Шта да урадите |
|---|---|---|
prompt_edit_not_found | Текст find није у тренутном нацрту упита. edit_index наводи која је измена у питању. | Поново прочитајте агента и тачно копирајте одломак. |
prompt_edit_ambiguous | Текст find појављује се више пута. occurrences наводи колико пута. | Укључите више околног текста. |
stale_prompt | expected_prompt_sha256 није SHA-256 тренутног нацрта упита: променио се након што сте га прочитали. | Поново прочитајте агента, преправите измену према тренутном тексту и пошаљите његов SHA-256. |
conflict | Други упис се догодио између читања нацрта на серверу и његовог уписивања. | Покушајте поново; овај позив није изменио нацрт. |
expected_prompt_sha256 није обавезан и такође штити упис целог упита. Користите prompt_sha256 из review_prompt или source_prompt_sha256 из refactor_prompt. Сваки позив који мења упит враћа prompt_sha256 за нови текст, previous_prompt_sha256 када је сервер прво прочитао нацрт и next_step који предлаже review_prompt са previous_prompt постављеним на текст пре измене. REST API прихвата само цео упит: PATCH /v1/agents/{agent_id} са prompt и if_updated_at.
Потврђивање деструктивних радњи
Алатке означене словом D мењају или уклањају нешто или започињу позивање стварних људи. За оне које се не могу опозвати потребна су два захтева. Први захтев ништа не мења и враћа:
{
"status": "confirmation_required",
"action": "Delete agent",
"target": { "id": 195, "name": "Front Desk Receptionist" },
"confirmation_token": "…",
"expires_in_seconds": 600,
"next_step": "…"
}Асистент приказује кориснику на шта ће то утицати и тражи потврдан одговор. Затим понавља захтев са истим аргументима и додатим confirmation_token. Токен важи 10 минута, може се употребити једном (чак и ако тај позив не успе) и важи за једну организацију, једну особу, један алат и један тачан скуп аргумената, тако да су за брисање три агента потребне три потврде. campaign_action са pause или stop прескаче овај корак како би активна кампања увек могла одмах да се заустави, као и test_integration са GET. Неки D алати извршавају се у једном захтеву јер D означава њихов ефекат, а не потврду на страни сервера: update_agent замењује оно што је било у нацрту (discard_agent_draft га враћа), deploy_agent замењује активну конфигурацију, update_phone_number преусмерава активне позиве, sync_mcp_server_tools замењује каталог алата удаљеног сервера, import_voip_numbers преусмерава бројеве на Вашег провајдера, run_agent_tests и run_simulation могу потрошити кредит, send_sms и place_call контактирају стварну особу (place_call задржава сопствену потврду пристанка), а provision_phone_number купује број. test_my_agent троши тестни кредит и захтева consent_to_charge. run_replays такође троши новац; његова dry_run процена и ограничење max_cost_cents замењују потврду. Ваш MCP клијент Вас и даље може затражити да их одобрите.
Неке промене које се могу поништити и даље чекају на потврду: block_callers, unblock_callers и save_voip_setup увек, update_org_settings када искључује упозорење или додаје тестни број, и update_agent када његови attention_reasons искључују једно од упозорења агента. Њихов next_step тражи од Вас да потврдите тачну промену, уместо да упозори да се она не може поништити.
Почетни упити
prompts/list приказује дванаест токова рада за вишекратну употребу:
create_inbound_receptionistrun_agent_testsbuy_and_attach_numberreview_low_grade_callsadd_url_to_agent_knowledgeimprove_agent_from_callscheck_change_before_deploytest_my_agentdiagnose_phone_numberwhy_campaign_not_callingcall_reportimport_agents
Користите prompts/get са наведеним именом упита и његовим декларисаним аргументима да бисте добили корисничку поруку спремну за покретање.
Ресурси
resources/list излаже јавне, кеширане референце:
| URI | Садржај |
|---|---|
thunderphone://docs/llms.txt | Јавни индекс документације. |
thunderphone://docs/quickstart | Quickstart Markdown. |
thunderphone://pricing | Тренутни јавни Markdown са ценама. |
thunderphone://guides/prompt-style | Водич за стил упита гласовног агента према коме review_prompt врши проверу. Његови ИД-ови смерница (P1, W2 и тако даље) су они на које се налази позивају. |
thunderphone://guides/working-with-thunderphone | Како асистент треба да ради са овим алатима: мале итерације на нацрту, провера пре сваког постављања, корисникова потврда за све што је активно или се наплаћује и никада тражење тајни. |
Прочитајте ресурс помоћу resources/read. Јавна преузимања користе кратко временско ограничење, ограничење од 2 MiB и десетоминутни кеш у процесу.
Протокол и грешке
Сервер подржава верзије протокола 2025-06-18 и 2025-03-26; враћа подржану верзију клијента, а у супротном бира 2025-06-18. Имплементира initialize, ping, алате, упите, ресурсе и обавештења. Обавештења враћају 202 Accepted. Овај сервер без стања не излаже SSE слушач нити брисање сесије, па GET и DELETE враћају 405 Method Not Allowed са Allow: POST.
Неуспеси алата и даље остају успешни JSON-RPC одговори са isError: true. Њихов текст садржи кратку реченицу након које следи JSON блок:
{
"code": "insufficient_balance",
"detail": "There is not enough prepaid balance.",
"next_step": "Call get_billing_summary, add funds in Organization > Billing, then retry."
}Различити префикс outbound_tcpa_confirmation_required: задржан је за place_call. Непознате JSON-RPC методе враћају -32601 у HTTP 200 одговору. JSON-RPC пакети нису подржани у MCP 2025-06-18 и враћају исправну грешку неважећег захтева -32600.