Wavix

chính thức

Wavix là nền tảng truyền thông toàn cầu cung cấp các API cho thoại, SMS, xác thực hai yếu tố và số điện thoại. Máy chủ MCP của chúng tôi mang những khả năng này đến với các tác nhân AI và quy trình làm việc tự động.

GitHub

Dùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với Wavix MCP?

Gửi SMS/MMS giao dịch — Yêu cầu gửi tin nhắn qua sms_and_mms_messages_send, trả về ID tin nhắn và trạng thái giao hàng.
Chạy quy trình xác minh 2FA — Tạo mã bằng two_fa_verification_create, sau đó xác thực qua two_fa_verification_check.
Tìm kiếm và mua số điện thoại — Tìm số khả dụng bằng buy_numbers_list, thêm vào giỏ hàng qua cart_add, và hoàn tất mua hàng bằng cart_checkout.
Tìm kiếm bản ghi cuộc gọi — Sử dụng cdrs_search để tìm cuộc gọi theo từ khóa phiên âm, sau đó làm phong phú kết quả bằng cdrs_get.
Tải và phiên âm bản ghi — Lấy bản ghi qua call_recording_get, yêu cầu phiên âm bằng cdrs_retranscribe, và tải kết quả qua cdrs_transcription_get.
Kiểm tra thanh toán và hóa đơn — Xem chi tiêu bằng billing_transactions_list và tải PDF hóa đơn qua billing_invoices_download.

Tài liệu

Máy chủ MCP Wavix

Một máy chủ Model Context Protocol cung cấp cho LLM và các tác nhân AI quyền truy cập trực tiếp vào nền tảng viễn thông Wavix — SMS/MMS, cuộc gọi thoại, 2FA, SIP trunking, quản lý số điện thoại, đăng ký 10DLC, ghi âm cuộc gọi, phân tích giọng nói và thanh toán.

Wavix là nền tảng truyền thông toàn cầu để gửi SMS, thực hiện cuộc gọi thoại và chạy các quy trình 2FA thông qua một API duy nhất. Có dùng thử miễn phí; việc sử dụng trả phí tuân theo gói giá Wavix gắn với tài khoản của bạn.

Cách nhanh nhất để sử dụng máy chủ MCP này là điểm cuối được lưu trữ tại https://mcp.wavix.com/mcp — trỏ bất kỳ máy khách tương thích MCP nào vào đó và xác thực bằng khóa API Wavix của bạn. Nếu bạn cần tự lưu trữ (triển khai Wavix tùy chỉnh, sau tường lửa, phiên bản chuyên dụng), hãy xem Tự chạy.

Mục lục

Điểm cuối
Cài đặt — một cú nhấp chuột, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
Tự chạy (tự lưu trữ)
Ví dụ
Công cụ → danh mục đầy đủ trong TOOLS.md
Tài nguyên
Xác thực (các phương pháp hay nhất, nếu mã thông báo bị xâm phạm)
Xử lý sự cố
Tương thích & giới hạn
Hỗ trợ, Đóng góp, Bảo mật, Giấy phép

Điểm cuối

Trường	Giá trị
URL	`https://mcp.wavix.com/mcp`
Giao thức truyền tải	Streamable HTTP
Xác thực	`Authorization: Bearer <api_key>`
Công cụ	xem TOOLS.md
Tài nguyên	Tài liệu Wavix + đặc tả OpenAPI (tự động phát hiện)

Lấy khóa API Wavix từ Wavix Console → Administration → API keys → Create new.

Cài đặt

Trước khi bắt đầu: lấy khóa API Wavix của bạn.

Đăng nhập tại https://wavix.com.
Mở Administration → API keys.
Nhấp Create new (hoặc sao chép khóa hiện có). Giữ nó ở nơi dễ lấy — bạn sẽ dán nó vào vị trí của YOUR_API_KEY bên dưới.

Cài đặt một cú nhấp chuột

