Wixzel Voice MCP 서버로 Claude에게 실제 전화 회선 연결하기

시작하기 전에 무엇이 필요한가요?

• 크레딧이 있는 Wixzel Voice 계정. 최소 충전 금액은 $5이며, 통화용 무료 체험 크레딧은 없습니다.
• 이미 사용 중인 통신사(Twilio, Telnyx, Plivo, Vonage, Bandwidth, Exotel, Vobiz 또는 모든 SIP 제공업체)의 SIP 트렁크와 그 트렁크에 연결된 전화번호. Wixzel Voice는 번호를 판매하거나 이전(포팅)하지 않습니다. 통신사 계정이 Twilio, Telnyx, Plivo, Vobiz, Vonage이고 콘솔에서 연결했다면 Wixzel Voice에서 그 계정으로 번호를 구매할 수 있으며, 요금은 통신사가 청구합니다.
• Claude Code, 또는 사용 중인 요금제에서 사용자 지정 커넥터를 쓸 수 있는 claude.ai나 Claude Desktop.

Wixzel Voice에서 단계별로 어떻게 만드나요?

1. 01Claude Code에 서버 추가하기

   호스팅 서버의 주소는 https://mcp.voice.wixzel.com/mcp이며 OAuth로 로그인하므로 API 키를 어디에도 붙여 넣지 않습니다. 터미널에서 다음 명령으로 추가합니다.

   shell복사

   claude mcp add --transport http wixzel-voice https://mcp.voice.wixzel.com/mcp

   Claude Code 안에서 /mcp를 입력하고 wixzel-voice 서버를 선택한 뒤 Authenticate를 고릅니다. 브라우저에서 콘솔이 열리면 로그인하고, 클라이언트에 주고 싶지 않은 스코프의 체크를 해제한 다음 승인합니다. Claude Code는 승인한 스코프로 제한된 전용 API 키를 받습니다.

2. 02또는 claude.ai나 Claude Desktop에 추가하기

   Settings에서 Connectors를 열고 같은 URL https://mcp.voice.wixzel.com/mcp로 사용자 지정 커넥터를 추가합니다. Connect를 누르고 콘솔에 로그인한 뒤 스코프를 승인합니다. 커넥터는 전용 키를 받으며, 콘솔의 AI 클라이언트 페이지에서 언제든 연결을 해제할 수 있고, 해제하는 즉시 키가 작동을 멈춥니다.

   Cursor처럼 mcpServers JSON 설정으로 서버를 로컬에서 실행하는 클라이언트는 같은 서버를 npm에서 받아, 환경 변수에 API 키를 넣고 실행합니다.

   shell복사

   claude mcp add wixzel-voice -e WIXZEL_API_KEY=wv_live_... -- npx -y wixzel-voice-mcp

   json복사

   {
     "mcpServers": {
       "wixzel-voice": {
         "command": "npx",
         "args": ["-y", "wixzel-voice-mcp"],
         "env": { "WIXZEL_API_KEY": "wv_live_..." }
       }
     }
   }

3. 03빠른 시작 프롬프트로 계정 설정하기

   서버에는 quickstart 프롬프트가 포함되어 있으며, Claude Code에서는 슬래시 명령으로 표시됩니다. "치과 예약 확인하기"처럼 목표를 선택적으로 넘길 수 있습니다.

   Claude Code복사

   /mcp__wixzel-voice__quickstart

   Claude는 먼저 이미 있는 것(list_sip_trunks, list_phone_numbers, list_agents, get_balance)을 조회해 중복을 만들지 않습니다. 그다음 서버의 운영 가이드가 정한 순서대로 진행합니다. list_engines로 사용할 수 있는 엔진과 요금을 확인하고, 사용자가 알려 준 통신사 자격 증명으로 create_sip_trunk를 실행하고, 그 트렁크에 create_phone_number를 실행한 뒤, 짧은 구어체 프롬프트와 첫 인사, 발신자 번호를 넣어 create_agent를 실행합니다. 자격 증명은 지어내지 않고 사용자에게 묻고, 전화를 거는 작업 앞에서는 멈춥니다.

   통신사 쪽 설정 두 가지는 사용자만 바꿀 수 있습니다. 새 트렁크가 반환하는 platform_ip를 허용 목록에 추가해 통신사가 그 IP의 발신 통화를 받아들이게 하고, 통신사의 수신 라우팅을 트렁크의 origination_uri로 지정합니다. Claude가 두 값을 모두 읽어 주며, check_sip_trunk_status로 트렁크에 연결할 수 있는지 확인할 수 있습니다.

