Wavix

เซิร์ฟเวอร์ MCP ของ Wavix

เซิร์ฟเวอร์ Model Context Protocol ที่ให้ LLM และเอเจนต์ AI เข้าถึง แพลตฟอร์มโทรคมนาคม Wavix ได้โดยตรง — SMS/MMS, การโทรด้วยเสียง, 2FA, SIP trunking, การจัดการหมายเลขโทรศัพท์, การลงทะเบียน 10DLC, การบันทึกการโทร, การวิเคราะห์คำพูด และการเรียกเก็บเงิน

Wavix คือแพลตฟอร์มการสื่อสารระดับโลกสำหรับส่ง SMS, โทรด้วยเสียง และดำเนินการ flows ของ 2FA ผ่าน API เดียว มี ทดลองใช้ฟรี ให้บริการ; การใช้งานแบบชำระเงินเป็นไปตามแผน ราคา ของ Wavix ที่ผูกกับบัญชีของคุณ

วิธีที่เร็วที่สุดในการใช้เซิร์ฟเวอร์ MCP นี้คือ endpoint ที่โฮสต์ไว้ ที่ https://mcp.wavix.com/mcp — ชี้ไคลเอนต์ที่รองรับ MCP ไปที่ endpoint นั้นแล้วเชื่อมต่อโดยลงชื่อเข้าด้วยบัญชี Wavix หรือคีย์ API ของ Wavix หากคุณต้องการโฮสต์ด้วยตัวเอง (การปรับใช้ Wavix แบบกำหนดเอง, อยู่หลังไฟร์วอลล์, อินสแตนซ์เฉพาะ) ดู รันด้วยตัวเอง

สารบัญ

• Endpoint
• ติดตั้ง — ลงชื่อเข้าด้วยบัญชี, คีย์ API, คลิกเดียว, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
• รันด้วยตัวเอง (โฮสต์เอง)
• ตัวอย่าง
• เครื่องมือ → แคตตาล็อกเต็มใน TOOLS.md
• ทรัพยากร
• การรับรองความถูกต้อง (แนวทางปฏิบัติที่ดีที่สุด, หากโทเค็นถูกบุกรุก)
• การแก้ไขปัญหา
• ความเข้ากันได้และข้อจำกัด
• การสนับสนุน, การมีส่วนร่วม, ความปลอดภัย, ใบอนุญาต

Endpoint

ฟิลด์	ค่า
URL	https://mcp.wavix.com/mcp
Transport	Streamable HTTP
Auth	ลงชื่อเข้าด้วยบัญชี Wavix (OAuth 2.1), หรือ Authorization: Bearer <api_key>
เครื่องมือ	ดู TOOLS.md
ทรัพยากร	เอกสาร Wavix + ข้อมูลจำเพาะ OpenAPI (ค้นพบอัตโนมัติ)

รับคีย์ API ของ Wavix จาก Wavix Console → Administration → API keys → Create new

ติดตั้ง

สองวิธีในการเชื่อมต่อ — เลือกวิธีที่ไคลเอนต์ของคุณรองรับ; ไม่มีวิธีใดที่เหนือกว่าอีกวิธีหนึ่ง

ลงชื่อเข้าด้วยบัญชี Wavix

หากไคลเอนต์ MCP ของคุณรองรับ OAuth (Claude Desktop / Web และไคลเอนต์อื่นๆ ที่รองรับ OAuth) ให้เชื่อมต่อ โดยไม่ต้องใช้คีย์ API: เพิ่มตัวเชื่อมต่อสำหรับ https://mcp.wavix.com/mcp และเมื่อไคลเอนต์แจ้ง ให้ลงชื่อเข้าด้วยบัญชี Wavix ของคุณและอนุมัติการเข้าถึง ไคลเอนต์จะดำเนินการ flow ของ OAuth 2.1 และเก็บโทเค็นไว้เอง — ไม่ต้องวางอะไรเพิ่มเติม เครื่องมือที่คุณได้รับจะจำกัดขอบเขตตามสิ่งที่คุณอนุมัติและบทบาทบัญชีของคุณอนุญาต (ดู การแก้ไขปัญหา)

เชื่อมต่อด้วยคีย์ API

ก่อนเริ่ม: รับคีย์ API ของ Wavix