⚠️ Các nút bên dưới khởi tạo cấu hình MCP của trình soạn thảo bằng mã thông báo giữ chỗ YOUR_API_KEY. Sau khi trình soạn thảo hoàn tất cài đặt, hãy mở cấu hình được tạo và thay thế mã giữ chỗ bằng khóa API thật của bạn trước khi gửi bất kỳ yêu cầu nào — nếu không, mọi lệnh gọi sẽ trả về 401 Unauthorized.

Để gỡ cài đặt sau này: mở cùng tệp cấu hình đó (~/.cursor/mcp.json, .vscode/mcp.json, hoặc tệp tương đương cho trình soạn thảo của bạn) và xóa mục wavix, hoặc gỡ trình kết nối qua giao diện MCP / Connectors của trình soạn thảo.

Claude Code

claude mcp add --transport http wavix https://mcp.wavix.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Dùng claude mcp list để xác minh và /mcp trong phiên để kiểm tra trạng thái.

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 (thủ công)

Thêm vào ~/.cursor/mcp.json (hoặc .cursor/mcp.json ở cấp dự án):

{
  "mcpServers": {
    "wavix": {
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Cursor 2.4+ hiển thị danh mục đầy đủ; các phiên bản trước đó giới hạn ở 40.

VS Code (thủ công, GitHub Copilot Chat)

Tạo .vscode/mcp.json trong không gian làm việc của bạn (hoặc thêm cùng đối tượng servers dưới khóa "mcp" trong settings.json của người dùng):

{
  "servers": {
    "wavix": {
      "type": "http",
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Xem hướng dẫn máy chủ MCP của VS Code để biết lược đồ mới nhất.

Codex CLI

Codex CLI hỗ trợ MCP qua stdio. Cầu nối đến máy chủ được lưu trữ qua mcp-remote. Chỉnh sửa ~/.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 / các máy khách khác

Bất kỳ máy khách MCP nào hỗ trợ giao thức truyền tải Streamable HTTP với các tiêu đề tùy chỉnh đều hoạt động được. Sử dụng:

URL: https://mcp.wavix.com/mcp
Header: Authorization: Bearer <api_key>

Đang thiết lập qua tác nhân AI? Trỏ tác nhân của bạn đến llms-install.md — đây là hướng dẫn cài đặt có thể đọc bằng máy, cung cấp cho mô hình URL, tiêu đề và cấu hình cho từng máy khách ở định dạng xác định để mô hình không tự ứng biến các giá trị điểm cuối.

Tự chạy

Máy chủ được lưu trữ hoạt động ngay cho hầu hết người dùng. Tự lưu trữ nếu bạn cần trỏ đến một triển khai Wavix không công khai, chạy sau tường lửa hoặc vận hành trong cơ sở hạ tầng của riêng bạn.

Docker

docker build -t wavix-mcp-server .
docker run --rm -p 8000:8000 wavix-mcp-server

Máy chủ lắng nghe trên cổng 8000 và hiển thị điểm cuối MCP tại /mcp. Trỏ máy khách của bạn đến http://<host>:8000/mcp.

Từ mã nguồn

git clone https://github.com/Wavix/wavix-mcp-server.git
cd wavix-mcp-server
pip install -e .
wavix-mcp

Yêu cầu Python 3.10+.

Cấu hình

Biến môi trường	Mặc định	Mục đích
`WAVIX_API_BASE_URL`	`https://api.wavix.com`	Ghi đè điểm cuối API Wavix gốc (cho triển khai nội bộ hoặc staging)

Không cần thông tin xác thực Wavix để chạy máy chủ — chúng được chuyển tiếp theo từng yêu cầu từ tiêu đề Authorization: Bearer <api_key> của máy khách MCP. Người tự lưu trữ chịu trách nhiệm kết thúc TLS phía trước máy chủ (nginx, Caddy, bộ cân bằng tải đám mây) trước khi phơi bày công khai.

Ví dụ

Các lời nhắc cụ thể bạn có thể dán vào bất kỳ máy khách đã kết nối nào.

Các số điện thoại bên dưới (+1 310 555 0100, +44 7700 900123) nằm trong dải số thử nghiệm dành riêng (NANP 555 và Ofcom 070 09xx) — an toàn để sao chép nguyên văn, không có thuê bao thật nào có thể liên hệ qua chúng.

Gửi SMS giao dịch

Lời nhắc: "Gửi SMS từ +13105550100 đến +447700900123 có nội dung 'Mã xác minh của bạn là 4821'."

Tác nhân gọi sms_and_mms_messages_send với from, to và text. Trả về ID tin nhắn và trạng thái giao hàng.

Chạy xác minh 2FA

Lời nhắc: "Gửi mã xác minh 2FA đến +13105550100 qua SMS. Khi tôi đưa cho bạn mã tôi nhận được, hãy kiểm tra xem nó có đúng không."

Tác nhân gọi two_fa_verification_create, chờ bạn chia sẻ mã đến qua SMS, sau đó gọi two_fa_verification_check. Hữu ích để tạo nguyên mẫu luồng không mật khẩu mà không cần viết mã tích hợp.

Tìm và mua số điện thoại

Lời nhắc: "Tìm số miễn phí của Hoa Kỳ còn trống có khả năng SMS, thêm vào giỏ hàng của tôi và thanh toán."

Tác nhân kết nối buy_numbers_list (lọc theo quốc gia và tính năng), cart_add và cart_checkout. Xác nhận với người dùng trước khi thanh toán — nó sẽ trừ tiền từ tài khoản.

Tìm kiếm bảng điểm cuộc gọi

Lời nhắc: "Hiển thị tất cả cuộc gọi đến từ hôm qua dài hơn hai phút mà người gọi nhắc đến 'hoàn tiền'."

Tác nhân dùng cdrs_search trên các bản chép lời, sau đó làm phong phú từng kết quả qua cdrs_get để có đầy đủ siêu dữ liệu cuộc gọi.

Tải bản ghi và chép lời

Lời nhắc: "Lấy bản ghi cho cuộc gọi abc-123, yêu cầu Wavix chép lời và trả về văn bản chép lời."

Tác nhân gọi call_recording_get (trả về URL tải xuống đã ký trước), cdrs_retranscribe, sau đó thăm dò cdrs_transcription_get.

Kiểm toán thanh toán

Lời nhắc: "Chúng ta đã chi bao nhiêu cho SMS tháng trước? Cho tôi liên kết tải xuống hóa đơn PDF gần nhất."

Tác nhân gọi billing_transactions_list được lọc theo loại và ngày, sau đó billing_invoices_list + billing_invoices_download. Công cụ tải xuống trả về URL đã ký trước đến PDF, không phải tệp — mở URL trong trình duyệt hoặc chuyển cho máy khách của bạn để tải tài liệu thực tế.

Công cụ

122 công cụ, được tạo từ đặc tả OpenAPI Wavix. Các tham số phản ánh tham số yêu cầu và trường thân yêu cầu.

Nhóm	Số lượng	Phạm vi
SMS và MMS	10	Gửi, liệt kê, truy xuất tin nhắn; mã người gửi; từ chối nhận
Điều khiển cuộc gọi	9	Bắt đầu / trả lời / kết thúc cuộc gọi; phát âm thanh; thu thập DTMF
Ghi âm cuộc gọi	4	Liệt kê, tải xuống (URL đã ký trước), xóa
Phát trực tuyến cuộc gọi	2	Bắt đầu / dừng luồng phương tiện
Webhook cuộc gọi	3	Liệt kê, tạo, xóa
CDR	7	Liệt kê, xuất, truy xuất; tìm kiếm bản chép lời và chép lại
Speech Analytics	4	Tải lên, chép lời, truy xuất tệp gốc
2FA	6	Tạo / kiểm tra / hủy / gửi lại xác minh; sự kiện
Số của tôi	6	Liệt kê, cập nhật, giải phóng; định tuyến SMS / thoại; tải lên tài liệu
Mua	5	Quốc gia, vùng, thành phố; tìm kiếm số khả dụng
Giỏ hàng	4	Thêm, xóa, truy xuất, thanh toán
Trình xác thực số	3	Xác thực từng số và hàng loạt
SIP trunks	5	CRUD đầy đủ
10DLC	30	Thương hiệu, chiến dịch, thẩm định, bằng chứng, đăng ký sự kiện
Hồ sơ	3	Lấy / cập nhật hồ sơ; cấu hình tài khoản
API Keys	4	Liệt kê, tạo, kích hoạt / hủy kích hoạt, xóa
Tài khoản con	5	Liệt kê, tạo, lấy, cập nhật; giao dịch
Thanh toán	3	Giao dịch, hóa đơn, tải xuống sao kê
Chiến dịch thoại	2	Kích hoạt và truy xuất
Wavix Embeddable (WebRTC)	5	CRUD mã thông báo widget
Rút gọn liên kết	2	Tạo liên kết ngắn; số liệu

Xem TOOLS.md để biết danh sách công cụ đầy đủ với mô tả một dòng. Nguồn có thẩm quyền là đặc tả OpenAPI Wavix — máy khách của bạn luôn thấy danh mục trực tiếp hiện tại.

Tài nguyên

Ngoài các công cụ, máy chủ còn hiển thị tài liệu Wavix dưới dạng Tài nguyên MCP, để mô hình có thể lấy ngữ cảnh có thẩm quyền theo yêu cầu thay vì đoán từ kiến thức trước đó.

Lược đồ URI	Nội dung
`wavix://docs/<path>`	Các trang tài liệu từ docs.wavix.com (tự động phát hiện qua `llms.txt`).
`wavix://api/openapi.yaml`	Đặc tả OpenAPI 3.0 đầy đủ của Wavix.

Cả hai nguồn — docs.wavix.com và đặc tả OpenAPI Wavix — đều được công khai và có thể duyệt trực tiếp mà không cần xác thực.

Tài nguyên được tải một cách lười biếng trên resources/read và được lưu vào bộ nhớ đệm phía máy chủ với TTL 1 giờ. Mã thông báo Bearer từ nguồn không bao giờ được chuyển tiếp đến các máy chủ tài liệu — chỉ đến api.wavix.com.

Xác thực

Mọi yêu cầu từ máy khách phải bao gồm:

Authorization: Bearer <api_key>

Máy chủ chuyển tiếp tiêu đề này đến api.wavix.com theo từng yêu cầu. Mã thông báo:

không bao giờ được ghi nhật ký,
không bao giờ được chuyển tiếp trên các chuyển hướng máy chủ chéo (ví dụ: URL tải xuống S3 đã ký trước),
không bao giờ được gửi đến các máy chủ tài liệu.

Nếu máy khách của bạn theo URL tải xuống đã ký trước do call_recording_get, billing_invoices_download, speech_analytics_file_get hoặc ten_dlc_brand_evidence_get trả về, hãy tải trực tiếp mà không có tiêu đề Authorization.

Các phương pháp hay nhất

Dùng khóa API chuyên dụng cho MCP. Tạo khóa API riêng tại https://wavix.com → Administration → API keys (hoặc qua chính công cụ api_keys_create, từ phiên khác). Điều này cho phép bạn thu hồi quyền truy cập MCP mà không làm gián đoạn các tích hợp khác.
Xoay vòng định kỳ. Xem khóa API như bất kỳ bí mật sản xuất nào: xoay vòng theo lịch trình và khi có nghi ngờ rò rỉ.
Giữ khóa API ngoài git. Cấu hình máy khách MCP rất dễ bị commit nhầm, đưa mã thông báo vào lịch sử và nhật ký CI. Hầu hết các máy khách hỗ trợ thay thế ${env:VAR} trong giá trị tiêu đề — lưu khóa API trong biến môi trường hoặc chuỗi khóa hệ điều hành và tham chiếu từ cấu hình. Để làm lưới an toàn, hãy thêm các đường dẫn cấu hình máy khách phổ biến vào .gitignore của dự án bạn:
```
.cursor/mcp.json
.vscode/mcp.json
claude_desktop_config.json
.claude/mcp.json
.codex/config.toml
```

Nếu mã thông báo bị xâm phạm

Trong Wavix Console, hãy vô hiệu hóa khóa ngay lập tức (hoặc gọi api_keys_deactivate).
Tạo khóa thay thế qua api_keys_create hoặc Console.
Cập nhật cấu hình của client và kết nối lại.
Rà soát billing_transactions_list và cdrs_list để phát hiện hoạt động bất thường.

Khắc phục sự cố

Triệu chứng	Nguyên nhân / cách khắc phục có thể
`401 Unauthorized` từ bất kỳ công cụ nào	Thiếu hoặc sai header `Authorization: Bearer …`. Xác minh API key đang hoạt động trong Wavix Console.
Công cụ trả về `download_url`, không phải tệp tin	Điều này là bình thường. Các endpoint ghi âm, hóa đơn, phân tích giọng nói và bằng chứng 10DLC trả về URL đã ký sẵn (xem Authentication). Truy xuất URL trực tiếp mà không cần header `Authorization`.
Client chỉ hiển thị ~40 công cụ, không phải toàn bộ danh mục	Client cũ giới hạn số công cụ trên mỗi server. Hãy nâng cấp (Cursor 2.4+, VS Code mới nhất, Claude mới nhất).
`Tool not found` cho một công cụ được liệt kê trong README này	Client cục bộ có thể đang lưu danh sách công cụ cũ. Khởi động lại client, hoặc gỡ và thêm lại server.
4xx kèm mảng `errors`	Lỗi xác thực từ Wavix API. Kiểm tra `errors`; đối chiếu với trang `wavix://docs/*` liên quan hoặc thông số OpenAPI.
Không kết nối được server	Xác nhận DNS và HTTPS đi ra tới `mcp.wavix.com:443`.
Agent gọi công cụ phá hoại một cách bất ngờ	Hầu hết client có thể yêu cầu xác nhận trước khi gọi công cụ — hãy bật tùy chọn đó và xoay vòng sang một API key MCP chuyên dụng (xem Best practices).

Khả năng tương thích và giới hạn

Tương thích với bất kỳ client MCP nào hỗ trợ giao thức Streamable HTTP (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, MCP SDK tùy chỉnh) và bất kỳ framework agent nào có adapter client MCP.
Client cũ có thể giới hạn số công cụ trên mỗi server; hãy nâng cấp lên phiên bản mới để truy cập toàn bộ danh mục.
Giới hạn tốc độ và phí sử dụng tuân theo gói tài khoản Wavix của bạn. Xem Wavix pricing.

Nhật ký thay đổi

Server được lưu trữ được cập nhật liên tục khi thông số OpenAPI của Wavix phát triển; các công cụ mới xuất hiện tự động và các tham số của công cụ hiện có có thể được bổ sung các trường tùy chọn. Các thay đổi tài liệu cho kho lưu trữ này được theo dõi tại Releases. Đối với các thay đổi hành vi đáng kể ảnh hưởng đến đầu vào hoặc xác thực của công cụ, chúng tôi sẽ đăng thông báo tại cả hai nơi đó và trong Wavix release notes.

Hỗ trợ

Tài liệu sản phẩm: https://docs.wavix.com
Tài liệu tham khảo API: https://docs.wavix.com/api-reference
Câu hỏi / phản hồi: support@wavix.com

Đóng góp

Kho lưu trữ này có sẵn mã nguồn nhưng không mở cho đóng góp bên ngoài. Các pull request bị tự động đóng và Issues / Discussions bị tắt. Gửi báo cáo lỗi, yêu cầu tính năng và phản hồi tới support@wavix.com. Xem CONTRIBUTING.md để biết chi tiết.

Nếu bạn phát hiện lỗi trong framework FastMCP bên dưới, vui lòng báo cáo lên thượng nguồn tại đó.

Bảo mật

Để báo cáo lỗ hổng bảo mật, vui lòng gửi email tới support@wavix.com với tiêu đề Security: <short summary> thay vì mở issue công khai. Xem SECURITY.md để biết chi tiết.