Wavix

官方

Wavix 是一個全球通訊平台，提供語音、簡訊、雙重驗證和電話號碼的 API。我們的 MCP 伺服器將這些功能帶入 AI 代理與代理工作流程中。

你可以用 Wavix MCP 做什麼？

發送交易簡訊 — 透過 sms_and_mms_messages_send 要求發送帶有自訂文字和寄件者號碼的簡訊。
執行雙重驗證（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 Console → 管理 → API 金鑰 → 建立新的 取得 Wavix API 金鑰。

安裝

兩種連線方式 — 請選擇您的用戶端支援的方式；兩者之間沒有優劣之分。

使用 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 的位置貼上它。

一鍵安裝

⚠️ 下方的按鈕會以佔位符權杖 YOUR_API_KEY 填入您編輯器的 MCP 設定。 編輯器完成安裝後，請開啟產生的設定檔，並在傳送任何請求前將佔位符替換為您的真實 API 金鑰 — 否則每次呼叫都會回傳 401 Unauthorized。

日後移除方式： 開啟相同的設定檔（~/.cursor/mcp.json、.vscode/mcp.json 或您編輯器的對應檔案），刪除 wavix 項目，或透過編輯器的 MCP / 連接器介面移除該連接器。

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 的 bearer 權杖並將其轉發至上游（API 金鑰仍可運作）。設定 `false` 以要求 JWT
`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 中繼資料，將傳入的存取權杖作為 JWT 對簽發者的 JWKS 進行驗證，並以 WWW-Authenticate 挑戰回應未驗證的請求，指向該中繼資料。支援 OAuth 的 MCP 用戶端會利用此機制自行執行授權流程，因此使用者不再需要將 API 金鑰貼入用戶端設定。

每個權杖必須攜帶的對象（audience）是 OAUTH_RESOURCE + MCP_PATH，這同時也是中繼資料中發布的 resource 值。實作 RFC 8707 的授權伺服器會將用戶端的 resource 參數與該字串進行完全比對，因此兩者必須設定為一致 — 包括路徑。

啟用 OAuth 不會切斷使用 Wavix API 金鑰驗證的用戶端。非有效 OAuth JWT 的 bearer 權杖會照舊未經驗證地轉發至上游，由 Wavix API 作為唯一權威 — 因此現有部署可以為新用戶端啟用 OAuth，而不會影響已連線的用戶端。完全未攜帶權杖的請求仍會收到 WWW-Authenticate 挑戰，這正是讓支援 OAuth 的用戶端能探索授權伺服器的機制。只有 OAuth 驗證的連線會進行範圍過濾；API 金鑰連線則可看到完整的工具介面。

設定 OAUTH_API_KEY_PASSTHROUGH=false 可移除該後備機制並要求有效的 JWT — 這是 API 金鑰存取退役後應切換的嚴格模式。

若 OAUTH_ISSUER / OAUTH_RESOURCE 任一未設定，則維持先前行為：不發布中繼資料，用戶端傳送的任何 bearer 權杖皆未經驗證地轉發至上游。

範例

可直接貼入任何已連線用戶端的具體提示詞。

下方的電話號碼（+1 310 555 0100、+44 7700 900123）位於保留的測試範圍內（NANP 555 和 Ofcom 070 09xx）— 可安全地逐字複製，無法透過它們聯絡到真實用戶。

傳送交易型 SMS

提示詞：「從 +13105550100 傳送 SMS 到 +447700900123，內容為『您的驗證碼是 4821』。」

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

執行 2FA 驗證

提示詞：「透過 SMS 傳送 2FA 驗證碼到 +13105550100。當我提供收到的驗證碼時，請檢查是否正確。」

代理程式呼叫 two_fa_verification_create，等待您分享透過 SMS 收到的驗證碼，然後呼叫 two_fa_verification_check。適合在不撰寫整合程式碼的情況下原型設計無密碼流程。

尋找並購買電話號碼

提示詞：「尋找一個具備 SMS 功能的美國免付費電話號碼，加入購物車並結帳。」

代理程式依序呼叫 buy_numbers_list（依國家和功能篩選）、cart_add 和 cart_checkout。cart_checkout 首先回傳包含號碼和費用的預覽，只有在再次以其 confirmation_token 呼叫時才會向帳戶收費。

搜尋通話逐字稿

提示詞：「顯示昨天所有超過兩分鐘的來電，且來電者提到『退款』。」

代理程式使用 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)	Widget 權杖 CRUD
短網址產生器	建立短網址；指標

請參閱 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。

驗證

託管伺服器接受兩種連線方式——兩者無優先之分：

使用 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，請直接擷取該 URL，不要加上 Authorization 標頭。

最佳實務

為 MCP 使用專用 API 金鑰。 在 https://wavix.com → 管理 → API 金鑰（或透過 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
```

