Open in

Kasuta ThunderPhone

Loo, testi, valideeri ja halda ThunderPhone

ThunderPhone pakub Streamable HTTP Model Context Protocoli serverit aadressil:

https://api.thunderphone.com/v1/mcp

See on vastupidine suund võrreldes kaughostitud MCP-serveri ühendamisega häälagendiga:

Suund	Tulemus
Kaughostitud MCP-server → ThunderPhone'i agent	Häälagent saab kutsuda kaugserveri tööriistu.
ThunderPhone → sinu MCP-klient	Sinu programmeerimisagent saab ThunderPhone'i luua, testida ja hallata.

Autentimine

Kasuta kataloogiklientide jaoks vaikimisi OAuthi: logi sisse, vali organisatsioon ja kinnita taotletud õigused. Tühista juurdepääs jaotises Organisatsioon → API võtmed → Volitatud rakendused.

API-võtmega seadistatud klientide jaoks loo jaotises Organisatsioon → Võtmed sk_live_-võti ja ava see oma MCP-kliendile muutujana THUNDERPHONE_API_KEY. Võti on seotud ühe organisatsiooniga; teisele organisatsioonile kuuluv ID käitub nagu seda ei leitaks.

CLI ja stdio alternatiivid

ThunderPhone CLI saab kirjutada kliendi konfiguratsiooni, säilitades muud serverid:

npx -y @thunderphone/mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
npx thunderphone mcp setup --client claude-desktop --scope user

Pärast paketi @thunderphone/mcp globaalset installimist kasuta sama valikutega käsku thunderphone-mcp setup. Seadistus toetab Claude Code'i, Codexi, Cursorit, VS Code'i, Geminit, Claude Desktopi ja Windsurfi. Eelistatud on otsene HTTP; Desktop kasutab stdio't.

Iga stdio-toega kliendi jaoks seadista command: "npx" koos args: ["-y", "@thunderphone/mcp"]. Ümbris kasutab esmalt muutujat THUNDERPHONE_API_KEY, seejärel käsu thunderphone login autentimisandmeid, värskendades aegunud tokeneid, ning seejärel OAuthi mcp-remote kaudu. Seadmelogimine ja OAuth nõuavad vastavat API OAuthi kasutuselevõttu. API-võtme kasutamine seda ei nõua. Otsesed HTTP-konfiguratsioonid ei loe CLI autentimisandmete hoidlat; seadmelogimise taaskasutamiseks kasuta stdio-ümbrist.

Need on alternatiivid allolevatele käsitsi seadistatavatele kliendikonfiguratsioonidele.

Kliendi seadistamine

Claude ja ChatGPT kasutavad sisselogimiseks OAuthi; API-võtit ei kasutata. Kui sul veel ThunderPhone'i kontot ei ole, vali sisselogimislehel Loo konto ning pärast e-posti kinnitamist naased kinnitusekraanile.

Claude (veeb, töölauarakendus ja mobiil)

Ava Kohanda → Konnektorid (vanemates versioonides Seaded → Konnektorid). Kui ThunderPhone kuvatakse konnektorite kataloogis, vali see. Vastasel juhul vali Lisa kohandatud konnektor, nimeta see ThunderPhone ja sisesta https://api.thunderphone.com/v1/mcp.
Vali Ühenda, logi ThunderPhone'i sisse, vali organisatsioon ja kinnita õigused.
Luba vestluses ThunderPhone tööriistade menüüst ja küsi, mida vajad, näiteks „Loetle minu agendid“.

Claude küsib enne iga tööriista esmakordset kasutamist kinnitust. Enamiku nende viipade vahelejätmiseks ava Kohanda → Konnektorid → ThunderPhone ja määra Ainult lugemiseks tööriistad alati lubatuks. Need tööriistad ainult otsivad teavet: agendid, kõned, transkriptsioonid, saldod, dokumentatsioon. Kui soovid iga muudatust enne selle tegemist näha, jäta Kirjutamis-/kustutustööriistad kinnitust nõudma.

