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. 02claude.aiまたはClaude Desktopに追加する

   「Settings」で「Connectors」を開き、同じURLhttps://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. 03quickstartプロンプトでアカウントをセットアップする

   サーバーには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を実行します。認証情報は勝手に作らずにユーザーに尋ね、発信を伴う操作の手前で止まります。

   通信事業者側には、ご自身でしか変更できない設定が2つあります。新しいトランクが返すplatform_ipを許可リストに追加して、通信事業者がそこからの発信を受け付けるようにすることと、通信事業者の着信ルートをトランクのorigination_uriに向けることです。Claudeはこの2つの値を読み上げ、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（100万分の1ドル単位の料金）を読み上げます。

5. 05実行前に確認を求めるツールを把握する

   Wixzel Voiceは、費用が発生する、または現実世界に影響する4つのツールにマークを付けています。place_callは番号に発信し、test_call_agentは番号を鳴らして1つのフレーズを話し、start_campaignはキャンペーンのすべてのリードに発信し、create_topupは支払いを開始します。get_callやlist_usage_eventsのような読み取るだけのツールは読み取り専用としてマークされているため、クライアントは確認なしで実行できます。

   create_topupが自動で支払うことはありません。返されるのはチェックアウトのリンクで、人が開いて手続きを完了する必要があります。

   スコープが2つ目の防御線です。特に何も指定しないクライアントには、エージェント向けの標準セットが提示されます。チャージを開始するbilling:writeと、キーを発行するapi_keys:writeはデフォルトでは提示されず、意図して付与する必要があります。管理者スコープはありません。

6. 06通話が失敗したら理由を尋ねる

   サーバーにはさらに2つのプロンプトが付属しています。

   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で番号を購入できます。料金は通信事業者から請求されます。
• 有料ツールの前の承認を表示するのはクライアントです。サーバーはそれらのツールにマークを付け、モデルに確認するよう指示しますが、ツールを自動承認する設定のクライアントは確認しません。このサーバーでは自動承認をオフにしておいてください。
• デフォルトでは、1アカウントあたり同時に5件まで通話できます。上限は申請により引き上げられます。
• テスト通話も実際の通話です。通信事業者経由で実際の電話を鳴らし、料金が発生します。無料のテストモードはありません。
• Wixzel Voiceの動作の変更は、日付付きのWixzel-Versionヘッダーで切り替える形でリリースされます。