ใช้ ThunderPhone เป็นเซิร์ฟเวอร์ MCP
ThunderPhone เปิดให้ใช้เซิร์ฟเวอร์ Model Context Protocol ที่:
https://api.thunderphone.com/v1/mcp
กำหนดค่าไคลเอ็นต์ MCP ให้ชี้ไปยังปลายทาง Streamable HTTP นั้น เพื่อให้ เอเจนต์และการโทรขององค์กรคุณพร้อมใช้งานเป็นเครื่องมือ ซึ่งเป็นทิศทางตรงข้ามกับ การเชื่อมต่อเซิร์ฟเวอร์ MCP ระยะไกลเข้ากับเอเจนต์เสียง:
| ทิศทาง | ผลลัพธ์ |
|---|---|
| เซิร์ฟเวอร์ MCP ระยะไกล → เอเจนต์ ThunderPhone | เอเจนต์เสียงของคุณสามารถเรียกใช้เครื่องมือของเซิร์ฟเวอร์ระยะไกลได้ |
| ThunderPhone → ไคลเอ็นต์ MCP ของคุณ | ไคลเอ็นต์ MCP ของคุณสามารถเรียกใช้เครื่องมือ ThunderPhone สำหรับเอเจนต์และการโทรได้ |
ยืนยันตัวตน
สร้างคีย์ sk_live_ ใน องค์กร → คีย์ แล้วส่งเป็นโทเค็น Bearer
ปลายทาง MCP รับคีย์ API ขององค์กร ไม่รับคุกกี้เซสชันของแดชบอร์ดหรือคีย์วิดเจ็ตที่เผยแพร่ได้
{
"mcpServers": {
"thunderphone": {
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer sk_live_YOUR_API_KEY"
}
}
}
}
เครื่องมือที่พร้อมใช้งาน
| เครื่องมือ | อาร์กิวเมนต์ | การทำงาน |
|---|---|---|
list_agents | ไม่มี | แสดงรายการเอเจนต์ขององค์กรพร้อม id ชื่อ ผลิตภัณฑ์ และเสียง |
get_agent | agent_id | ดึงข้อมูลเอเจนต์หนึ่งราย |
place_call | agent_id, from_number, to_number | โทรออกโดยใช้การตรวจสอบและเงื่อนไขการเรียกเก็บเงินเดียวกับปลายทางการโทร REST |
get_call | call_id | ดึงสถานะการโทร สรุปผล และคะแนน |
list_calls | limit ที่ระบุหรือไม่ก็ได้ (1–100) status ที่ระบุหรือไม่ก็ได้ | แสดงรายการการโทรล่าสุด |
get_call_transcript | call_id | ดึงบทสนทนาฉบับสมบูรณ์ของการโทร |
เครื่องมือทั้งหมดอยู่ภายใต้ขอบเขตขององค์กรที่ผูกกับคีย์ API id จาก องค์กรอื่นจะถือว่าไม่พร้อมใช้งาน
เมธอดโปรโตคอล
ปลายทางนี้ใช้เมธอด MCP JSON-RPC ที่จำเป็นสำหรับ ไคลเอ็นต์ Streamable HTTP:
initializenotifications/initializedtools/listtools/call
คุณสามารถตรวจสอบแค็ตตาล็อกเครื่องมือได้โดยตรง:
curl -X POST https://api.thunderphone.com/v1/mcp \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}'
เรียกใช้เครื่องมือด้วยชื่อและอาร์กิวเมนต์ของเครื่องมือนั้น:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "list_calls",
"arguments": { "limit": 20, "status": "completed" }
}
}
ผลลัพธ์ของเครื่องมือเป็นรายการเนื้อหาข้อความ MCP ความล้มเหลวของเครื่องมือจะส่งกลับใน
ผลลัพธ์พร้อม isError: true; เมธอด JSON-RPC ที่ไม่รู้จักจะส่งกลับข้อผิดพลาดของโปรโตคอล
โทรออกอย่างปลอดภัย
place_call ใช้กฎเดียวกับ
POST /v1/call: เอเจนต์และหมายเลขต้อง
เป็นขององค์กรที่ผูกกับคีย์ หมายเลขต้องมีสิทธิ์สำหรับการโทรออก
องค์กรต้องมียอดคงเหลือเพียงพอ และต้องดำเนินการยืนยันการโทรออกที่เกี่ยวข้องให้เสร็จสมบูรณ์
ให้ถือว่าไคลเอ็นต์ที่เข้าถึง place_call ได้เป็นผู้โทรในระบบใช้งานจริง จำกัดผู้ที่
สามารถใช้ไคลเอ็นต์ ระบุเอเจนต์และหมายเลขที่ต้องการให้ชัดเจนในพรอมต์ของไคลเอ็นต์
และตรวจสอบการโทรในประวัติการโทร
ข้อมูลอ้างอิงโครงสร้างข้อมูลฉบับสมบูรณ์
ดู API เซิร์ฟเวอร์ MCP สำหรับตัวอย่างการตอบกลับ ข้อผิดพลาด JSON-RPC และ API สำหรับจัดการเซิร์ฟเวอร์ระยะไกล