Wavix

公式

Wavixは、音声、SMS、2FA、電話番号のAPIを提供するグローバルコミュニケーションプラットフォームです。当社のMCPサーバーは、これらの機能をAIエージェントやエージェンティックワークフローにもたらします。

GitHub

このMCPを試すスポンサー

Wavix MCPで何ができますか？

トランザクショナルSMS/MMSの送信 — sms_and_mms_messages_send を使用してメッセージを送信し、メッセージIDと配信ステータスを返します。
2FA認証フローの実行 — two_fa_verification_create でコードを作成し、two_fa_verification_check で検証します。
電話番号の検索と購入 — buy_numbers_list で利用可能な番号を検索し、cart_add でカートに追加し、cart_checkout で購入を完了します。
通話文字起こしの検索 — cdrs_search を使用して文字起こしキーワードで通話を検索し、cdrs_get で結果を補完します。
録音の取得と文字起こし — call_recording_get で録音を取得し、cdrs_retranscribe で文字起こしをリクエストし、cdrs_transcription_get で結果を取得します。
請求とインボイスの監査 — billing_transactions_list で支出を確認し、billing_invoices_download でインボイスPDFをダウンロードします。

ドキュメント

Wavix MCP サーバー

LLM や AI エージェントに Wavix テレコムプラットフォーム への直接アクセスを提供する Model Context Protocol サーバーです。SMS/MMS、音声通話、2FA、SIP トランキング、電話番号管理、10DLC 登録、通話録音、音声分析、請求に対応しています。

Wavix は、単一の API で SMS 送信、音声通話、2FA フローを実行できるグローバル通信プラットフォームです。無料トライアルが利用可能で、有料利用はアカウントに紐づく Wavix の料金プランに従います。

この MCP サーバーを最も手軽に使う方法は、ホスト型エンドポイント https://mcp.wavix.com/mcp を利用することです。MCP 互換クライアントをそこに向け、Wavix API キーで認証するだけです。セルフホストが必要な場合（カスタム Wavix デプロイ、ファイアウォール内、専用インスタンス）は、自分で実行するを参照してください。

エンドポイント
インストール — ワンクリック、Claude Code、Claude Desktop / Web、Cursor、VS Code、Codex CLI、Windsurf
自分で実行する（セルフホスト）
例
ツール → TOOLS.md の完全カタログ
リソース
認証（ベストプラクティス、トークンが漏洩した場合）
トラブルシューティング
互換性と制限
サポート、コントリビューション、セキュリティ、ライセンス

エンドポイント

フィールド	値
URL	`https://mcp.wavix.com/mcp`
トランスポート	Streamable HTTP
認証	`Authorization: Bearer <api_key>`
ツール	TOOLS.md を参照
リソース	Wavix ドキュメント + OpenAPI 仕様（自動検出）

Wavix API キーは Wavix Console → Administration → API keys → Create new から取得できます。

インストール

始める前に: Wavix API キーを用意してください。

https://wavix.com にサインインします。
Administration → API keys を開きます。
Create new をクリックします（または既存のキーをコピー）。後で YOUR_API_KEY の場所に貼り付けるので、手元に保管しておいてください。

ワンクリックインストール

⚠️ 下のボタンは、エディタの MCP 設定にプレースホルダートークン YOUR_API_KEY をシードします。 エディタのインストールが完了したら、生成された設定を開き、リクエストを送信する前にプレースホルダーを実際の API キーに置き換えてください。そうしないと、すべての呼び出しが 401 Unauthorized を返します。

後で削除するには: 同じ設定ファイル（~/.cursor/mcp.json、.vscode/mcp.json、またはお使いのエディタに相当するファイル）を開き、wavix エントリを削除するか、エディタの MCP / Connectors UI からコネクタを削除します。

Claude Code

claude mcp add --transport http wavix https://mcp.wavix.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

検証には claude mcp list を使用し、セッション内で /mcp を使用してステータスを確認します。

Claude Desktop / Claude Web

設定 → Connectors → Add custom connector:

名前: Wavix
URL: https://mcp.wavix.com/mcp
トランスポート: Streamable HTTP
認証ヘッダー: Authorization: Bearer <api_key>

Cursor（手動）

~/.cursor/mcp.json（またはプロジェクトレベルの .cursor/mcp.json）に追加します:

