Wavix

公式

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

Wavix MCPで何ができますか？

トランザクションSMSの送信 — sms_and_mms_messages_send を使用して、カスタムテキストと送信者番号でSMSの送信を依頼します。
2FA認証の実行 — two_fa_verification_create と two_fa_verification_check を使用して、パスワードレスログインフローの認証コードを作成および確認します。
番号の検索と購入 — 国や機能で利用可能な番号を検索し、カートに追加して、buy_numbers_list、cart_add、cart_checkout で確認してチェックアウトします。
通話文字起こしの検索 — 通話時間と文字起こし内のキーワードで通話を検索し、cdrs_search と cdrs_get で完全なメタデータを補完します。
通話録音の文字起こし — 通話録音を取得し、文字起こしをリクエストし、call_recording_get_by_call、cdrs_retranscribe、cdrs_transcription_get で結果をポーリングします。
請求の監査 — billing_transactions_list と billing_invoices_list を使用して、タイプと日付でフィルタリングした取引と請求書を一覧表示します。

ドキュメント

Wavix MCP サーバー

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

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

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

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

エンドポイント

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

Wavix API キーは、Wavix コンソール → 管理 → API キー → 新規作成 から取得できます。

インストール

接続方法は2つあります — お使いのクライアントが対応している方を選択してください。どちらかが他方より優先されるわけではありません。

Wavix アカウントでサインイン

MCP クライアントが OAuth に対応している場合（Claude Desktop / Web、その他の OAuth 対応クライアント）、API キーなしで接続できます：https://mcp.wavix.com/mcp のコネクタを追加し、クライアントがプロンプトを表示したら Wavix アカウントでサインインしてアクセスを承認します。クライアントが OAuth 2.1 フローを実行し、トークンを自身で保存します — 貼り付けるものはありません。利用できるツールは、承認した内容とアカウントの役割で許可された範囲に制限されます（トラブルシューティングを参照）。

API キーで接続

開始する前に： Wavix API キーを取得してください。

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

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

⚠️ 下記のボタンは、エディタの MCP 設定にプレースホルダートークン YOUR_API_KEY をシードします。 エディタのインストール完了後、生成された設定を開き、リクエストを送信する前にプレースホルダーを実際の 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>

サインインして接続するには、認証ヘッダーなしでコネクタを追加し、クライアントがプロンプトを表示したら Wavix アカウントでサインインします。

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 エンドポイントを上書きします（内部デプロイやステージング用）
`OAUTH_ISSUER`	未設定	OAuth 2.1 認証サーバーのベース URL。その JWKS は `<issuer>/.well-known/jwks.json` から読み取られます
`OAUTH_RESOURCE`	未設定	このサーバーが到達される公開ベース URL。リソース識別子として使用されます
`OAUTH_API_KEY_PASSTHROUGH`	`true`	OAuth を有効にした状態で、OAuth JWT ではないベアラーも受け入れ、アップストリームに転送します（API キーは引き続き機能します）。JWT を必須にするには `false` を設定します
`MCP_PATH`	`/mcp`	MCP エンドポイントが提供されるパス

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

OAuth 2.1（オプション）

OAUTH_ISSUER と OAUTH_RESOURCE を一緒に設定して、サーバーを OAuth 2.1 で保護されたリソースにします。これにより、RFC 9728 メタデータを /.well-known/oauth-protected-resource<MCP_PATH> で公開し、受信したアクセストークンを発行者の JWKS に対して JWT として検証し、認証されていないリクエストにはそのメタデータを指す WWW-Authenticate チャレンジで応答します。OAuth をサポートする MCP クライアントは、これを使用して認証フローを自身で実行するため、ユーザーはクライアント設定に API キーを貼り付ける必要がなくなります。

各トークンが保持する必要があるオーディエンスは OAUTH_RESOURCE + MCP_PATH で、これはメタデータで公開される resource 値でもあります。RFC 8707 を実装する認証サーバーは、クライアントの resource パラメータをその文字列と正確に比較するため、パスを含めて両者が一致するように設定する必要があります。

OAuth を有効にしても、Wavix API キーで認証するクライアントは遮断されません。有効な OAuth JWT ではないベアラートークンは、以前と同様に検証なしでアップストリームに転送され、Wavix API がその唯一の権威となります — そのため、既存のデプロイは、接続済みのクライアントを壊すことなく、新しいクライアント向けに OAuth を有効にできます。トークンをまったく持たないリクエストでも WWW-Authenticate チャレンジが返され、これにより OAuth 対応クライアントが認証サーバーを発見できます。OAuth 認証された接続のみがスコープフィルタリングされます。API キー接続では完全なツールサーフェスが表示されます。