1. ลงชื่อเข้าที่ https://wavix.com
2. เปิด Administration → API keys
3. คลิก Create new (หรือคัดลอกคีย์ที่มีอยู่) เก็บไว้ใกล้มือ — คุณจะวางลงในตำแหน่งของ YOUR_API_KEY ด้านล่าง

การติดตั้งแบบคลิกเดียว

⚠️ ปุ่มด้านล่างจะใส่โทเค็นตัวยึดตำแหน่ง YOUR_API_KEY ลงในไฟล์กำหนดค่า MCP ของโปรแกรมแก้ไขของคุณ หลังจากโปรแกรมแก้ไขติดตั้งเสร็จ ให้เปิดไฟล์กำหนดค่าที่สร้างขึ้นและแทนที่ตัวยึดตำแหน่งด้วยคีย์ API จริงของคุณก่อนส่งคำขอใดๆ — มิฉะนั้นทุกการเรียกจะส่งคืน 401 Unauthorized

หากต้องการลบในภายหลัง: เปิดไฟล์กำหนดค่าเดียวกัน (~/.cursor/mcp.json, .vscode/mcp.json, หรือไฟล์ที่เทียบเท่าสำหรับโปรแกรมแก้ไขของคุณ) และลบรายการ wavix หรือลบตัวเชื่อมต่อผ่าน UI ของ 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

การตั้งค่า → Connectors → Add custom connector:

• ชื่อ: Wavix
• URL: https://mcp.wavix.com/mcp
• Transport: 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 ในเวิร์กสเปซของคุณ (หรือเพิ่มออบเจกต์ servers เดียวกันภายใต้คีย์ "mcp" ใน settings.json ของผู้ใช้):

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

ดู คู่มือเซิร์ฟเวอร์ MCP ของ VS Code สำหรับ schema ล่าสุด

Codex CLI

Codex CLI รองรับ MCP ผ่าน stdio เชื่อมต่อไปยังเซิร์ฟเวอร์ที่โฮสต์ผ่าน 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 / ไคลเอนต์อื่นๆ

ไคลเอนต์ MCP ใดๆ ที่รองรับ transport แบบ Streamable HTTP พร้อมส่วนหัวที่กำหนดเองจะใช้งานได้ ใช้:

• URL: https://mcp.wavix.com/mcp
• ส่วนหัว: Authorization: Bearer <api_key>

กำลังตั้งค่าผ่านเอเจนต์ AI ใช่ไหม? ชี้เอเจนต์ของคุณไปที่ llms-install.md — เป็นคู่มือการติดตั้งที่เครื่องอ่านได้ซึ่งให้ URL, ส่วนหัว และการกำหนดค่าต่อไคลเอนต์ในรูปแบบที่กำหนดได้แก่โมเดล เพื่อไม่ให้โมเดลคิดค้นค่า endpoint ขึ้นเอง

รันด้วยตัวเอง

เซิร์ฟเวอร์ที่โฮสต์ทำงานได้ทันทีสำหรับผู้ใช้ส่วนใหญ่ โฮสต์เองหากคุณต้องการชี้ไปที่การปรับใช้ Wavix ที่ไม่ใช่สาธารณะ รันอยู่หลังไฟร์วอลล์ หรือดำเนินการภายในโครงสร้างพื้นฐานของคุณเอง

Docker

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

เซิร์ฟเวอร์ฟังบนพอร์ต 8000 และเปิดเผย endpoint 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	แทนที่ endpoint API ของ Wavix ต้นทาง (สำหรับการปรับใช้ภายในหรือ staging)
OAUTH_ISSUER	ไม่ได้ตั้งค่า	Base URL ของเซิร์ฟเวอร์อนุญาต OAuth 2.1 อ่าน JWKS จาก <issuer>/.well-known/jwks.json
OAUTH_RESOURCE	ไม่ได้ตั้งค่า	Base URL สาธารณะที่เซิร์ฟเวอร์นี้เข้าถึงได้ ใช้เป็นตัวระบุทรัพยากร
OAUTH_API_KEY_PASSTHROUGH	true	เมื่อเปิด OAuth ยังคงยอมรับ bearer ที่ไม่ใช่ OAuth JWT และส่งต่อไปยังต้นทาง (คีย์ API ยังทำงานได้) ตั้งค่า false เพื่อกำหนดให้ต้องใช้ JWT
MCP_PATH	/mcp	พาธที่ให้บริการ endpoint MCP

