ThunderPhone을 MCP 서버로 사용하기

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

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

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

방향	결과
원격 MCP 서버 → ThunderPhone 에이전트	음성 에이전트가 원격 서버의 도구를 호출할 수 있습니다.
ThunderPhone → MCP 클라이언트	MCP 클라이언트가 에이전트와 통화를 위한 ThunderPhone 도구를 호출할 수 있습니다.

인증

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

Generic client configuration

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

sk_live_ 키는 조직 데이터에 접근하고 통화를 발신할 수 있습니다. 브라우저 코드, 리포지토리, 스크린샷 및 채팅 로그에 포함하지 마십시오. MCP 클라이언트가 지원하는 시크릿 저장소를 사용하고, 키가 노출된 경우 즉시 폐기하십시오.

사용 가능한 도구

도구	인수	기능
`list_agents`	없음	ID, 이름, 제품 및 음성과 함께 조직 에이전트를 나열합니다.
`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 키에 연결된 조직 범위로 제한됩니다. 다른 조직의 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를 참조하십시오.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Compliance

Developer cookbook

Operations

ThunderPhone을 MCP 서버로 사용하기

인증

사용 가능한 도구

프로토콜 메서드

안전하게 통화 발신하기

전체 와이어 참조

​인증

​사용 가능한 도구

​프로토콜 메서드

​안전하게 통화 발신하기

​전체 와이어 참조

인증

사용 가능한 도구

프로토콜 메서드

안전하게 통화 발신하기

전체 와이어 참조