Connect tools & data

ThunderPhone을 MCP 서버로 사용하기

모든 Streamable HTTP MCP 클라이언트를 ThunderPhone에 연결하여 에이전트 목록을 확인하고, 통화 및 대화 내용을 검토하며, 조직 API 키로 발신 전화를 걸 수 있습니다.

ThunderPhone은 다음 위치에 Model Context Protocol 서버를 제공합니다.

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

조직의 에이전트와 통화를 도구로 사용할 수 있도록 MCP 클라이언트를 해당 Streamable HTTP 엔드포인트에 연결합니다. 이는 원격 MCP 서버를 음성 에이전트에 연결하는 것과 반대 방향입니다.

인증#

조직 → 키에서 sk_live_ 키를 만들고 Bearer 토큰으로 전송합니다. MCP 엔드포인트는 대시보드 세션 쿠키나 게시 가능한 위젯 키가 아닌 조직 API 키를 허용합니다.

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

사용 가능한 도구#

모든 도구는 API 키에 연결된 조직 범위로 제한됩니다. 다른 조직의 ID는 사용할 수 없는 것으로 처리됩니다.

프로토콜 메서드#

이 엔드포인트는 Streamable HTTP 클라이언트에 필요한 MCP JSON-RPC 메서드를 구현합니다.

• 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에 접근할 수 있는 클라이언트는 운영 환경의 발신자로 취급하십시오. 클라이언트를 사용할 수 있는 대상을 제한하고, 자체 프롬프트에서 의도한 에이전트와 번호를 명확히 지정하며, 통화 기록에서 통화를 검토하십시오.

전체 와이어 참조#

응답 예시, JSON-RPC 오류 및 원격 서버 관리 API는 MCP 서버 API를 참조하십시오.