Користите ThunderPhone као MCP сервер

ThunderPhone излаже сервер протокола контекста модела на адреси:

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

Усмерите MCP клијент на ту Streamable HTTP крајњу тачку да бисте агенте и позиве своје организације учинили доступним као алате. Ово је супротан смер од повезивања удаљеног MCP сервера са гласовним агентом:

Смер	Резултат
Удаљени MCP сервер → ThunderPhone агент	Ваш гласовни агент може да позива алате удаљеног сервера.
ThunderPhone → ваш MCP клијент	Ваш MCP клијент може да позива ThunderPhone алате за агенте и позиве.

Аутентификација

Креирајте sk_live_ кључ у оквиру Организација → Кључеви и пошаљите га као Bearer токен. MCP крајња тачка прихвата API кључеве организације, а не колачиће сесије контролне табле или објављиве кључеве виџета.

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

Доступни алати

Алат	Аргументи	Шта ради
`list_agents`	нема	Приказује агенте организације са идентификатором, именом, производом и гласом.
`get_agent`	`agent_id`	Преузима једног агента.
`place_call`	`agent_id`, `from_number`, `to_number`	Упућује одлазни позив уз исту проверу ваљаности и услове наплате као REST крајња тачка за позиве.
`get_call`	`call_id`	Преузима статус позива, сажетак и оцену.
`list_calls`	опционални `limit` (1–100), опционални `status`	Приказује недавне позиве.
`get_call_transcript`	`call_id`	Преузима комплетан транскрипт позива.

Сви алати су ограничени на организацију повезану са API кључем. Идентификатор из друге организације понаша се као да није доступан.

Методе протокола

Крајња тачка имплементира MCP JSON-RPC методе потребне за Streamable HTTP клијенте:

initialize
notifications/initialized
tools/list
tools/call

Каталог алата можете директно прегледати:

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

Позовите алат са његовим именом и аргументима:

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

Резултати алата су MCP ставке текстуалног садржаја. Неуспеси алата враћају се у резултату са isError: true; непознате JSON-RPC методе враћају грешку протокола.

Безбедно упућивање позива

place_call следи иста правила као POST /v1/call: агент и број морају припадати организацији кључа, број мора испуњавати услове за одлазне позиве, организација мора имати довољно средстава и свака применљива потврда за одлазне позиве мора бити завршена.

Третирајте клијент са приступом алату place_call као продукционог позиваоца. Ограничите ко може да користи клијент, јасно наведите предвиђеног агента и број у његовом сопственом упиту, и прегледајте позиве у Историји позива.

Комплетна референца протокола

Погледајте API за MCP сервере за примере одговора, JSON-RPC грешке и API за управљање удаљеним сервером.