Tumia ThunderPhone kama seva ya MCP

ThunderPhone hutoa seva ya Model Context Protocol katika:

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

Elekeza mteja wa MCP kwenye kituo hicho cha Streamable HTTP ili kufanya ejenti na simu za shirika lako zipatikane kama zana. Huu ni mwelekeo kinyume na kuunganisha seva ya mbali ya MCP kwenye ejenti wa sauti:

Mwelekeo	Matokeo
Seva ya mbali ya MCP → ejenti wa ThunderPhone	Ejenti wako wa sauti anaweza kuita zana za seva ya mbali.
ThunderPhone → mteja wako wa MCP	Mteja wako wa MCP anaweza kuita zana za ThunderPhone kwa ajili ya ejenti na simu.

Thibitisha utambulisho

Unda ufunguo wa sk_live_ chini ya Shirika → Funguo na uutume kama tokeni ya Bearer. Kituo cha MCP kinakubali funguo za API za shirika, si vidakuzi vya kipindi cha dashibodi au funguo za wijeti zinazoweza kuchapishwa.

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

Zana zinazopatikana

Zana	Hoja	Inachofanya
`list_agents`	hakuna	Huorodhesha ejenti za shirika zenye id, jina, bidhaa, na sauti.
`get_agent`	`agent_id`	Hurejesha ejenti mmoja.
`place_call`	`agent_id`, `from_number`, `to_number`	Hupiga simu ya kutoka kwa uthibitishaji na vizuizi vya utozaji sawa na vya kituo cha REST cha simu.
`get_call`	`call_id`	Hurejesha hali ya simu, muhtasari, na daraja.
`list_calls`	`limit` ya hiari (1–100), `status` ya hiari	Huorodhesha simu za hivi karibuni.
`get_call_transcript`	`call_id`	Hurejesha nakala kamili ya mazungumzo ya simu.

Zana zote zimewekewa mipaka kwa shirika linalohusishwa na ufunguo wa API. Id kutoka shirika lingine huchukuliwa kuwa haipatikani.

Mbinu za itifaki

Kituo hiki hutekeleza mbinu za MCP JSON-RPC zinazohitajika kwa wateja wa Streamable HTTP:

initialize
notifications/initialized
tools/list
tools/call

Unaweza kukagua katalogi ya zana moja kwa moja:

curl -X POST https://api.thunderphone.com/v1/mcp \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Ita zana kwa jina na hoja zake:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_calls",
    "arguments": { "limit": 20, "status": "completed" }
  }
}

Matokeo ya zana ni vipengee vya maudhui ya maandishi ya MCP. Hitilafu za zana hurejeshwa katika matokeo kwa isError: true; mbinu zisizojulikana za JSON-RPC hurejesha hitilafu ya itifaki.

Kupiga simu kwa usalama

place_call hufuata kanuni sawa na POST /v1/call: ejenti na nambari lazima ziwe za shirika la ufunguo, nambari lazima iruhusiwe kupiga simu za kutoka, shirika lazima liwe na salio la kutosha, na uthibitisho wowote unaohitajika wa kupiga simu za kutoka lazima ukamilike.

Mteja mwenye ufikiaji wa place_call mchukulie kama mpigaji simu wa uzalishaji. Zuia nani anaweza kutumia mteja, bainisha wazi ejenti na nambari inayokusudiwa katika prompt yake, na kagua simu katika Historia ya Simu.

Marejeleo kamili ya mawasiliano

Tazama API ya Seva za MCP kwa mifano ya majibu, hitilafu za JSON-RPC, na API ya usimamizi wa seva za mbali.