Kohandatud konnektorid nõuavad tasulist Claude'i paketti. Team- ja Enterprise-pakettides lisab omanik konnektori esmalt organisatsiooni konnektorite seadetes ning seejärel ühendab iga liige oma ThunderPhone'i konto.

ChatGPT

Kui ThunderPhone kuvatakse ChatGPT rakenduste kataloogis, vali see ja ühenda.
Vastasel juhul ava Seaded → Rakendused ja konnektorid → Täpsemad seaded, lülita sisse Arendajarežiim ning loo konnektor URL-iga https://api.thunderphone.com/v1/mcp ja OAuth-autentimisega.
Logi ThunderPhone'i sisse, vali organisatsioon ja kinnita õigused. Lisa ThunderPhone vestlusse tööriistade menüüst.

Häälagendi või telefoninumbri kustutamine, mustandi hülgamine, kampaania käivitamine ja välisesse süsteemi kirjutada võiva testpäringu saatmine nõuavad mõlemas rakenduses teist kinnitust; vaata hävitavate toimingute kinnitamine.

Claude Code

claude mcp add --transport http thunderphone https://api.thunderphone.com/v1/mcp \
  --header "Authorization: Bearer $THUNDERPHONE_API_KEY"

Codex

Lisa see faili ~/.codex/config.toml:

[mcp_servers.thunderphone]
url = "https://api.thunderphone.com/v1/mcp"
bearer_token_env_var = "THUNDERPHONE_API_KEY"

Cursor

Loo .cursor/mcp.json:

{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}

Claude Desktop

Lisa Claude Desktopi seadistusse mcp-remote-sild:

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

Loo .vscode/mcp.json ja sisesta võti VS Code'i sisestusviiba kaudu:

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

Tööriistad

Igal tööriistal on MCP annotatsioonid. Tabelites tähendab R ainult lugemist, D hävitavat toimingut, I idempotentset toimingut ja O avatud maailma-/võrgusuhtlust. Kriips tähendab, et vihjet pole määratud.

Ühendus

Tööriist	Peamised argumendid	Annotatsioonid	Funktsioon
`get_connection_identity`	—	R, I	Kontrollib mandaadi kehtivust ning tagastab selle organisatsiooni ja mandaadi turvalised metaandmed.

Agendid

Tööriist	Peamised argumendid	Märkused	Mida see teeb
`list_agents`	—	R, I	Loetleb agendid.
`get_agent`	`agent_id`	R, I	Hangib ühe agendi.
`create_agent`	agendi konfiguratsioon	—	Loob agendi.
`update_agent`	`agent_id`, muudetud väljad	D	Salvestab väljad agendi mustandisse, asendades mustandis olnud väärtused. Käivitub ilma kinnitamiseta: juurutatud agent ei muutu enne `deploy_agent` käivitamist ning `discard_agent_draft` taastab mustandi.
`deploy_agent`	`agent_id`, valikuline `if_updated_at`	D, I	Edendab mustandi tootmisse.
`discard_agent_draft`	`agent_id`, valikuline `if_updated_at`, `confirmation_token` teisel päringul	D, I	Hülgab etapiviisiliselt salvestatud muudatused. Kaheastmeline, vaata hävitavate toimingute kinnitamine.
`duplicate_agent`	`agent_id`, valikuline `name`	—	Kopeerib agendi organisatsiooni sees.
`delete_agent`	`agent_id`, `confirmation_token` teisel päringul	D, I	Kustutab agendi jäädavalt. Kaheastmeline.
`list_agent_versions`	`agent_id`	R, I	Loetleb juurutatud konfiguratsiooniversioonid.

Telefoninumbrid ja operaatorid

