Wavix

Wavix MCP Server

一個 Model Context Protocol 伺服器，讓 LLM 與 AI 代理程式可直接存取 Wavix 電信平台 — 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 Console 取得 Wavix API 金鑰 → Administration → API keys → Create new。

安裝

開始之前： 請先取得您的 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 / Connectors 介面移除連線。

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

Settings → Connectors → Add custom connector：

• Name：Wavix
• URL：https://mcp.wavix.com/mcp
• Transport：Streamable HTTP
• Authentication header：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 指南 取得最新的結構描述。

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 傳輸並可自訂標頭（custom headers）的 MCP 用戶端皆可使用。請使用：

• URL：https://mcp.wavix.com/mcp
• Header：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

提示詞：「Send an SMS from +13105550100 to +447700900123 saying 'Your verification code is 4821'.」

代理程式會以 from、to 與 text 呼叫 sms_and_mms_messages_send。回傳訊息 ID 與傳遞狀態。

執行 2FA 驗證

提示詞：「Send a 2FA verification code to +13105550100 via SMS. When I give you the code I receive, check whether it's correct.」

代理程式會呼叫 two_fa_verification_create，等待您分享透過 SMS 收到的驗證碼，然後呼叫 two_fa_verification_check。適用於在不編寫整合程式碼的情況下快速建立無密碼流程原型。

尋找並購買電話號碼

提示詞：「Find an available US toll-free number with SMS capability, add it to my cart, and check out.」

代理程式會依序呼叫 buy_numbers_list（依國家與功能篩選）、cart_add 與 cart_checkout。結帳前請先與使用者確認 — 此操作會從帳戶扣款。

搜尋通話逐字稿

提示詞：「Show me all inbound calls from yesterday longer than two minutes where the caller mentioned 'refund'.」

代理程式使用 cdrs_search 搜尋轉錄內容，然後透過 cdrs_get 豐富每一筆結果，取得完整的通話中繼資料。

擷取錄音並轉錄

提示詞：「Get the recording for call abc-123, ask Wavix to transcribe it, and return the transcription.」

代理程式呼叫 call_recording_get（回傳預先簽署的下載 URL）、cdrs_retranscribe，然後輪詢 cdrs_transcription_get。

稽核帳單

提示詞：「How much did we spend on SMS last month? Give me a download link for the most recent invoice PDF.」

代理程式呼叫依類型與日期篩選的 billing_transactions_list，然後呼叫 billing_invoices_list + billing_invoices_download。下載工具回傳的是 PDF 的預先簽署 URL，而非檔案本身 — 請在瀏覽器中開啟該 URL，或將其交給您的用戶端來擷取實際文件。

工具

122 個工具，從 Wavix OpenAPI 規格 自動產生。參數對應請求參數與請求內文欄位。

群組	數量	涵蓋範圍
SMS 與 MMS	10	傳送、列出、擷取訊息；寄件者 ID；退出（opt-out）
通話控制	9	開始 / 接聽 / 結束通話；播放音訊；收集 DTMF
通話錄音	4	列出、下載（預先簽署 URL）、刪除
通話串流	2	開始 / 停止媒體串流
通話 Webhooks	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	Widget 金鑰 CRUD
短網址	2	建立短連結；指標

請參閱 TOOLS.md 取得完整工具清單及一行說明。權威來源是 Wavix OpenAPI 規格 — 您的用戶端隨時可看到目前最新的即時目錄。

資源

除了工具之外，伺服器也以 MCP 資源的形式公開 Wavix 文件，讓模型可依需求取得權威內容，而非依賴先前的知識猜測。

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 金鑰儲存在環境變數或作業系統鑰匙圈中，並在設定檔中引用。作為安全網，請將常見的用戶端設定路徑加入專案的 .gitignore：

  .cursor/mcp.json
  .vscode/mcp.json
  claude_desktop_config.json
  .claude/mcp.json
  .codex/config.toml
  

若金鑰遭洩漏

1. 在 Wavix 主控台中，立即停用該金鑰（或呼叫 api_keys_deactivate）。
2. 透過 api_keys_create 或主控台建立替代金鑰。
3. 更新用戶端的設定並重新連線。
4. 檢查 billing_transactions_list 和 cdrs_list 是否有異常活動。

疑難排解

症狀	可能原因 / 修正
任何工具都回傳 401 Unauthorized	缺少或無效的 Authorization: Bearer … 標頭。請確認 API 金鑰在 Wavix 主控台中為啟用狀態。
工具回傳 download_url，而非檔案本身	這是預期的行為。錄音、發票、語音分析和 10DLC 證據端點會回傳預先簽署的 URL（請參閱 驗證）。直接擷取該 URL，不要帶 Authorization 標頭。
用戶端只顯示約 40 個工具，而非完整目錄	較舊的用戶端會強制每個伺服器的工具數量上限。請升級（Cursor 2.4+、最新版 VS Code、最新版 Claude）。
本 README 中列出的工具出現 Tool not found	本機用戶端可能快取了舊的工具清單。請重新啟動用戶端，或移除並重新加入伺服器。
4xx 帶有 errors 陣列	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 規格的演進而持續更新；新工具會自動出現，既有工具參數也可能新增選用欄位。本儲存庫的文件變更會記錄在 版本發布 中。對於影響工具輸入或驗證的重大行為變更，我們會同時在該處和 Wavix 版本說明 發布通知。

支援

• 產品文件：https://docs.wavix.com
• API 參考：https://docs.wavix.com/api-reference
• 問題 / 意見回饋：support@wavix.com

貢獻

本儲存庫為原始碼可用，但不對外開放貢獻。拉取請求會自動關閉，問題與討論已停用。請將錯誤回報、功能需求與意見回饋寄送至 support@wavix.com。詳情請參閱 CONTRIBUTING.md。

如果您在底層 FastMCP 框架中發現錯誤，請直接向上游回報。

安全性

若要回報安全性漏洞，請寄送電子郵件至 support@wavix.com，主旨為 Security: <short summary>，而非開啟公開議題。詳情請參閱 SECURITY.md。

授權

MIT © Wavix