{
  "mcpServers": {
    "wavix": {
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Cursor 2.4+ では完全なカタログが表示されます。それ以前のバージョンでは 40 個に制限されます。

VS Code（手動、GitHub Copilot Chat）

ワークスペースに .vscode/mcp.json を作成します（または、ユーザー settings.json の "mcp" キーの下に同じ servers オブジェクトを追加します）:

{
  "servers": {
    "wavix": {
      "type": "http",
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

最新のスキーマについては VS Code MCP servers guide を参照してください。

Codex CLI

Codex CLI は stdio 経由の MCP をサポートしています。mcp-remote を介してホスト型サーバーにブリッジします。~/.codex/config.toml を編集します:

[mcp_servers.wavix]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp.wavix.com/mcp",
  "--header",
  "Authorization:Bearer ${WAVIX_API_KEY}"
]

[mcp_servers.wavix.env]
WAVIX_API_KEY = "YOUR_API_KEY"

Windsurf / その他のクライアント

カスタムヘッダー付きの Streamable HTTP トランスポートをサポートする MCP クライアントであれば動作します。以下を使用します:

URL: https://mcp.wavix.com/mcp
ヘッダー: Authorization: Bearer <api_key>

AI エージェント経由で設定しますか？ エージェントを llms-install.md に向けてください。これは機械可読なインストールガイドで、モデルに URL、ヘッダー、クライアントごとの設定を決定的な形式で提供するため、エンドポイント値を推測しません。

自分で実行する

ホスト型サーバーはほとんどのユーザーにそのまま動作します。非公開の Wavix デプロイを指す必要がある場合、ファイアウォールの内側で実行する場合、または自社インフラ内で運用する場合は、セルフホストしてください。

Docker

docker build -t wavix-mcp-server .
docker run --rm -p 8000:8000 wavix-mcp-server

サーバーはポート 8000 でリッスンし、MCP エンドポイントを /mcp で公開します。クライアントを http://<host>:8000/mcp に向けてください。

ソースから

git clone https://github.com/Wavix/wavix-mcp-server.git
cd wavix-mcp-server
pip install -e .
wavix-mcp

Python 3.10+ が必要です。

設定

環境変数	デフォルト	目的
`WAVIX_API_BASE_URL`	`https://api.wavix.com`	上流の Wavix API エンドポイントを上書きします（内部デプロイやステージング用）

サーバーを実行するために Wavix の認証情報は不要です。認証情報は MCP クライアントの Authorization: Bearer <api_key> ヘッダーからリクエストごとに転送されます。セルフホストする場合は、サーバーを公開する前に TLS 終端（nginx、Caddy、クラウドロードバランサー）をサーバーの前段に配置する責任があります。

例

接続済みの任意のクライアントにそのまま貼り付けられる具体的なプロンプトです。

以下の電話番号（+1 310 555 0100、+44 7700 900123）は予約済みのテスト範囲（NANP 555 と Ofcom 070 09xx）にあります。そのままコピーしても安全で、実際の加入者には到達しません。

トランザクション SMS を送信する

プロンプト: 「+13105550100 から +447700900123 に『Your verification code is 4821』という SMS を送信してください。」

エージェントは sms_and_mms_messages_send を from、to、text とともに呼び出します。メッセージ ID と配信ステータスが返されます。

2FA 検証を実行する

プロンプト: 「+13105550100 に SMS で 2FA 検証コードを送信してください。受け取ったコードを教えたら、それが正しいか確認してください。」

エージェントは two_fa_verification_create を呼び出し、SMS で届いたコードを共有するのを待ってから、two_fa_verification_check を呼び出します。統合コードを書かずにパスワードレスフローのプロトタイプを作成するのに便利です。

電話番号を検索して購入する

プロンプト: 「SMS 対応の米国フリーダイヤル番号で利用可能なものを探して、カートに追加して、チェックアウトしてください。」

エージェントは buy_numbers_list（国と機能でフィルタリング）、cart_add、cart_checkout を連鎖させます。チェックアウト前にユーザーに確認してください。アカウントに請求が発生します。

通話文字起こしを検索する

プロンプト: 「昨日の着信通話で、2 分以上で、発信者が『refund』と言ったものをすべて表示してください。」

エージェントは文字起こしに対して cdrs_search を使用し、各結果を cdrs_get で完全な通話メタデータにエンリッチします。

録音を取得して文字起こしする

プロンプト: 「通話 abc-123 の録音を取得して、Wavix に文字起こしを依頼し、文字起こし結果を返してください。」

エージェントは call_recording_get（事前署名付きダウンロード URL を返す）、cdrs_retranscribe を呼び出し、その後 cdrs_transcription_get をポーリングします。

請求を監査する

プロンプト: 「先月の SMS にいくら使いましたか？最新の請求書 PDF のダウンロードリンクを教えてください。」

エージェントはタイプと日付でフィルタリングした billing_transactions_list を呼び出し、次に billing_invoices_list + billing_invoices_download を呼び出します。ダウンロードツールはファイル自体ではなく PDF への事前署名付き URL を返します。ブラウザで URL を開くか、クライアントに渡して実際のドキュメントを取得してください。

ツール

Wavix OpenAPI 仕様から生成された 122 個のツール。引数はリクエストパラメータとボディフィールドを反映しています。

グループ	#	対象範囲
SMS と MMS	10	送信、一覧表示、メッセージ取得、送信者 ID、オプトアウト
通話制御	9	通話の開始 / 応答 / 終了、音声再生、DTMF 収集
通話録音	4	一覧表示、ダウンロード（事前署名 URL）、削除
通話ストリーミング	2	メディアストリームの開始 / 停止
通話 Webhook	3	一覧表示、作成、削除
CDR	7	一覧表示、エクスポート、取得、文字起こし検索と再文字起こし
音声分析	4	アップロード、文字起こし、元ファイルの取得
2FA	6	検証の作成 / 確認 / キャンセル / 再送信、イベント
マイナンバー	6	一覧表示、更新、解放、SMS / 音声ルーティング、ドキュメントアップロード
購入	5	国、地域、都市、利用可能な番号の検索
カート	4	追加、削除、取得、チェックアウト
番号バリデータ	3	単一および一括検証
SIP トランク	5	完全な CRUD
10DLC	30	ブランド、キャンペーン、ベッティング、エビデンス、イベントサブスクリプション
プロフィール	3	プロフィールの取得 / 更新、アカウント設定
API キー	4	一覧表示、作成、有効化 / 無効化、削除
サブアカウント	5	一覧表示、作成、取得、更新、取引
請求	3	取引、請求書、明細書のダウンロード
音声キャンペーン	2	トリガーと取得
Wavix Embeddable (WebRTC)	5	ウィジェットトークンの CRUD
リンク短縮	2	短縮リンクの作成、メトリクス

完全なツールリストと 1 行の説明については TOOLS.md を参照してください。権威あるソースは Wavix OpenAPI 仕様です。クライアントは常に現在のライブカタログを参照します。

リソース

ツールに加えて、サーバーは Wavix ドキュメントを MCP リソースとして公開します。これにより、モデルは事前知識から推測するのではなく、必要に応じて権威あるコンテキストを取得できます。

URI スキーム	内容
`wavix://docs/<path>`	docs.wavix.com のドキュメントページ（`llms.txt` 経由で自動検出）。
`wavix://api/openapi.yaml`	完全な Wavix OpenAPI 3.0 仕様。

両方のソース — docs.wavix.com と Wavix OpenAPI 仕様 — は公開されており、認証なしで直接閲覧できます。

リソースは resources/read で遅延フェッチされ、サーバー側で 1 時間の TTL でキャッシュされます。上流の Bearer トークンはドキュメントホストには決して転送されません。api.wavix.com にのみ送信されます。

認証

クライアントからのすべてのリクエストには以下を含める必要があります:

Authorization: Bearer <api_key>

サーバーはこのヘッダーをリクエストごとに api.wavix.com に転送します。トークンは:

決してログに記録されません、
クロスホストのリダイレクト（事前署名付き S3 ダウンロード URL など）では決して転送されません、
ドキュメントホストには決して送信されません。

クライアントが call_recording_get、billing_invoices_download、speech_analytics_file_get、または ten_dlc_brand_evidence_get によって返された事前署名付きダウンロード URL をたどる場合は、Authorization ヘッダーなしで直接フェッチしてください。

ベストプラクティス

MCP 専用の API キーを使用する。 https://wavix.com → Administration → API keys（または別のセッションから api_keys_create ツール自体を使用）で専用の API キーを作成します。これにより、他の統合を中断せずに MCP アクセスのみを失効させることができます。
定期的にローテーションする。 API キーは本番の秘密情報と同様に扱い、スケジュールに従って、また漏洩が疑われる場合にはローテーションしてください。
API キーを git に保存しない。 MCP クライアント設定は誤ってコミットされやすく、トークンが履歴や CI ログに残る可能性があります。ほとんどのクライアントはヘッダー値で ${env:VAR} 置換をサポートしています。API キーを環境変数や OS のキーチェーンに保存し、設定から参照してください。安全策として、一般的なクライアント設定パスをプロジェクトの .gitignore に追加してください:
```
.cursor/mcp.json
.vscode/mcp.json
claude_desktop_config.json
.claude/mcp.json
.codex/config.toml
```

トークンが漏洩した場合

Wavix コンソールで、キーを直ちに無効化します（または api_keys_deactivate を呼び出します）。
api_keys_create またはコンソールを使用して、置き換え用のキーを作成します。
クライアントの設定を更新し、再接続します。
予期しないアクティビティがないか、billing_transactions_list と cdrs_list を確認します。

トラブルシューティング

症状	考えられる原因 / 対処法
任意のツールから `401 Unauthorized`	`Authorization: Bearer …` ヘッダーが欠落しているか無効です。Wavix コンソールで API キーが有効であることを確認してください。
ツールがファイル自体ではなく `download_url` を返す	想定どおりです。録音、請求書、音声分析、10DLC 証拠の各エンドポイントは、事前署名付き URL を返します（認証を参照）。`Authorization` ヘッダーなしで URL に直接アクセスしてください。
クライアントに全カタログではなく約 40 個のツールしか表示されない	古いクライアントはサーバーごとのツール数の上限を適用します。アップグレードしてください（Cursor 2.4+、最新の VS Code、最新の Claude）。
この README に記載されているツールで `Tool not found`	ローカルクライアントが古いツールリストをキャッシュしている可能性があります。クライアントを再起動するか、サーバーを削除して再追加してください。
`errors` 配列を伴う 4xx	Wavix API からの検証エラーです。`errors` を確認し、関連する `wavix://docs/*` ページまたは OpenAPI 仕様と照合してください。
サーバーに到達できない	`mcp.wavix.com:443` への DNS と送信 HTTPS を確認してください。
エージェントが予期せず破壊的なツールを呼び出す	ほとんどのクライアントはツール呼び出し前に確認を要求できます。その設定を有効にし、専用の MCP API キーにローテーションしてください（ベストプラクティスを参照）。

互換性と制限

Streamable HTTP トランスポートをサポートする任意の MCP クライアント（Claude Desktop / Web / Code、Cursor 2.4+、VS Code、Windsurf、カスタム MCP SDK）および MCP クライアントアダプターを備えた任意のエージェントフレームワークと互換性があります。
古いクライアントはサーバーごとのツール数の上限を適用する場合があります。全カタログにアクセスするには、最新バージョンにアップグレードしてください。
レート制限と利用料金は、お客様の Wavix アカウントプランに従います。Wavix の料金を参照してください。

変更履歴

ホスト型サーバーは、Wavix OpenAPI 仕様の進化に合わせて継続的に更新されます。新しいツールは自動的に追加され、既存のツールの引数にオプションフィールドが追加される場合があります。このリポジトリのドキュメント変更はリリースで追跡されます。ツールの入力や認証に影響する大幅な動作変更については、そこおよび Wavix リリースノートの両方でお知らせを公開します。

サポート

製品ドキュメント: https://docs.wavix.com
API リファレンス: https://docs.wavix.com/api-reference
質問 / フィードバック: support@wavix.com

コントリビューション

このリポジトリはソース公開されていますが、外部からのコントリビューションは受け付けていません。プルリクエストは自動的にクローズされ、Issues / Discussions は無効になっています。バグ報告、機能リクエスト、フィードバックは support@wavix.com に送信してください。詳細は CONTRIBUTING.md を参照してください。

基盤となる FastMCP フレームワークにバグを見つけた場合は、上流で報告してください。

セキュリティ

セキュリティの脆弱性を報告するには、公開の issue を開くのではなく、件名を Security: <short summary> として support@wavix.com にメールを送信してください。詳細は SECURITY.md を参照してください。