ไม่จำเป็นต้องใช้ข้อมูลประจำตัว Wavix ในการ รัน เซิร์ฟเวอร์ — ข้อมูลเหล่านั้นจะถูกส่งต่อตามคำขอจากส่วนหัว Authorization: Bearer <api_key> ของไคลเอนต์ MCP ผู้ที่โฮสต์เองมีหน้าที่รับผิดชอบในการยุติ TLS หน้าของเซิร์ฟเวอร์ (nginx, Caddy, load balancer ของคลาวด์) ก่อนเปิดเผยต่อสาธารณะ

OAuth 2.1 (ไม่บังคับ)

ตั้งค่า OAUTH_ISSUER และ OAUTH_RESOURCE พร้อมกันเพื่อเปลี่ยนเซิร์ฟเวอร์ให้เป็นทรัพยากรที่ได้รับการป้องกันด้วย OAuth 2.1 จากนั้นเซิร์ฟเวอร์จะเผยแพร่ข้อมูลเมตา RFC 9728 ที่ /.well-known/oauth-protected-resource<MCP_PATH> ตรวจสอบโทเค็นการเข้าถึงที่เข้ามาเป็น JWT กับ JWKS ของผู้ออก และตอบสนองต่อคำขอที่ไม่ได้รับการรับรองความถูกต้องด้วยความท้าทาย WWW-Authenticate ที่ชี้ไปยังข้อมูลเมตานั้น ไคลเอนต์ MCP ที่รองรับ OAuth จะใช้สิ่งนี้เพื่อดำเนินการ flow การอนุญาตด้วยตนเอง ดังนั้นผู้ใช้จึงไม่ต้องวางคีย์ API ลงในไฟล์กำหนดค่าไคลเอนต์อีกต่อไป

ผู้ชม (audience) ที่แต่ละโทเค็นต้องมีคือ OAUTH_RESOURCE + MCP_PATH ซึ่งเป็นค่าของ resource ที่เผยแพร่ในข้อมูลเมตาด้วย เซิร์ฟเวอร์อนุญาตที่ใช้ RFC 8707 จะเปรียบเทียบพารามิเตอร์ resource ของไคลเอนต์กับสตริงนั้นอย่างแม่นยำ ดังนั้นทั้งสองต้องได้รับการกำหนดค่าให้ตรงกัน — รวมถึงพาธด้วย

การเปิด OAuth ไม่ได้ ตัดไคลเอนต์ที่รับรองความถูกต้องด้วยคีย์ API ของ Wavix โทเค็น bearer ที่ไม่ใช่ OAuth JWT ที่ถูกต้องจะถูกส่งต่อไปยังต้นทางโดยไม่ตรวจสอบ เช่นเดิม โดยปล่อยให้ API ของ Wavix เป็นผู้มีอำนาจแต่เพียงผู้เดียว — ดังนั้นการปรับใช้ที่มีอยู่สามารถเปิด OAuth สำหรับไคลเอนต์ใหม่ได้โดยไม่ทำให้ไคลเอนต์ที่เชื่อมต่ออยู่แล้วเสียหาย คำขอที่ไม่มีการนำโทเค็นใดๆ มาด้วยจะยังได้รับความท้าทาย WWW-Authenticate ซึ่งเป็นสิ่งที่ทำให้ไคลเอนต์ที่รองรับ OAuth ค้นพบเซิร์ฟเวอร์อนุญาตได้ เฉพาะการเชื่อมต่อที่รับรองความถูกต้องด้วย OAuth เท่านั้นที่ถูกกรองขอบเขต; การเชื่อมต่อด้วยคีย์ API จะเห็นพื้นผิวเครื่องมือทั้งหมด

ตั้งค่า OAUTH_API_KEY_PASSTHROUGH=false เพื่อยกเลิก fallback นั้นและกำหนดให้ต้องใช้ JWT ที่ถูกต้อง — โหมดเข้มงวดที่ควรเปลี่ยนไปใช้เมื่อยกเลิกการเข้าถึงด้วยคีย์ API แล้ว

การปล่อยให้ OAUTH_ISSUER / OAUTH_RESOURCE ตัวใดตัวหนึ่งไม่ได้ตั้งค่าจะรักษาพฤติกรรมเดิม: ไม่มีการเผยแพร่ข้อมูลเมตา และโทเค็น bearer ใดๆ ที่ไคลเอนต์ส่งจะถูกส่งต่อไปยังต้นทางโดยไม่ตรวจสอบ

