Wavix
chính thứcWavix 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.
Bạn có thể làm gì với Wavix MCP?
- Gửi SMS giao dịch — Yêu cầu gửi một tin nhắn SMS với nội dung tùy chỉnh và số người gửi qua
sms_and_mms_messages_send. - Chạy xác minh 2FA — Tạo và kiểm tra mã xác minh cho luồng đăng nhập không mật khẩu bằng
two_fa_verification_createvàtwo_fa_verification_check. - Tìm và mua số — Tìm kiếm số khả dụng theo quốc gia/tính năng, thêm vào giỏ hàng và thanh toán với xác nhận qua
buy_numbers_list,cart_addvàcart_checkout. - Tìm kiếm bản ghi cuộc gọi — Tìm cuộc gọi theo thời lượng và từ khóa trong bản phiên âm, sau đó bổ sung siêu dữ liệu đầy đủ qua
cdrs_searchvàcdrs_get. - Phiên âm bản ghi cuộc gọi — Truy xuất bản ghi cuộc gọi, yêu cầu phiên âm và kiểm tra kết quả bằng
call_recording_get_by_call,cdrs_retranscribevàcdrs_transcription_get. - Kiểm toán thanh toán — Liệt kê giao dịch và hóa đơn được lọc theo loại và ngày qua
billing_transactions_listvàbilling_invoices_list.
Tài liệu
Máy chủ MCP Wavix
Một máy chủ Giao thức ngữ cảnh mô hình cung cấp cho các 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, trunking 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à 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 luồng 2FA qua một API duy nhất. Có sẵn dùng thử miễn phí; việc sử dụng trả phí tuân theo gói định 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à kết nối bằng cách đăng nhập bằng tài khoản Wavix của bạn hoặc bằng khóa API Wavix. 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 — đăng nhập bằng tài khoản, khóa API, 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 | HTTP có thể truyền phát |
| Xác thực | Đăng nhập bằng tài khoản Wavix (OAuth 2.1), hoặ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
Hai cách để kết nối — chọn cách mà máy khách của bạn hỗ trợ; không cách nào bắt buộc hơn cách nào.
Đăng nhập bằng tài khoản Wavix
Nếu máy khách MCP của bạn hỗ trợ OAuth (Claude Desktop / Web và các máy khách hỗ trợ OAuth khác), hãy kết nối mà không cần khóa API: thêm trình kết nối cho https://mcp.wavix.com/mcp và khi máy khách nhắc, hãy đăng nhập bằng tài khoản Wavix của bạn và phê duyệt quyền truy cập. Máy khách chạy luồng OAuth 2.1 và tự lưu trữ mã thông báo — không cần dán gì cả. Các công cụ bạn nhận được được giới hạn theo những gì bạn phê duyệt và vai trò tài khoản của bạn cho phép (xem Xử lý sự cố).
Kết nối bằng khóa API
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ó ở nơi thuận tiện — bạn sẽ dán nó vào vị trí của
YOUR_API_KEYbên dưới.
Cài đặt một cú nhấp chuột
⚠️ 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 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 đã tạo và thay thế mã thông báo 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ỡ 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 nhập wavix hoặc gỡ trình kết nối qua giao diện 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 trong 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 - Giao thức truyền tải:
Streamable HTTP - Tiêu đề xác thực:
Authorization: Bearer <api_key>
Để kết nối bằng cách đăng nhập, hãy thêm trình kết nối mà không có tiêu đề xác thực và đăng nhập bằng tài khoản Wavix của bạn khi máy khách nhắc.
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. Kết nối vớ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ợ giao thức truyền tải HTTP có thể truyền phát với tiêu đề tùy chỉnh đều hoạt động. Sử dụng:
- URL:
https://mcp.wavix.com/mcp - Tiêu đề:
Authorization: Bearer <api_key>
Thiết lập qua tác nhân AI? Trỏ tác nhân của bạn vào 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 theo từng máy khách ở định dạng xác định để nó không tự ứng biến 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 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 vào 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 thượng nguồn (cho triển khai nội bộ hoặc giai đoạn thử nghiệm) |
OAUTH_ISSUER | chưa đặt | URL cơ sở của máy chủ ủy quyền OAuth 2.1. JWKS của nó được đọc từ <issuer>/.well-known/jwks.json |
OAUTH_RESOURCE | chưa đặt | URL cơ sở công khai mà máy chủ này được truy cập, được dùng làm định danh tài nguyên |
OAUTH_API_KEY_PASSTHROUGH | true | Với OAuth bật, vẫn chấp nhận bearer không phải JWT OAuth và chuyển tiếp lên thượng nguồn (khóa API vẫn hoạt động). Đặt false để yêu cầu JWT |
MCP_PATH | /mcp | Đường dẫn mà điểm cuối MCP được phục vụ |
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 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.
OAuth 2.1 (tùy chọn)
Đặt OAUTH_ISSUER và OAUTH_RESOURCE cùng nhau để biến máy chủ thành
tài nguyên được bảo vệ OAuth 2.1. Máy chủ sau đó xuất bản siêu dữ liệu RFC 9728 tại
/.well-known/oauth-protected-resource<MCP_PATH>, xác thực mã thông báo truy cập đến
dưới dạng JWT dựa trên JWKS của nhà phát hành và trả lời các yêu cầu chưa xác thực
bằng thử thách WWW-Authenticate trỏ đến siêu dữ liệu đó. Máy khách MCP
hỗ trợ OAuth sử dụng điều này để tự chạy luồng ủy quyền, vì vậy người dùng không còn
phải dán khóa API vào cấu hình máy khách của họ.
Đối tượng mà mỗi mã thông báo phải mang là OAUTH_RESOURCE + MCP_PATH, cũng là
giá trị resource được xuất bản trong siêu dữ liệu. Máy chủ ủy quyền
triển khai RFC 8707 so sánh tham số resource của máy khách
với chuỗi đó một cách chính xác, vì vậy cả hai phải được cấu hình khớp — bao gồm
cả đường dẫn.
Bật OAuth không cắt các máy khách xác thực bằng khóa API Wavix.
Mã thông báo bearer không phải JWT OAuth hợp lệ được chuyển tiếp lên thượng nguồn
mà không xác minh, giống như trước đây, để API Wavix là cơ quan duy nhất có thẩm quyền về nó —
vì vậy triển khai hiện có có thể bật OAuth cho máy khách mới mà không làm hỏng
các máy khách đã kết nối. Yêu cầu không mang mã thông báo nào vẫn nhận được
thử thách WWW-Authenticate, điều này cho phép máy khách hỗ trợ OAuth
khám phá máy chủ ủy quyền. Chỉ các kết nối xác thực OAuth mới được
lọc theo phạm vi; kết nối khóa API thấy toàn bộ bề mặt công cụ.
Đặt OAUTH_API_KEY_PASSTHROUGH=false để bỏ phương án dự phòng đó và yêu cầu JWT hợp lệ —
chế độ nghiêm ngặt để chuyển sang khi quyền truy cập khóa API bị ngừng.
Để trống một trong hai OAUTH_ISSUER / OAUTH_RESOURCE giữ nguyên hành vi
trước đó: không xuất bản siêu dữ liệu và bất kỳ mã thông báo bearer nào máy khách gửi
được chuyển tiếp lên thượng nguồn mà không xác minh.
Ví dụ
Các lời nhắc cụ thể bạn có thể đưa 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 kiểm thử dành riêng (NANP555và Ofcom070 09xx) — an toàn để sao chép nguyên văn, không có thuê bao thực 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 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 đư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í Hoa Kỳ khả dụ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 chuỗi buy_numbers_list (lọc theo quốc gia và tính năng), cart_add và cart_checkout. cart_checkout trước tiên trả về bản xem trước với các số và phí của chúng, và chỉ tính phí tài khoản khi được gọi lại với confirmation_token của nó.
Tìm kiếm bản ghi 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 đề cập đến 'hoàn tiền'."
Tác nhân sử dụng cdrs_search trên các bản phiên âm, sau đó làm phong phú từng kết quả qua cdrs_get để có siêu dữ liệu cuộc gọi đầy đủ.
Tải bản ghi và phiên âm
Lời nhắc: "Lấy bản ghi cho cuộc gọi abc-123, yêu cầu Wavix phiên âm nó và trả về bản phiên âm."
Tác nhân gọi call_recording_get_by_call (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 và những hóa đơn nào đã được phát hành?"
Tác nhân gọi billing_transactions_list được lọc theo loại và ngày, sau đó billing_invoices_list. Việc tải xuống PDF hóa đơn không được hiển thị qua MCP — hãy tải từ API hoặc bảng điều khiển Wavix.
Công cụ
Được tạo từ đặc tả OpenAPI Wavix. Các đối số phản ánh tham số yêu cầu và trường nội dung. Các công cụ hiển thị phụ thuộc vào quyền bạn phê duyệt khi đăng nhập và các tính năng được bật trên tài khoản của bạn.
| Nhóm | Phạm vi |
|---|---|
| SMS và MMS | Gửi, liệt kê, truy xuất tin nhắn; mã người gửi; từ chối nhận tin |
| Tài khoản doanh nghiệp; người gửi; mẫu tin nhắn; gửi / liệt kê / truy xuất tin nhắn | |
| Điều khiển cuộc gọi | 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 | Liệt kê, tải xuống (URL ký sẵn), xóa |
| Phát trực tuyến cuộc gọi | Bắt đầu / dừng luồng phương tiện |
| Webhook cuộc gọi | Liệt kê, tạo, xóa |
| CDR | Liệt kê, truy xuất; tìm kiếm bản ghi âm và phiên âm lại |
| Phân tích giọng nói | Phiên âm, truy xuất tệp gốc |
| 2FA | Tạo / kiểm tra / hủy / gửi lại xác minh; sự kiện |
| Số của tôi | Liệt kê, cập nhật, giải phóng; định tuyến SMS / thoại |
| Mua | Quốc gia, khu vực, thành phố; tìm kiếm số khả dụng |
| Giỏ hàng | Thêm, xóa, truy xuất, thanh toán |
| Trình xác thực số | Xác thực đơn lẻ và hàng loạt |
| Tổng đài SIP | CRUD đầy đủ |
| 10DLC | Thương hiệu, chiến dịch, thẩm định, bằng chứng, đăng ký sự kiện |
| Hồ sơ | Lấy / cập nhật hồ sơ; cấu hình tài khoản |
| Khóa API | Liệt kê, tạo, cập nhật, xóa |
| Tài khoản con | Liệt kê, tạo, lấy, cập nhật; giao dịch |
| Thanh toán | Giao dịch; liệt kê hóa đơn / sao kê |
| Chiến dịch thoại | Kích hoạt và truy xuất |
| Wavix Nhúng (WebRTC) | CRUD mã widget |
| Rút gọn liên kết | Tạo liên kết ngắn; số liệu |
Xem TOOLS.md để biết danh sách đầy đủ các công cụ kèm 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 cung cấp tài liệu Wavix dưới dạng Tài nguyên MCP, để mô hình có thể kéo 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ả OpenAPI 3.0 đầy đủ của Wavix. |
Cả hai nguồn — docs.wavix.com và Đặc tả OpenAPI Wavix — đều 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 theo nhu cầu khi resources/read và được lưu cache phía máy chủ với TTL 1 giờ. Mã thông báo Bearer ngược dòng không bao giờ được chuyển tiếp đến máy chủ tài liệu — chỉ đến api.wavix.com.
Xác thực
Máy chủ lưu trữ chấp nhận hai phương thức kết nối — không phương thức nào được ưu tiên:
- Đăng nhập bằng tài khoản Wavix (OAuth 2.1). Dành cho máy khách hỗ trợ OAuth. Máy khách chạy luồng ủy quyền và người dùng đăng nhập; không lưu khóa API. Quyền truy cập bị giới hạn theo phạm vi người dùng chấp thuận và vai trò tài khoản của họ. Xem Đăng nhập bằng tài khoản Wavix.
- Khóa API Wavix (Bearer). Dành cho mọi máy khách Streamable-HTTP. Mỗi yêu cầu phải bao gồm:
Authorization: Bearer <api_key>
Máy chủ chuyển tiếp tiêu đề này đến api.wavix.com cho 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 giữa các máy chủ (ví dụ: URL tải xuống S3 ký sẵn),
- không bao giờ được gửi đến máy chủ tài liệu.
Nếu máy khách của bạn theo dõi URL tải xuống ký sẵn do call_recording_get_by_call, speech_analytics_file_get hoặc ten_dlc_brand_evidence_get trả về, hãy tải trực tiếp URL đó mà không có tiêu đề Authorization.
Các phương pháp tốt nhất
-
Sử dụng khóa API chuyên dụng cho MCP. Tạo 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ừ 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 ảnh hưởng đến các tích hợp khác. -
Xoay vòng định kỳ. Coi 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 nghi ngờ rò rỉ.
-
Giữ khóa API ngoài git. Cấu hình máy khách MCP dễ bị commit nhầm, kéo theo mã thông báo vào lịch sử và nhật ký CI. Hầu hết 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. Để 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.gitignorecủa dự án:.cursor/mcp.json .vscode/mcp.json claude_desktop_config.json .claude/mcp.json .codex/config.toml
Nếu thông tin xác thực bị xâm phạm
Nếu bạn kết nối bằng khóa API:
- Trong Bảng điều khiển Wavix, hủy kích hoạt hoặc xóa khóa đó ngay lập tức (hoặc gọi
api_keys_delete). - Tạo khóa thay thế qua
api_keys_createhoặc Bảng điều khiển. - Cập nhật cấu hình máy khách và kết nối lại.
Nếu bạn kết nối bằng cách đăng nhập tài khoản Wavix:
- Thu hồi kết nối từ trang quản lý ủy quyền của cổng Wavix, nơi liệt kê các kết nối bạn đã ủy quyền và thu hồi kết nối bạn chọn — điều này vô hiệu hóa mã thông báo của kết nối đó. Không liên quan đến khóa API.
- Kết nối lại và đăng nhập lại.
Trong cả hai trường hợp, hãy xem lại 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 khả dĩ |
|---|---|
401 Unauthorized từ bất kỳ công cụ nào | Xác thực thất bại. Với khóa API: tiêu đề Authorization: Bearer … bị thiếu, hoặc khóa không hợp lệ hoặc không hoạt động — hãy xác minh trong Bảng điều khiển Wavix. Với đăng nhập tài khoản: phiên/mã thông báo của bạn đã hết hạn hoặc bị thu hồi, hoặc đăng nhập chưa hoàn tất — hãy kết nối lại và đăng nhập lại. |
Công cụ trả về download_url, không phải chính tệp | Điều này là bình thường. Các điểm cuối ghi âm, phân tích giọng nói và bằng chứng 10DLC trả về URL ký sẵn (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ị một phần danh mục | Máy khách cũ áp đặt giới hạn công cụ trên mỗi máy chủ. Hãy nâng cấp (Cursor 2.4+, VS Code mới nhất, Claude mới nhất). |
| Ít công cụ hơn sau khi đăng nhập bằng tài khoản Wavix | Điều này là bình thường. Đăng nhập tài khoản bị lọc theo phạm vi — bạn nhận được các công cụ mà phạm vi đã phê duyệt và vai trò tài khoản cho phép, không phải toàn bộ danh mục. Kết nối bằng khóa API thấy toàn bộ bề mặt công cụ. Để mở rộng tập hợp, hãy phê duyệt thêm phạm vi khi đăng nhập (tùy thuộc vai trò) hoặc kết nối bằng khóa API mang các phạm vi đó. |
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 cache danh sách công cụ cũ. Khởi động lại máy khách, hoặc xóa và thêm lại máy chủ. |
4xx với mảng errors | Lỗi xác thực từ API Wavix. Kiểm tra errors; đối chiếu trang wavix://docs/* liên quan hoặc đặc tả OpenAPI. |
| Không thể truy cập máy chủ | Xác nhận DNS và HTTPS gửi đi đến mcp.wavix.com:443. |
| Tác nhân gọi công cụ phá hoại bất ngờ | Hầu hết 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 Các phương pháp tốt nhất). |
Tương thích & giới hạn
- Tương thích với mọi máy khách MCP hỗ trợ truyền tải Streamable HTTP (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, MCP SDK tùy chỉnh) và mọi khung tác nhân có bộ điều hợp máy khách MCP.
- Mọi công cụ được chú thích bằng
destructiveHint, cùng vớicall_webhooks_create,sip_trunks_updatevàsub_accounts_update, chạy theo hai bước: lệnh gọi đầu tiên trả về bản xem trước vàconfirmation_tokendùng một lần (hiệu lực 5 phút), và hành động chỉ chạy khi công cụ được gọi lại với cùng đối số và mã thông báo đó. Mọi máy khách MCP đều có thể làm điều này; không cần hỗ trợ xác nhận phía máy khách. - Máy khách cũ có thể áp đặt giới hạn công cụ trên mỗi máy chủ; hãy nâng cấp lên phiên bản gần đây để 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 Giá Wavix.
Nhật ký thay đổi
Máy chủ lưu trữ được cập nhật liên tục khi đặc tả OpenAPI Wavix phát triển; công cụ mới xuất hiện tự động và đối số công cụ hiện có có thể thêm trường tùy chọn. Thay đổi tài liệu cho kho lưu trữ này được theo dõi trong Bản phát hành. Đối với 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ẽ đăng 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
- 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. Yêu cầu kéo 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 lên đó.
Bảo mật
Để báo cáo lỗ hổng bảo mật, vui lòng gửi email đến support@wavix.com với tiêu đề Security: <short summary> thay vì mở vấn đề công khai. Xem SECURITY.md để biết chi tiết.
Giấy phép
MIT © Wavix