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

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

Gửi tin nhắn SMS hoặc MMS — yêu cầu trợ lý gửi tin nhắn văn bản hoặc đa phương tiện bằng sms_and_mms_messages_send.
Chạy quy trình xác minh 2FA — yêu cầu trợ lý tạo xác minh bằng two_fa_verification_create và kiểm tra mã bạn nhận được qua two_fa_verification_check.
Tìm kiếm và mua số điện thoại — tìm các số khả dụng theo quốc gia và khả năng bằng buy_numbers_list, thêm chúng vào giỏ hàng và hoàn tất giao dịch mua.
Phân tích bản ghi cuộc gọi — tìm kiếm bản ghi cuộc gọi theo cụm từ cụ thể bằng cdrs_search và truy xuất toàn bộ siêu dữ liệu bằng cdrs_get.
Tải xuống bản ghi âm và bản phiên âm — lấy URL bản ghi cuộc gọi qua call_recording_get, yêu cầu phiên âm bằng cdrs_retranscribe và tải kết quả về.
Kiểm tra thanh toán và tải hóa đơn — xem lại các giao dịch bằng billing_transactions_list và lấy liên kết tải xuống PDF đã ký trước qua billing_invoices_download.

Tài liệu

Máy chủ Wavix MCP

Một máy chủ Model Context Protocol cung cấp cho các mô hình ngôn ngữ lớn (LLM) và 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, trung kế SIP, 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à một 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 luồng 2FA thông qua một API duy nhất. Có sẵn bản dùng thử miễn phí; việc sử dụng trả phí tuân theo gói giá của 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, 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 (thực tiễn tốt nhất, nếu token bị xâm phạm)
Khắc phục 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`
Truyền tải	HTTP có thể truyền trực tuyến
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 khám phá)

Lấy khóa API Wavix từ Bảng điều khiển Wavix → Quản trị → Khóa API → Tạo mới.

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ở Quản trị → Khóa API.
Nhấp Tạo mới (hoặc sao chép khóa hiện có). Giữ nó tiện dụng — 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

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

Để gỡ bỏ sau: mở cùng tệp cấu hình (~/.cursor/mcp.json, .vscode/mcp.json, hoặc tương đương cho trình soạn thảo của bạn) và xóa mục wavix, hoặc gỡ bỏ trình kết nối thông qua giao diện người dùng MCP / Trình kết nối 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"

Sử dụng claude mcp list để xác minh và /mcp bên trong một phiên để kiểm tra trạng thái.

Claude Desktop / Claude Web

Cài đặt → Trình kết nối → Thêm trình kết nối tùy chỉnh:

Tên: Wavix
URL: https://mcp.wavix.com/mcp
Truyền tải: Streamable HTTP
Tiêu đề xác thực: Authorization: Bearer <api_key>

Cursor (thủ công)

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

{
  "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 một đối tượng servers dưới khóa "mcp" trong settings.json 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 cho VS Code để biết lược đồ cập nhật nhất.

Codex CLI

Codex CLI hỗ trợ MCP qua stdio. Cầu nối tới 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ợ truyền tải HTTP có thể truyền trực tuyến với tiêu đề tùy chỉnh sẽ hoạt động. Sử dụng:

URL: https://mcp.wavix.com/mcp
Tiêu đề: Authorization: Bearer <api_key>

Đang thiết lập qua một tác nhân AI? Trỏ tác nhân của bạn tới llms-install.md — đó là một 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 để nó không ứ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 lập tức 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 bên 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 tới 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 ngược dòng (cho các 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 chấm dứt TLS trước máy chủ (nginx, Caddy, bộ cân bằng tải đám mây) trước khi hiển thị công khai.

Ví dụ

Các lời nhắc cụ thể bạn có thể thả vào bất kỳ máy khách được 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 phạm vi kiểm tra 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ực nào có thể liên lạc qua chúng.

Gửi SMS giao dịch

Lời nhắc: "Gửi một SMS từ +13105550100 đến +447700900123 với 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 gửi.

Chạy xác minh 2FA

Lời nhắc: "Gửi mã xác minh 2FA đến +13105550100 qua SMS. Khi tôi cung cấp 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, đợi bạn chia sẻ mã đến qua SMS, sau đó gọi two_fa_verification_check. Hữu ích cho việc tạo nguyên mẫu các luồng không mật khẩu mà không cần viết mã tích hợp.

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

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

Tác nhân chuỗ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ẽ tính phí tài khoản.

Tìm kiếm bản ghi cuộc gọi

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

Tác nhân sử dụng cdrs_search đối với các bản chép lời, sau đó làm giàu mỗi kết quả qua cdrs_get để có siêu dữ liệu cuộc gọi đầy đủ.

Lấy bản ghi âm và chép lời nó

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

Tác nhân gọi call_recording_get (trả về URL tải xuống được 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 một liên kết tải xuống cho hóa đơn PDF gần đây 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ề một URL được ký trước đến tệp PDF, không phải chính tệp đó — mở URL trong trình duyệt hoặc chuyển nó cho máy khách của bạn để lấy tài liệu thực tế.

Công cụ

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

Nhóm	#	Phạm vi
SMS và MMS	10	Gửi, liệt kê, truy xuất tin nhắn; ID 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	3	Liệt kê, tải xuống (URL được ký trước), xóa
Truyền 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	6	Liệt kê, xuất, truy xuất; tìm kiếm chép lời và chép lời lại
Phân tích giọng nói	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	7	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, khu vực, thành phố; tìm kiếm số có sẵn
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 đơn lẻ và hàng loạt
Trung kế SIP	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
Khóa API	5	Liệt kê, tạo, kích hoạt / hủy kích hoạt, xóa
Tài khoản phụ	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 bản kê
Chiến dịch thoại	2	Kích hoạt và truy xuất
Wavix Embeddable (WebRTC)	5	CRUD token tiện ích
Rút gọn liên kết	2	Tạo liên kết rút gọn; số liệu

Xem TOOLS.md để có 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ả Wavix OpenAPI — 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ủ 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 khám phá qua `llms.txt`).
`wavix://api/openapi.yaml`	Đặc tả Wavix OpenAPI 3.0 đầy đủ.