ตัวอย่าง

พรอมต์ที่เป็นรูปธรรมที่คุณสามารถวางลงในไคลเอนต์ที่เชื่อมต่อใดๆ ได้

หมายเลขโทรศัพท์ด้านล่าง (+1 310 555 0100, +44 7700 900123) อยู่ในช่วงทดสอบที่สงวนไว้ (NANP 555 และ Ofcom 070 09xx) — ปลอดภัยที่จะคัดลอกตามตัวอักษร ไม่มีผู้ใช้จริงที่สามารถเข้าถึงได้ผ่านหมายเลขเหล่านี้

ส่ง SMS แบบธุรกรรม

พรอมต์: "ส่ง SMS จาก +13105550100 ไปยัง +447700900123 ข้อความว่า 'Your verification code is 4821'"

เอเจนต์เรียก sms_and_mms_messages_send ด้วย from, to และ text ส่งคืน ID ข้อความและสถานะการส่ง

รันการตรวจสอบ 2FA

พรอมต์: "ส่งรหัสตรวจสอบ 2FA ไปยัง +13105550100 ผ่าน SMS เมื่อฉันให้รหัสที่ได้รับแก่คุณ ให้ตรวจสอบว่ารหัสถูกต้องหรือไม่"

เอเจนต์เรียก two_fa_verification_create รอให้คุณแชร์รหัสที่ได้รับผ่าน SMS จากนั้นเรียก two_fa_verification_check มีประโยชน์สำหรับการสร้างต้นแบบ flows แบบไม่ต้องใช้รหัสผ่านโดยไม่ต้องเขียนโค้ดการผสานรวม

ค้นหาและซื้อหมายเลขโทรศัพท์

พรอมต์: "ค้นหาหมายเลขโทรฟรีของสหรัฐฯ ที่พร้อมใช้งานพร้อมความสามารถ SMS เพิ่มลงในรถเข็นของฉัน และชำระเงิน"

เอเจนต์เชื่อมโยง buy_numbers_list (กรองตามประเทศและคุณสมบัติ), cart_add และ cart_checkout cart_checkout จะส่งคืนตัวอย่างพร้อมหมายเลขและค่าธรรมเนียมก่อน และจะเรียกเก็บเงินจากบัญชีเมื่อถูกเรียกอีกครั้งด้วย confirmation_token เท่านั้น

ค้นหาบทถอดเสียงการโทร

พรอมต์: "แสดงการโทรเข้าทั้งหมดจากเมื่อวานที่ยาวกว่าสองนาทีซึ่งผู้โทรพูดถึง 'refund'"

เอเจนต์ใช้ 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 — ดึงจาก API ของ Wavix หรือแดชบอร์ด

เครื่องมือ

สร้างจาก ข้อมูลจำเพาะ OpenAPI ของ Wavix อาร์กิวเมนต์สะท้อนพารามิเตอร์คำขอและฟิลด์ body เครื่องมือที่แสดงขึ้นอยู่กับสิทธิ์ที่คุณอนุมัติเมื่อลงชื่อเข้าและคุณสมบัติที่เปิดใช้งานในบัญชีของคุณ