OAUTH_API_KEY_PASSTHROUGH=false を設定すると、そのフォールバックを廃止して有効な JWT を必須にできます — API キーアクセスを廃止した後に切り替えるべき厳格モードです。

OAUTH_ISSUER / OAUTH_RESOURCE のいずれかを未設定のままにすると、以前の動作が維持されます：メタデータは公開されず、クライアントが送信するベアラートークンは検証なしでアップストリームに転送されます。

例

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

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

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

プロンプト： 「+13105550100 から +447700900123 に『あなたの認証コードは 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 を連鎖させます。cart_checkout は最初に番号と手数料を含むプレビューを返し、その confirmation_token とともに再度呼び出された場合にのみアカウントに請求します。

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

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

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

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

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

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

請求を監査する

プロンプト： 「先月の SMS にいくら費やしましたか、またどの請求書が発行されましたか？」

エージェントはタイプと日付でフィルタリングした billing_transactions_list を呼び出し、次に billing_invoices_list を呼び出します。請求書 PDF 自体のダウンロードは MCP 経由では公開されていません — Wavix API またはダッシュボードから取得してください。

ツール

Wavix OpenAPI 仕様から生成されています。引数はリクエストパラメータとボディフィールドを反映しています。表示されるツールは、サインイン時に承認した権限とアカウントで有効な機能によって異なります。

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

完全なツール一覧と各ツールの 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 にのみ送信されます。

認証

ホスト型サーバーは 2 つの接続方法を受け付けます。どちらが優先されるわけでもありません。

Wavix アカウントでサインイン（OAuth 2.1）。 OAuth 対応クライアント向け。クライアントが認可フローを実行し、ユーザーがサインインします。API キーは保存されません。アクセスは、ユーザーが承認し、アカウントの役割が許可するスコープに制限されます。Wavix アカウントでサインインを参照してください。
Wavix API キー（Bearer）。 Streamable-HTTP 対応クライアント向け。すべてのリクエストに次のものを含める必要があります。

Authorization: Bearer <api_key>

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

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

クライアントが call_recording_get_by_call、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
```

認証情報が漏洩した場合

API キーで接続していた場合：

Wavix コンソールで、そのキーをすぐに無効化または削除します（または api_keys_delete を呼び出します）。
api_keys_create またはコンソールを使用して置き換えを作成します。
クライアントの設定を更新して再接続します。

Wavix アカウントでサインインして接続していた場合：

Wavix ポータルの許可管理ページから接続を失効させます。このページには、承認した接続が一覧表示され、選択した接続を失効させることができます。これにより、その接続のトークンが無効になります。API キーは関与しません。
再接続して再度サインインします。

いずれの場合も、billing_transactions_list と cdrs_list を確認して、予期しないアクティビティがないか確認してください。

トラブルシューティング

症状	考えられる原因 / 修正
任意のツールからの `401 Unauthorized`	認証に失敗しました。API キーの場合：`Authorization: Bearer …` ヘッダーがないか、キーが無効または非アクティブです。Wavix コンソールで確認してください。アカウントサインインの場合：セッション / トークンが期限切れまたは失効したか、サインインが完了していません。再接続して再度サインインしてください。
ツールが `download_url` を返し、ファイル自体を返さない	想定どおりです。録音、音声分析、10DLC 証拠エンドポイントは事前署名付き URL を返します（認証を参照）。`Authorization` ヘッダーなしで URL を直接取得してください。
クライアントにカタログの一部しか表示されない	古いクライアントはサーバーごとのツール上限を強制します。アップグレードしてください（Cursor 2.4+、最新の VS Code、最新の Claude）。
Wavix アカウントでサインインした後、利用可能なツールが少ない	想定どおりです。アカウントサインインはスコープフィルタリングされます。承認されたスコープとアカウントの役割で許可されたツールのみが表示され、完全なカタログではありません。API キー接続では完全なツールサーフェスが表示されます。範囲を広げるには、サインイン時に（役割に応じて）より多くのスコープを承認するか、それらを含む API キーで接続してください。
この 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 クライアントアダプターを備えた任意のエージェントフレームワークと互換性があります。
destructiveHint で注釈が付けられたすべてのツール、および call_webhooks_create、sip_trunks_update、sub_accounts_update は、2 段階で実行されます。最初の呼び出しでプレビューと使い捨ての confirmation_token（5 分間有効）が返され、アクションは同じ引数とそのトークンでツールが再度呼び出された場合にのみ実行されます。任意の MCP クライアントでこれを行うことができます。クライアント側の確認サポートは必要ありません。
古いクライアントはサーバーごとのツール上限を強制する場合があります。完全なカタログにアクセスするには、最近のバージョンにアップグレードしてください。
レート制限と使用料金は、Wavix アカウントプランに従います。Wavix 料金を参照してください。

変更履歴

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

サポート

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

貢献

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

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

セキュリティ

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