若憑證遭到入侵

若您使用 API 金鑰連線：

在 Wavix Console 中，立即停用或刪除該金鑰（或呼叫 api_keys_delete）。
透過 api_keys_create 或 Console 建立替代金鑰。
更新用戶端設定並重新連線。

若您使用 Wavix 帳戶登入連線：

從 Wavix 入口網站的授權管理頁面撤銷連線，該頁面會列出您授權的連線，並可撤銷您選擇的連線——這會使該連線的權杖失效。不涉及任何 API 金鑰。
重新連線並再次登入。

無論哪種情況，請檢閱 billing_transactions_list 和 cdrs_list 是否有異常活動。

疑難排解

症狀	可能原因 / 修正
任何工具傳回 `401 Unauthorized`	驗證失敗。使用 API 金鑰時：`Authorization: Bearer …` 標頭遺失，或金鑰無效或已停用——請在 Wavix Console 中驗證。使用帳戶登入時：您的工作階段 / 權杖已過期或遭撤銷，或登入從未完成——請重新連線並再次登入。
工具傳回 `download_url`，而非檔案本身	符合預期。錄音、語音分析和 10DLC 證明端點會傳回預先簽署的 URL（請參閱驗證）。請直接擷取該 URL，不要加上 `Authorization` 標頭。
用戶端僅顯示部分目錄	較舊的用戶端會強制執行每伺服器工具上限。請升級（Cursor 2.4+、最新版 VS Code、最新版 Claude）。
使用 Wavix 帳戶登入後可用工具較少	符合預期。帳戶登入會依範圍過濾——您只能取得核准範圍和帳戶角色允許的工具，而非完整目錄。API 金鑰連線可看到完整的工具表面。若要擴大範圍，請在登入時核准更多範圍（視您的角色而定），或使用具備這些範圍的 API 金鑰連線。
對本 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 用戶端配接器的代理程式框架。
每個標註 destructiveHint 的工具，加上 call_webhooks_create、sip_trunks_update 和 sub_accounts_update，皆以兩個步驟執行：第一次呼叫會傳回預覽和一次性 confirmation_token（有效期限 5 分鐘），且僅在工具以相同引數和該權杖再次呼叫時才會執行動作。任何 MCP 用戶端皆可執行此操作；無需用戶端支援確認功能。
較舊的用戶端可能強制執行每伺服器工具上限；請升級至最新版本以存取完整目錄。
速率限制和使用費用依您的 Wavix 帳戶方案而定。請參閱 Wavix 定價。

變更日誌

託管伺服器會隨 Wavix OpenAPI 規格的演進持續更新；新工具會自動出現，現有工具引數也可能新增選用欄位。此儲存庫的文件變更會記錄在 Releases 下。若影響工具輸入或驗證的重大行為變更，我們會在該處及 Wavix 版本說明中發布通知。

支援

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

貢獻

此儲存庫為原始碼可用，但不對外部貢獻開放。Pull request 會自動關閉，Issues / Discussions 已停用。請將錯誤回報、功能要求和意見回饋傳送至 support@wavix.com。詳情請參閱 CONTRIBUTING.md。

若您在底層 FastMCP 框架中發現錯誤，請在上游回報。

安全性

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