กลุ่ม	ความครอบคลุม
SMS และ MMS	ส่ง, แสดงรายการ, ดึงข้อความ; รหัสผู้ส่ง; การเลือกไม่รับ
WhatsApp	บัญชีธุรกิจ; ผู้ส่ง; เทมเพลต; ส่ง / แสดงรายการ / ดึงข้อความ
การควบคุมสาย	เริ่ม / รับ / วางสาย; เล่นเสียง; เก็บ DTMF
การบันทึกสาย	แสดงรายการ, ดาวน์โหลด (URL ที่ลงนามล่วงหน้า), ลบ
การสตรีมสาย	เริ่ม / หยุดสตรีมสื่อ
Webhooks สาย	แสดงรายการ, สร้าง, ลบ
CDRs	แสดงรายการ, ดึงข้อมูล; ค้นหาบทถอดความและถอดความใหม่
Speech Analytics	ถอดความ, ดึงไฟล์ต้นฉบับ
2FA	สร้าง / ตรวจสอบ / ยกเลิก / ส่งการยืนยันอีกครั้ง; เหตุการณ์
หมายเลขของฉัน	แสดงรายการ, อัปเดต, ปล่อย; การกำหนดเส้นทาง SMS / เสียง
ซื้อ	ประเทศ, ภูมิภาค, เมือง; ค้นหาหมายเลขที่พร้อมใช้งาน
ตะกร้า	เพิ่ม, ลบ, ดึงข้อมูล, ชำระเงิน
ตัวตรวจสอบหมายเลข	การตรวจสอบเดี่ยวและแบบกลุ่ม
SIP trunks	CRUD ครบถ้วน
10DLC	แบรนด์, แคมเปญ, การตรวจสอบ, หลักฐาน, การสมัครรับเหตุการณ์
โปรไฟล์	รับ / อัปเดตโปรไฟล์; การกำหนดค่าบัญชี
API Keys	แสดงรายการ, สร้าง, อัปเดต, ลบ
บัญชีย่อย	แสดงรายการ, สร้าง, รับ, อัปเดต; ธุรกรรม
การเรียกเก็บเงิน	ธุรกรรม; แสดงรายการใบแจ้งหนี้ / ใบแจ้งยอด
แคมเปญเสียง	ทริกเกอร์และดึงข้อมูล
Wavix Embeddable (WebRTC)	CRUD โทเค็นวิดเจ็ต
ตัวย่อลิงก์	สร้างลิงก์สั้น; ตัวชี้วัด

ดู TOOLS.md สำหรับรายการเครื่องมือทั้งหมดพร้อมคำอธิบายหนึ่งบรรทัด แหล่งข้อมูลที่เชื่อถือได้คือ Wavix OpenAPI spec — ไคลเอนต์ของคุณจะเห็นแคตตาล็อกสดปัจจุบันเสมอ

ทรัพยากร

นอกเหนือจากเครื่องมือ เซิร์ฟเวอร์ยังเปิดเผยเอกสาร Wavix เป็น ทรัพยากร MCP เพื่อให้โมเดลสามารถดึงบริบทที่เชื่อถือได้ตามต้องการแทนการคาดเดาจากความรู้เดิม

รูปแบบ URI	เนื้อหา
wavix://docs/<path>	หน้าคู่มือจาก docs.wavix.com (ค้นพบอัตโนมัติผ่าน llms.txt)
wavix://api/openapi.yaml	ข้อกำหนด Wavix OpenAPI 3.0 ฉบับเต็ม

ทั้งสองแหล่ง — docs.wavix.com และ Wavix OpenAPI spec — เปิดเผยต่อสาธารณะและสามารถเรียกดูได้โดยตรงโดยไม่ต้องรับรองความถูกต้อง

ทรัพยากรถูกดึงแบบขี้เกียจบน resources/read และแคชฝั่งเซิร์ฟเวอร์ด้วย TTL 1 ชั่วโมง โทเค็น Bearer ต้นทางจะ ไม่ถูกส่งต่อ ไปยังโฮสต์เอกสาร — ส่งไปยัง api.wavix.com เท่านั้น

การรับรองความถูกต้อง

เซิร์ฟเวอร์ที่โฮสต์รองรับสองวิธีเชื่อมต่อ — ไม่มีวิธีใดที่ต้องการเป็นพิเศษ:

• ลงชื่อเข้าด้วยบัญชี Wavix (OAuth 2.1) สำหรับไคลเอนต์ที่รองรับ OAuth ไคลเอนต์จะรันโฟลว์การอนุญาตและผู้ใช้ลงชื่อเข้า; ไม่มีการเก็บ API key การเข้าถึงถูกจำกัดขอบเขตตามที่ผู้ใช้อนุมัติและบทบาทบัญชีอนุญาต ดู ลงชื่อเข้าด้วยบัญชี Wavix
• Wavix API key (Bearer) สำหรับไคลเอนต์ Streamable-HTTP ใด ๆ ทุกคำขอต้องรวม:

Authorization: Bearer <api_key>

เซิร์ฟเวอร์ส่งต่อส่วนหัวนี้ไปยัง api.wavix.com ต่อคำขอ โทเค็น:

• ไม่ถูกบันทึก ในบันทึก,
• ไม่ถูกส่งต่อ ในการเปลี่ยนเส้นทางข้ามโฮสต์ (เช่น URL ดาวน์โหลด S3 ที่ลงนามล่วงหน้า),
• ไม่ถูกส่ง ไปยังโฮสต์เอกสาร

