用 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. 01將伺服器加入 Claude 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」，用同一個網址 https://mcp.voice.wixzel.com/mcp 新增自訂連接器。按下「Connect」，登入主控台並核准權限範圍。這個連接器會取得自己的金鑰，您隨時可以在主控台的「AI 用戶端」頁面將它中斷連接，金鑰會立即失效。

   從 mcpServers JSON 設定在本機啟動伺服器的用戶端（例如 Cursor），會從 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 提示詞設定您的帳號

   伺服器內建一個 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 直到通話結束，再為您讀出逐字稿、狀態以及 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 為您購買號碼，由您的電信業者計費。
• 付費工具執行前的核准由用戶端顯示。伺服器會標記這些工具並要求模型確認；設定為自動核准工具的用戶端不會詢問，因此請對這個伺服器關閉自動核准。
• 每個帳號預設最多可同時進行五通通話，可申請提高上限。
• 測試通話就是真實通話：它會透過您的電信業者撥打真實電話，並開始計費。沒有免費測試模式。
• Wixzel Voice 的行為變更一律透過附日期的 Wixzel-Version 標頭推出。