Tööriist	Peamised argumendid	Märkused	Mida see teeb
`list_phone_numbers`	—	R, I	Loetleb organisatsiooni numbrid ja suunamise.
`get_phone_number_limits`	—	R, I	Hangib hallatavate numbrite kasutuse ja piirangud.
`provision_phone_number`	valikulised `area_code`, `city`, `state`, `idempotency_key`	D, O	Ostab ThunderPhone'i hallatava sissetuleva numbri.
`list_voip_connections`	—	R, I	Loetleb ühendatud kliendioperaatorid.
`search_voip_numbers`	`connection_id`, `country`, `type`, valikuline `area_code`	R, I, O	Otsib operaatori numbrivarudest.
`import_voip_numbers`	`connection_id`, `numbers`	D, O	Impordib operaatori juures juba olevad numbrid.
`update_phone_number`	`phone_number_id`, suunamise/sildi/webhooki väljad	D	Uuendab numbri suunamist, sealhulgas agendi määramist.
`delete_phone_number`	`phone_number_id`, `confirm`, valikuline `release_at_provider`, teisel päringul `confirmation_token`	D, I, O	Vabastab numbri. Kaheetapiline.

SMS

Tööriist	Peamised argumendid	Märkused	Mida see teeb
`send_sms`	`from_number`, `to`, `body`, `idempotency_key`	D, I, O	Saadab ühe lihttekstilise SMS-i ühendatud Twilio või Telnyx numbrilt.

Kõned

Tööriist	Peamised argumendid	Märkused	Mida see teeb
`list_calls`	valikulised filtrid, `limit`, `offset`	R, I	Loetleb kõned REST-i kõneajaloo filtrite abil.
`get_call`	`call_id`	R, I	Hangib kõne oleku ja metaandmed.
`get_call_transcript`	`call_id`, valikuline `live`	R, I	Hangib kõne transkriptsiooni.
`get_call_audio_url`	`call_id`, valikuline `download`	R, I, O	Tagastab allkirjastatud heli-URL-i; heli ei edastata kunagi MCP kaudu voogedastusena.
`get_call_grade`	`call_id`	R, I	Hangib uusima kõnehinde.
`place_call`	`agent_id`, `from_number`, `to_number`	D, O	Teeb ühe mitteidempotentse väljamineva kõne.
`export_calls`	kõnefiltrid, `export_format`	R, I	Ekspordib kuni REST-i lõpp-punkti piiranguni JSON-i või CSV-na.

Testimine ja valideerimine

Tööriist	Peamised argumendid	Märkused	Mida see teeb
`list_test_scenarios`	`agent_id`	R, I	Loetleb teststsenaariumid.
`create_test_scenario`	`agent_id`, `title`, `scenario_prompt`, valikulised tingimused	—	Loob stsenaariumi.
`generate_test_scenarios`	`agent_id`, valikulised `count`, `include_edge_cases`, `locale`	O	Genereerib häälagendi viibast stsenaariume.
`run_agent_tests`	`agent_id`, `channel`, `consent_to_charge`, valikuline valik/maatriks	D, O	Käivitab stsenaariumid veebi või telefonivõrgu kaudu.
`get_test_run`	`agent_id`, `batch_id`	R, I	Hangib partii oleku ja stsenaariumipõhised tulemused.
`list_validation_runs`	`agent_id`	R, I	Loetleb hiljutised mustandi valideerimiskäivitused.
`get_validation_status`	`agent_id`	R, I	Hangib uusima valideerimisoleku ja vastavuse mustandile.

Teadmised

Tööriist	Peamised argumendid	Annotatsioonid	Funktsioon
`list_knowledge_bases`	—	R, I	Loetleb teadmistebaasid.
`create_knowledge_base`	`name`, valikuline `description`	—	Loob teadmistebaasi.
`add_knowledge_document`	`knowledge_base_id`, `name`, `content`	—	Lisab teksti või Markdowni.
`import_knowledge_url`	`url`, valikuline `name`	O	Lisab avaliku lehe turvalise töötlemise järjekorda.
`search_knowledge`	`knowledge_base_id`, `query`	R, I	Otsib tootmiskeskkonna teabeotsingu kaudu.