หากไคลเอนต์ของคุณติดตาม URL ดาวน์โหลดที่ลงนามล่วงหน้าที่ส่งคืนโดย call_recording_get_by_call, speech_analytics_file_get หรือ ten_dlc_brand_evidence_get ให้ดึงข้อมูลโดยตรงโดยไม่ต้องใช้ส่วนหัว Authorization

แนวทางปฏิบัติที่ดีที่สุด

• ใช้ API key เฉพาะสำหรับ MCP สร้าง API key แยกต่างหากที่ https://wavix.com → การดูแลระบบ → API keys (หรือผ่านเครื่องมือ api_keys_create เอง จากเซสชันอื่น) วิธีนี้ช่วยให้คุณเพิกถอนการเข้าถึง MCP ได้โดยไม่รบกวนการผสานรวมอื่น ๆ

• หมุนเวียนเป็นระยะ ปฏิบัติต่อ API key เหมือนความลับในการผลิต: หมุนเวียนตามกำหนดเวลาและเมื่อสงสัยว่ามีการรั่วไหล

• เก็บ API keys ไว้นอก git การกำหนดค่าไคลเอนต์ MCP ง่ายต่อการคอมมิตโดยไม่ตั้งใจ พาโทเค็นไปด้วยในประวัติและบันทึก CI ไคลเอนต์ส่วนใหญ่รองรับการแทนที่ ${env:VAR} ในค่าส่วนหัว — เก็บ API key ในตัวแปรสภาพแวดล้อมหรือคีย์เชน OS ของคุณและอ้างอิงจากการกำหนดค่า เป็นตาข่ายนิรภัย เพิ่มเส้นทางการกำหนดค่าไคลเอนต์ทั่วไปใน .gitignore ของโปรเจกต์:

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

หากข้อมูลรับรองถูกบุกรุก

หากคุณเชื่อมต่อด้วย API key:

1. ใน Wavix Console ปิดใช้งานหรือลบคีย์นั้นทันที (หรือเรียก api_keys_delete)
2. สร้างคีย์ทดแทนผ่าน api_keys_create หรือ Console
3. อัปเดตการกำหนดค่าไคลเอนต์และเชื่อมต่อใหม่

หากคุณเชื่อมต่อโดยลงชื่อเข้าด้วยบัญชี Wavix:

1. เพิกถอนการเชื่อมต่อจากหน้าการจัดการสิทธิ์ของพอร์ทัล Wavix ซึ่งแสดงรายการการเชื่อมต่อที่คุณอนุญาตและเพิกถอนรายการที่คุณเลือก — วิธีนี้ทำให้โทเค็นของการเชื่อมต่อนั้นไม่ถูกต้อง ไม่มี API key เกี่ยวข้อง
2. เชื่อมต่อใหม่และลงชื่อเข้าอีกครั้ง

ในทั้งสองกรณี ตรวจสอบ billing_transactions_list และ cdrs_list สำหรับกิจกรรมที่ไม่คาดคิด

การแก้ไขปัญหา