Cả hai nguồn — docs.wavix.com và đặc tả Wavix OpenAPI — đều có sẵn công khai và có thể được 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ờ. Token Bearer ngược dòng 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. Token:

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 giữa các máy chủ (ví dụ: URL tải xuống S3 được 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 một URL tải xuống được 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 nó mà không có tiêu đề Authorization.

Thực tiễn tốt nhất

Sử dụng khóa API chuyên dụng cho MCP. Tạo một khóa API riêng tại https://wavix.com → Quản trị → Khóa API (hoặc qua chính công cụ api_keys_create, từ mộ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ỳ. Xử lý 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ó bất kỳ nghi ngờ rò rỉ nào.
Giữ khóa API khỏi git. Cấu hình máy khách MCP dễ bị commit vô tình, mang theo token 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 trữ khóa API trong một biến môi trường hoặc chuỗi khóa hệ điều hành của bạn và tham chiếu nó từ cấu hình. Như một lưới an toàn, 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 của bạn:
```
.cursor/mcp.json
.vscode/mcp.json
claude_desktop_config.json
.claude/mcp.json
.codex/config.toml
```

Nếu token bị xâm phạm

Trong Bảng điều khiển Wavix, hủy kích hoạt 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 Bảng điều khiển.
Cập nhật cấu hình của máy khách và kết nối lại.
Xem xé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ó khả năng / cách khắc phục
`401 Unauthorized` từ bất kỳ công cụ nào	Thiếu hoặc tiêu đề `Authorization: Bearer …` không hợp lệ. Xác minh khóa API đang hoạt động trong Bảng điều khiển Wavix.
Công cụ trả về một `download_url`, không phải chính tệp đó	Dự kiến. Các điểm cuối ghi âm, hóa đơn, phân tích giọng nói và bằng chứng 10DLC trả về URL được ký trước (xem Xác thực). Tải URL trực tiếp mà không có tiêu đề `Authorization`.
Máy khách chỉ hiển thị ~40 công cụ, không phải danh mục đầy đủ	Các máy khách cũ hơn áp đặt giới hạn công cụ cho mỗi máy chủ. 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	Máy khách cục bộ có thể đang lưu bộ nhớ đệm danh sách công cụ cũ. Khởi động lại máy khách, hoặc gỡ bỏ và thêm lại máy chủ.
4xx với một mảng `errors`	Lỗi xác thực từ API Wavix. Kiểm tra `errors`; tham khảo chéo trang `wavix://docs/*` liên quan hoặc đặc tả OpenAPI.
Không thể kết nối đến máy chủ	Xác nhận DNS và HTTPS ra ngoài đến `mcp.wavix.com:443`.
Tác nhân gọi một công cụ hủy diệt bất ngờ	Hầu hết các máy khách có thể yêu cầu xác nhận trước khi gọi công cụ — bật cài đặt đó và xoay vòng sang khóa API MCP chuyên dụng (xem Thực tiễn tốt nhất).

Tương thích & giới hạn

Tương thích với bất kỳ máy khách MCP nào hỗ trợ truyền tải HTTP có thể truyền trực tuyến (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, SDK MCP tùy chỉnh) và bất kỳ khung tác nhân nào có bộ điều hợp máy khách MCP.
Các máy khách cũ hơn có thể áp đặt giới hạn công cụ cho mỗi máy chủ; nâng cấp lên phiên bản gần đây để truy cập danh mục đầy đủ.
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 giá Wavix.

Nhật ký thay đổi

Máy chủ được lưu trữ được cập nhật liên tục khi đặc tả Wavix OpenAPI phát triển; các công cụ mới xuất hiện tự động và các tham số công cụ hiện có có thể có thêm 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 trong Phát hành. Đối với các thay đổi hành vi đáng kể ảnh hưởng đến đầu vào công cụ hoặc xác thực, chúng tôi sẽ xuất bản thông báo cả ở đó và trong ghi chú phát hành Wavix.

Hỗ trợ

Tài liệu sản phẩm: https://docs.wavix.com
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 là có sẵn mã nguồn nhưng không mở cho đóng góp bên ngoài. Các yêu cầu kéo được tự động đóng và Vấn đề / Thảo luận bị vô hiệu hóa. Gửi báo cáo lỗi, yêu cầu tính năng và phản hồi đến support@wavix.com. Xem CONTRIBUTING.md để biết chi tiết.

Nếu bạn tìm thấy lỗi trong khung FastMCP cơ bản, vui lòng báo cáo ngược dòng ở đó.

Bảo mật

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