4. 04통화를 요청하고 승인하기

   에이전트와 번호가 준비되면 평소 말하듯이 요청합니다.

   prompt복사

   Call +14155551234 with the Support agent. Ask whether tomorrow's 10:00
   delivery slot still works, and tell me what they said.

   Claude는 place_call을 고릅니다. 이 도구는 비용이 발생하고 실제 전화를 울리는 도구로 표시되어 있고, 도구 설명이 모델에게 먼저 사용자에게 확인하라고 지시하므로 클라이언트가 실행 전에 승인을 요청합니다. 모든 place_call에는 멱등성 키가 붙습니다. 재시도는 Claude가 같은 idempotency_key를 다시 넘길 때만 안전하며, 도구 설명이 그렇게 하도록 요청합니다.

   대화를 나누는 것은 Claude가 아니라 직접 만든 음성 에이전트입니다. Claude는 통화가 끝날 때까지 get_call을 폴링한 뒤 대화 기록, 상태, 그리고 비용을 100만분의 1달러 단위로 나타낸 cost_micros를 읽어 줍니다.

5. 05실행 전에 확인을 묻는 도구 알아 두기

   Wixzel Voice는 네 가지 도구를 비용이 발생하거나 현실에 영향을 주는 도구로 표시합니다. place_call은 번호로 전화를 걸고, test_call_agent는 번호로 전화를 걸어 한 문장을 말하고, start_campaign은 캠페인의 모든 리드에게 전화를 걸고, create_topup은 결제를 시작합니다. get_call이나 list_usage_events처럼 읽기만 하는 도구는 읽기 전용으로 표시되므로 클라이언트가 묻지 않고 실행할 수 있습니다.

   create_topup은 스스로 결제하지 않습니다. 사람이 직접 열어서 완료해야 하는 결제 링크를 반환합니다.

   스코프는 두 번째 안전장치입니다. 특정 스코프를 요청하지 않은 클라이언트에는 에이전트용 기본 세트가 제시됩니다. 충전을 시작하는 billing:write와 키를 발급하는 api_keys:write는 기본으로 제시되지 않으며 의도적으로 부여해야 합니다. 관리자 스코프는 없습니다.

6. 06통화가 실패하면 원인 묻기

   서버에는 프롬프트가 두 개 더 포함되어 있습니다.

   Claude Code복사

   /mcp__wixzel-voice__diagnose_call
   /mcp__wixzel-voice__spend_report

   diagnose_call은 통화 ID를 받아 기록의 failure_code와 failure_reason, 사용량 이벤트, 트렁크 상태, 최근 SIP 로그를 읽고, 해결할 곳이 통신사인지 에이전트인지 알려 줍니다. 진단하는 동안 전화를 걸지 않습니다. spend_report는 기간별 사용량을 구성 요소별, 통화별 달러 금액으로 정리합니다.

Wixzel Voice에서 이 빌드의 비용은 얼마인가요?

이 빌드에는 Wixzel Voice의 어떤 한도가 적용되나요?

• 전화 통화에는 직접 보유한 SIP 트렁크와 그 트렁크의 번호가 필요합니다. Wixzel Voice는 번호를 판매, 이전하거나 보유하지 않습니다. 콘솔에서 연결한 Twilio, Telnyx, Plivo, Vobiz, Vonage 계정이라면 phone_numbers:purchase 스코프를 부여한 뒤 Claude가 purchase_phone_number로 번호를 구매할 수 있으며, 요금은 통신사가 청구합니다.
• 유료 도구 실행 전의 승인 화면은 클라이언트가 표시합니다. 서버는 해당 도구를 표시하고 모델에게 확인하라고 지시할 뿐이므로, 도구를 자동 승인하도록 설정한 클라이언트는 묻지 않습니다. 이 서버에서는 자동 승인을 꺼 두십시오.
• 계정당 기본적으로 동시에 5건의 통화를 진행할 수 있으며, 요청하면 한도를 늘려 드립니다.
• 테스트 통화도 실제 통화입니다. 통신사를 통해 실제 전화가 울리고 요금이 계산됩니다. 무료 테스트 모드는 없습니다.
• Wixzel Voice의 동작 변경은 날짜 기반 Wixzel-Version 헤더로 구분되어 배포됩니다.