Wavix

Wavix MCP サーバー

LLM と AI エージェントが Wavix telecom platform に直接アクセスできる Model Context Protocol サーバーです。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 Console → Administration → API keys → Create new から取得できます。

インストール

接続方法は 2 通りあります。クライアントが対応している方を選んでください。どちらか一方に限定する必要はありません。

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

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

API キーで接続

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

1. https://wavix.com にサインインします。
2. Administration → API keys を開きます。
3. Create new をクリックします（または既存のキーをコピーします）。すぐ使えるようにしておいてください。以下の 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 保護リソースとして動作させられます。サーバーは /.well-known/oauth-protected-resource<MCP_PATH> に RFC 9728 メタデータを公開し、受信したアクセストークンを発行者の JWKS に照らして JWT として検証します。また、認証されていないリクエストには、そのメタデータを指す WWW-Authenticate チャレンジを返します。OAuth に対応した MCP クライアントはこれを利用して認可フローを自動的に実行するため、ユーザーがクライアント設定に API キーを貼り付ける必要がなくなります。

各トークンに含める必要がある audience は OAUTH_RESOURCE + MCP_PATH で、メタデータに公開される resource の値でもあります。RFC 8707 を実装する認可サーバーは、クライアントの resource パラメーターをこの文字列と厳密に照合するため、パスも含めて両者を一致させる必要があります。

OAuth を有効にしても、Wavix API キーで認証するクライアントが締め出されることはありません。有効な OAuth JWT ではないベアラートークンは、これまでと同様に検証せず上流へ転送され、引き続き Wavix API のみがその妥当性を判断します。そのため、既存のデプロイで OAuth を有効にして新しいクライアントに対応しても、すでに接続しているクライアントに影響はありません。トークンをまったく含まないリクエストには引き続き WWW-Authenticate チャレンジが返されるため、OAuth 対応クライアントは認可サーバーを検出できます。スコープによるフィルタリングが適用されるのは OAuth 認証済みの接続のみで、API キーによる接続にはすべてのツールが表示されます。

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

OAUTH_ISSUER / OAUTH_RESOURCE のどちらかが未設定の場合は、従来の動作が維持されます。メタデータは公開されず、クライアントが送信するベアラートークンは検証されずに上流へ転送されます。

使用例

接続済みの任意のクライアントに入力して使える、具体的なプロンプトです。

以下の電話番号（+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 認証を実行する

プロンプト：「+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 spec から生成されています。引数はリクエストパラメーターと本文フィールドに対応しています。表示されるツールは、サインイン時に承認した権限と、アカウントで有効になっている機能によって異なります。

グループ	対応範囲
SMS and MMS	メッセージの送信、一覧表示、取得、送信者 ID、オプトアウト
WhatsApp	ビジネスアカウント、送信者、テンプレート、メッセージの送信／一覧表示／取得
Call control	通話の開始／応答／終了、音声の再生、DTMF の収集
Call recording	一覧表示、ダウンロード（署名付き URL）、削除
Call streaming	メディアストリームの開始／停止
Call webhooks	一覧表示、作成、削除
CDRs	一覧表示、取得、文字起こしの検索と再文字起こし
Speech Analytics	文字起こし、元ファイルの取得
2FA	認証の作成／確認／キャンセル／再送、イベント
My numbers	一覧表示、更新、解放、SMS／音声ルーティング
Buy	国、地域、都市、利用可能な番号の検索
Cart	追加、削除、取得、購入手続き
Number validator	単一および一括の検証
SIP trunks	完全な CRUD
10DLC	ブランド、キャンペーン、審査、証拠、イベントサブスクリプション
Profile	プロフィールの取得／更新、アカウント設定
API Keys	一覧表示、作成、更新、削除
Sub-accounts	一覧表示、作成、取得、更新、取引
Billing	取引、請求書／明細書の一覧表示
Voice campaigns	実行と取得
Wavix Embeddable (WebRTC)	ウィジェットトークンの CRUD
Link shortener	短縮リンクの作成、メトリクス

1 行の説明付きのツール一覧は、TOOLS.md をご覧ください。正式な情報源は Wavix OpenAPI spec です。クライアントには常に最新のツールカタログが表示されます。

リソース

ツールに加えて、サーバーは Wavix のドキュメントを MCP リソースとして公開するため、モデルは過去の知識から推測する代わりに、必要に応じて信頼できる情報を取得できます。

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

両方の情報源である docs.wavix.com と Wavix OpenAPI spec は一般公開されており、認証なしで直接閲覧できます。

リソースは resources/read の実行時に遅延取得され、サーバー側で TTL 1 時間のキャッシュに保存されます。上流の 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 → Administration → API keys で個別の API キーを作成してください（または、別のセッションから api_keys_create ツールを使用します）。これにより、他の連携に影響を与えずに 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 キーで接続した場合：

1. Wavix Console で、そのキーを直ちに無効化または削除してください（または api_keys_delete を呼び出してください）。
2. api_keys_create または Console から、代わりのキーを作成してください。
3. クライアントの設定を更新し、再接続してください。

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

1. Wavix ポータルの許可管理ページで接続を取り消してください。このページには、承認した接続が一覧表示され、選択した接続を取り消せます。これにより、その接続のトークンが無効になります。API キーは使用されていません。
2. 再接続し、もう一度サインインしてください。

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

トラブルシューティング

症状	考えられる原因／対処法
どのツールからも 401 Unauthorized が返される	認証に失敗しています。API キーを使用している場合は、Authorization: Bearer … ヘッダーがないか、キーが無効または使用停止になっています。Wavix Console で確認してください。アカウントでサインインしている場合は、セッション／トークンの有効期限が切れたか、取り消されたか、サインインが完了していません。再接続して、もう一度サインインしてください。
ツールがファイル本体ではなく 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 仕様と照合してください。
サーバーに接続できない	DNS と、mcp.wavix.com:443 へのアウトバウンド 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 段階で実行されます。最初の呼び出しではプレビューと、1 回限りの confirmation_token（有効期間 5 分）が返されます。同じ引数とそのトークンを指定してツールを再度呼び出した場合にのみ、操作が実行されます。どの MCP クライアントでも利用でき、クライアント側で確認機能をサポートする必要はありません。
• 古いクライアントでは、サーバーごとのツール数に上限が設けられている場合があります。カタログ全体にアクセスするには、最新バージョンにアップグレードしてください。
• レート制限と利用料金は、Wavix アカウントのプランに従います。Wavix の料金を参照してください。

変更履歴

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

サポート

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

コントリビューション

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

基盤となる FastMCP フレームワークにバグを見つけた場合は、そちらのリポジトリで報告してください。

セキュリティ

セキュリティ脆弱性を報告する場合は、公開 Issue を作成せず、件名を Security: <short summary> として [email protected] にメールしてください。詳細は SECURITY.md を参照してください。

ライセンス

MIT © Wavix