Integratsioonid, webhookid ja kaug-MCP-serverid

Tööriist	Peamised argumendid	Märkused	Mida see teeb
`list_integrations`	—	R, I	Loetleb HTTP-funktsioonide integratsioonid.
`create_integration`	`display_name`, funktsiooni `spec`, valikulised lõpp-punkti väljad	—	Loob HTTP-tööriista. Lisa autentimispäised juhtpaneelil.
`test_integration`	`url`, valikuline meetod/sisuajalõpp, `integration_id` koos `header_names`-iga, `confirmation_token` teisel päringul	D, O	Saadab piiratud, SSRF-i eest kaitstud testpäringu. Salvestatud päiseväärtused täidetakse integratsioonist ja saadetakse ainult selle enda hostile. `POST` (vaikimisi), `PUT`, `PATCH` ja `DELETE` on kaheetapilised; `GET` käivitatakse kohe.
`list_webhook_endpoints`	—	R, I	Loetleb allkirjastatud webhooki lõpp-punktid.
`list_webhook_deliveries`	valikuline `agent_id`, valikuline `endpoint_id`	R, I	Loetleb hiljutiste sisuta webhooki edastuste tulemused.
`create_webhook_endpoint`	`label`, `url`, valikulised sündmused/olek	O	Loob allkirjastatud webhooki lõpp-punkti.
`test_webhook_endpoint`	`endpoint_id`	O	Saadab sünteetilise sündmuse tavapärase edastuse kaudu.
`list_mcp_servers`	—	R, I	Loetleb häälagentide poolt kutsutavad kaugserverid.
`create_mcp_server`	`display_name`, `url`	O	Registreerib ja sünkroonib kaugserveri. Autentimispäiseid vajavad serverid lisatakse juhtpaneelil.
`sync_mcp_server_tools`	`server_id`	D, O	Värskendab kaugserveri tööriistakataloogi.

Kampaaniad

Tööriist	Peamised argumendid	Annotatsioonid	Funktsioon
`list_campaigns`	—	R, I	Loetleb väljaminevad kampaaniad.
`create_campaign`	kampaania väljad	—	Loob kampaania mustandi.
`add_campaign_contacts`	`campaign_id`, `contacts`	—	Lisab kuni 5,000 JSON-kontakti.
`campaign_action`	`campaign_id`, `action`, valikuline `consent_to_charge`, `confirmation_token` teisel päringul	D, O	Käivitab `start`, `pause`, `resume` või `stop`. `start` ja `resume` on kaheetapilised; `pause` ja `stop` käivituvad kohe.
`get_campaign_stats`	`campaign_id`	R, I	Hangib loendurid ja hiljutised tulemused.

Hääled, arveldus ja dokumentatsioon

Tööriist	Peamised argumendid	Märkused	Mida see teeb
`list_voices`	—	R, I	Loetleb hääled ja toetatud keeled.
`preview_voice`	`voice`, `language`, `text`	O	Genereerib näidise ja tagastab allkirjastatud URL-i.
`list_voice_clones`	—	R, I	Loetleb kohandatud häälekloonid.
`get_billing_summary`	—	R, I	Hangib saldo ja ametlikud hinnatasemete hinnad; maksemuudatusi ei võimaldata.
`search_docs`	`query`, valikuline `limit`	R, I, O	Otsib avaliku dokumentatsiooni indeksist.
`get_doc_page`	`path`	R, I, O	Toob ühe avaliku Markdowni dokumentatsioonilehe.

Kõik tootetööriistad kasutavad samu REST-kooditeid nagu avalik API. Seetõttu kehtivad REST-i valideerimine, organisatsioonipõhine ulatus, rollid, arvelduse lubamine, kvoodid, TCPA kinnitus, teenusepakkuja turvalisus ja auditeerimiskäitumine muutmata kujul.

Hävitavate toimingute kinnitamine

