Wavix

公式

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

GitHub

Wavix MCPで何ができますか？

SMSまたはMMSメッセージを送信 — アシスタントにテキストまたはメディアメッセージの送信を依頼するには、sms_and_mms_messages_send を使用します。
2FA認証フローを実行 — アシスタントに two_fa_verification_create で認証を作成させ、two_fa_verification_check で受け取ったコードを確認します。
電話番号を検索して購入 — buy_numbers_list で国と機能ごとに利用可能な番号を検索し、カートに追加して購入を完了します。
通話文字起こしを分析 — cdrs_search で特定のフレーズを含む通話記録を検索し、cdrs_get で完全なメタデータを取得します。
録音と文字起こしをダウンロード — call_recording_get で通話録音のURLを取得し、cdrs_retranscribe で文字起こしをリクエストし、結果を取得します。
請求の監査と請求書のダウンロード — 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 コンソール → 管理 → API キー → 新規作成 から取得します。

インストール

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

https://wavix.com でサインインします。
管理 → API キー を開きます。
新規作成 をクリックします（または既存のキーをコピーします）。手元に置いておき、以下の YOUR_API_KEY の代わりに貼り付けます。

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

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

後で削除するには: 同じ設定ファイル（~/.cursor/mcp.json、.vscode/mcp.json、または使用しているエディタの同等のファイル）を開き、wavix エントリを削除するか、エディタの MCP / コネクタ 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

設定 → コネクタ → カスタムコネクタを追加:

名前: 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 サーバーガイドを参照してください。

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 を送信してください。"

エージェントは from、to、text を使用して sms_and_mms_messages_send を呼び出します。メッセージ ID と配信ステータスを返します。

2FA 検証の実行

プロンプト: "SMS 経由で +13105550100 に 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 収集
通話録音	3	一覧表示、ダウンロード (事前署名付き URL)、削除
通話ストリーミング	2	メディアストリームの開始 / 停止
通話 Webhook	3	一覧表示、作成、削除
CDR	6	一覧表示、エクスポート、取得、文字起こし検索と再文字起こし
音声分析	4	アップロード、文字起こし、元ファイルの取得
2FA	6	作成 / 確認 / キャンセル / 検証の再送信、イベント
マイ番号	7	一覧表示、更新、解放、SMS / 音声ルーティング、ドキュメントアップロード
購入	5	国、地域、市区町村、利用可能な番号検索
カート	4	追加、削除、取得、チェックアウト
番号検証	3	単一および一括検証
SIP トランク	5	完全な CRUD
10DLC	30	ブランド、キャンペーン、審査、証拠、イベントサブスクリプション
プロファイル	3	プロファイルの取得 / 更新、アカウント設定
API キー	5	一覧表示、作成、有効化 / 無効化、削除
サブアカウント	5	一覧表示、作成、取得、更新、トランザクション
請求	3	トランザクション、請求書、明細書のダウンロード
音声キャンペーン	2	トリガーと取得
Wavix 埋め込み (WebRTC)	5	ウィジェットトークン CRUD
リンク短縮	2	短縮リンクの作成、メトリクス

完全なツールリストと一行の説明については 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 → 管理 → API キー で（または別のセッションから 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 仕様と照合してください。
サーバーに到達できない	DNS と `mcp.wavix.com:443` へのアウトバウンド HTTPS を確認してください。
エージェントが意図せず破壊的なツールを呼び出す	ほとんどのクライアントではツール呼び出し前に確認を要求する設定が可能です。その設定を有効にし、専用の MCP API キーにローテーションしてください（ベストプラクティスを参照）。

互換性と制限

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

変更履歴

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

サポート

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

コントリビューション

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

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

セキュリティ

セキュリティ脆弱性を報告する場合は、公開の Issue を作成せずに、件名を Security: <short summary> として support@wavix.com までメールでご連絡ください。詳細は SECURITY.md を参照してください。