อาการ	สาเหตุที่เป็นไปได้ / วิธีแก้ไข
401 Unauthorized จากเครื่องมือใด ๆ	การรับรองความถูกต้องล้มเหลว ด้วย API key: ส่วนหัว Authorization: Bearer … หายไป หรือคีย์ไม่ถูกต้องหรือไม่ใช้งาน — ตรวจสอบใน Wavix Console ด้วยการลงชื่อเข้าบัญชี: เซสชัน/โทเค็นของคุณหมดอายุหรือถูกเพิกถอน หรือการลงชื่อเข้าไม่เสร็จสมบูรณ์ — เชื่อมต่อใหม่และลงชื่อเข้าอีกครั้ง
เครื่องมือส่งคืน download_url ไม่ใช่ไฟล์เอง	เป็นที่คาดหวัง จุดสิ้นสุดการบันทึก speech-analytics และหลักฐาน 10DLC ส่งคืน URL ที่ลงนามล่วงหน้า (ดู การรับรองความถูกต้อง) ดึง URL โดยตรงโดยไม่ต้องใช้ส่วนหัว Authorization
ไคลเอนต์แสดงเพียงส่วนหนึ่งของแคตตาล็อก	ไคลเอนต์รุ่นเก่าบังคับขีดจำกัดเครื่องมือต่อเซิร์ฟเวอร์ อัปเกรด (Cursor 2.4+, VS Code ล่าสุด, Claude ล่าสุด)
มีเครื่องมือน้อยลงหลังลงชื่อเข้าด้วยบัญชี Wavix	เป็นที่คาดหวัง การลงชื่อเข้าบัญชีถูกกรองตามขอบเขต — คุณได้รับเครื่องมือที่ขอบเขตที่อนุมัติและบทบาทบัญชีอนุญาต ไม่ใช่แคตตาล็อกเต็ม การเชื่อมต่อด้วย API key จะเห็นพื้นผิวเครื่องมือทั้งหมด เพื่อขยายชุด อนุมัติขอบเขตเพิ่มเติมที่การลงชื่อเข้า (ขึ้นอยู่กับบทบาทของคุณ) หรือเชื่อมต่อด้วย API key ที่มีขอบเขตเหล่านั้น
Tool not found สำหรับเครื่องมือที่ระบุใน README นี้	ไคลเอนต์ท้องถิ่นอาจแคชรายการเครื่องมือเก่า รีสตาร์ทไคลเอนต์ หรือลบและเพิ่มเซิร์ฟเวอร์ใหม่
4xx พร้อมอาร์เรย์ errors	ข้อผิดพลาดการตรวจสอบจาก Wavix API ตรวจสอบ errors; อ้างอิงข้ามหน้า wavix://docs/* ที่เกี่ยวข้องหรือ OpenAPI spec
ไม่สามารถเข้าถึงเซิร์ฟเวอร์	ยืนยัน DNS และ HTTPS ขาออกไปยัง mcp.wavix.com:443
เอเจนต์เรียกเครื่องมือที่ทำลายล้างโดยไม่คาดคิด	ไคลเอนต์ส่วนใหญ่สามารถกำหนดให้ยืนยันก่อนเรียกเครื่องมือ — เปิดใช้งานการตั้งค่านั้นและหมุนเวียนไปยัง MCP API key เฉพาะ (ดู แนวทางปฏิบัติที่ดีที่สุด)

ความเข้ากันได้และข้อจำกัด

• เข้ากันได้กับไคลเอนต์ MCP ใด ๆ ที่รองรับการขนส่ง Streamable HTTP (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 spec พัฒนาขึ้น; เครื่องมือใหม่ปรากฏอัตโนมัติและอาร์กิวเมนต์เครื่องมือที่มีอยู่อาจเพิ่มฟิลด์ตัวเลือก การเปลี่ยนแปลงเอกสารสำหรับพื้นที่เก็บข้อมูลนี้ติดตามภายใต้ Releases สำหรับการเปลี่ยนแปลงพฤติกรรมที่สำคัญที่ส่งผลต่ออินพุตเครื่องมือหรือการรับรองความถูกต้อง เราจะเผยแพร่ประกาศทั้งที่นั่นและใน บันทึกการเผยแพร่ Wavix

การสนับสนุน

• เอกสารผลิตภัณฑ์: https://docs.wavix.com
• เอกสารอ้างอิง API: https://docs.wavix.com/api-reference
• คำถาม / ข้อเสนอแนะ: support@wavix.com

การมีส่วนร่วม

พื้นที่เก็บข้อมูลนี้ มีซอร์สให้ใช้งาน แต่ ไม่เปิดรับการมีส่วนร่วมจากภายนอก Pull requests ถูกปิดอัตโนมัติ และ Issues / Discussions ถูกปิดใช้งาน ส่งรายงานข้อบกพร่อง คำขอคุณสมบัติ และข้อเสนอแนะไปยัง support@wavix.com ดู CONTRIBUTING.md สำหรับรายละเอียด

หากคุณพบข้อบกพร่องในเฟรมเวิร์ก FastMCP พื้นฐาน โปรดรายงานต้นทางที่นั่น

ความปลอดภัย

เพื่อรายงานช่องโหว่ด้านความปลอดภัย โปรดส่งอีเมลไปยัง support@wavix.com ด้วยหัวข้อ Security: <short summary> แทนการเปิด issue สาธารณะ ดู SECURITY.md สำหรับรายละเอียด

สัญญาอนุญาต

MIT © Wavix