D-tähisega tööriistad muudavad või eemaldavad midagi või alustavad päris inimestele helistamist. Tagasivõtmatud toimingud nõuavad kahte päringut. Esimene päring ei muuda midagi ja tagastab:

{
  "status": "confirmation_required",
  "action": "Delete agent",
  "target": { "id": 195, "name": "Front Desk Receptionist" },
  "confirmation_token": "…",
  "expires_in_seconds": 600,
  "next_step": "…"
}

Assistent näitab kasutajale, mida see mõjutab, ja küsib kinnitust. Seejärel kordab ta päringut samade argumentidega ning lisab confirmation_token. Token kehtib 10 minutit ja hõlmab üht organisatsiooni, üht tööriista ning üht täpset argumentide kogumit, seega nõuab kolme häälagendi kustutamine kolme kinnitust. campaign_action koos väärtusega pause või stop jätab selle sammu vahele, et käimasoleva kampaania saaks alati kohe peatada; sama kehtib test_integration kohta koos väärtusega GET. Mõned D-tähisega tööriistad töötavad ühe päringuga, sest D tähistab nende mõju, mitte serveripoolset kinnitust: update_agent asendab mustandis olnud sisu (discard_agent_draft taastab selle), deploy_agent asendab aktiivse konfiguratsiooni, update_phone_number suunab aktiivsed kõned ümber, sync_mcp_server_tools asendab kaugserveri tööriistakataloogi, import_voip_numbers suunab numbrid uuesti sinu operaatorile, run_agent_tests võib kulutada krediiti, send_sms ja place_call jõuavad päris inimeseni (place_call säilitab oma nõusoleku kinnituse) ning provision_phone_number ostab numbri. Sinu MCP-klient võib siiski paluda sul need heaks kiita.

Alustavad päringud

prompts/list pakub viit taaskasutatavat töövoogu:

create_inbound_receptionist
run_agent_tests
buy_and_attach_number
review_low_grade_calls
add_url_to_agent_knowledge

Kasuta käsku prompts/get koos loetletud päringu nime ja selle deklareeritud argumentidega, et saada käivitamisvalmis kasutajasõnum.

Ressursid

resources/list pakub avalikke vahemällu salvestatud viiteid:

URI	Sisu
`thunderphone://docs/llms.txt`	Avaliku dokumentatsiooni indeks.
`thunderphone://docs/quickstart`	Kiirstardi Markdown.
`thunderphone://pricing`	Kehtiva avaliku hinnastuse Markdown.

Loe ressurssi käsuga resources/read. Avalikud toomispäringud kasutavad lühikest ajalõppu, 2 MiB piirangut ja kümneminutilist protsessisisest vahemälu.

Protokoll ja vead

Server toetab protokolliversioone 2025-06-18 ja 2025-03-26; see peegeldab tagasi toetatud kliendiversiooni ning muul juhul valib 2025-06-18. See rakendab meetodeid initialize, ping, tööriistu, päringuid, ressursse ja teavitusi. Teavitused tagastavad 202 Accepted. See olekuta server ei paku SSE-kuulajat ega seansi kustutamist, seega tagastavad GET ja DELETE vastuse 405 Method Not Allowed koos päisega Allow: POST.

Tööriista tõrked jäävad edukateks JSON-RPC vastusteks väärtusega isError: true. Nende tekst sisaldab lühikest lauset, millele järgneb JSON-plokk:

{
  "code": "insufficient_balance",
  "detail": "There is not enough prepaid balance.",
  "next_step": "Call get_billing_summary, add funds in Organization > Billing, then retry."
}

Eraldi prefiks outbound_tcpa_confirmation_required: säilitatakse käsu place_call jaoks. Tundmatud JSON-RPC meetodid tagastavad HTTP 200 vastuses väärtuse -32601. JSON-RPC pakke MCP 2025-06-18 ei toeta ning need tagastavad korrektse -32600 sobimatu päringu vea.