Voipstudio MCP Server

AI - ปัญญาประดิษฐ์ - เซิร์ฟเวอร์ Voipstudio MCP¶

เซิร์ฟเวอร์ Voipstudio MCP (Model Context Protocol) ให้ Claude AI เข้าถึงข้อมูลบัญชี Voipstudio ของคุณได้โดยตรงและปลอดภัย รวมถึงบันทึกการสนทนา, CDR, สายสนทนาสด และข้อความเสียง เมื่อเชื่อมต่อแล้ว Claude สามารถสอบถามสายสนทนา วิเคราะห์รูปแบบ ระบุปัญหาด้านประสิทธิภาพของเจ้าหน้าที่ และสร้างรายงาน QA เป็นภาษาอังกฤษ โดยไม่ต้องมีการพัฒนาแบบกำหนดเองใดๆ

เพิ่ม CX Addon แล้วแต่ละบันทึกจะมาพร้อมกับบทถอดเสียง บทสรุป ความรู้สึก รายการสิ่งที่ต้องดำเนินการ และคะแนน CX ที่เตรียมไว้ล่วงหน้า ซึ่งช่วยลดงาน AI ที่ Claude ต้องทำลงอย่างมาก และทำให้การใช้โทเค็นของคุณต่ำลงและค่าใช้จ่ายคาดการณ์ได้มากขึ้น

การขอรับ API key¶

เซิร์ฟเวอร์ MCP ตรวจสอบสิทธิ์โดยใช้โทเค็น API ของ Voipstudio แต่ละคีย์จะถูกกำหนดขอบเขตให้กับผู้ใช้เฉพาะราย ดังนั้น Claude จะสามารถเข้าถึงได้เฉพาะข้อมูลที่ผู้ใช้รายนั้นสามารถเข้าถึงได้

วิธีสร้างคีย์:

1. ในแดชบอร์ดผู้ดูแลระบบ เปิดผู้ใช้ที่คุณต้องการสร้างโทเค็นให้
2. ไปที่ส่วน API Keys
3. ป้อนชื่อสำหรับคีย์ — ตัวอย่างเช่น Claude MCP
4. คลิก Add
5. คลิก ไอคอนรูปตา เพื่อแสดง API key / user_token คัดลอกค่านี้
6. หากต้องการดูรายละเอียดเพิ่มเติมหรือลบคีย์ ให้คลิก ไอคอนรูปเฟือง และเลือก Show Details

หมายเหตุ: API key จะยังคงใช้งานได้ตราบเท่าที่มีการใช้งานอย่างน้อยหนึ่งครั้งทุก 7 วัน (ระยะหมดเวลาเริ่มต้น) ตั้งค่าระยะหมดเวลาให้นานขึ้น (หรือไม่จำกัด) หากจำเป็นก่อนคลิก Add

ดูเอกสาร REST API

การเชื่อมต่อกับ Claude¶

ขณะนี้ Voipstudio ยังไม่อยู่ในรายชื่อไดเรกทอรีตัวเชื่อมต่อ Claude.ai คุณสามารถเพิ่มด้วยตนเองเป็นเซิร์ฟเวอร์ MCP แบบกำหนดเอง

URL เซิร์ฟเวอร์ MCP¶

URL เซิร์ฟเวอร์ MCP

https://mcp.voipstudio.workers.dev/sse

ขั้นตอน (Claude.ai)¶

1. ใน Claude.ai ไปที่ Settings → Integrations (หรือแผงตัวเชื่อมต่อ ขึ้นอยู่กับแผนของคุณ)
2. เลือก Add custom MCP server (หรือเทียบเท่า)
3. ป้อน URL เซิร์ฟเวอร์ MCP ด้านบน
4. เมื่อได้รับแจ้งให้ตรวจสอบสิทธิ์ ให้ระบุ API key ของ Voipstudio
5. บันทึกและอนุญาตการเชื่อมต่อ

ขณะนี้ Claude สามารถเรียกใช้เครื่องมือ Voipstudio ในการสนทนาใดๆ ได้ ครั้งแรกที่มีการเรียกใช้เครื่องมือในเซสชัน Claude จะขอให้คุณยืนยันการแชร์ข้อมูล คลิก Always allow เพื่อข้ามข้อความแจ้งนี้ในเซสชันถัดไป

Anthropic API (สำหรับนักพัฒนา)¶

const response = await fetch("https://api.anthropic.com/v1/messages", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": "YOUR_ANTHROPIC_API_KEY"
  },
  body: JSON.stringify({
    model: "claude-sonnet-4-6",
    max_tokens: 1024,
    mcp_servers: [{
      type: "url",
      url: "https://mcp.voipstudio.workers.dev/sse",
      name: "voipstudio",
      authorization_token: "YOUR_VOIPSTUDIO_API_KEY"
    }],
    messages: [{
      role: "user",
      content: "Show me agents with a CX score below 6 this week"
    }]
  })
});

การเชื่อมต่อกับแพลตฟอร์ม AI อื่นๆ¶

แพลตฟอร์ม AI ส่วนใหญ่ที่รองรับ MCP ภายนอกสามารถเชื่อมต่อกับเซิร์ฟเวอร์ Voipstudio MCP ได้โดยใช้ URL และ API key เดียวกัน ขั้นตอนการกำหนดค่าที่แน่นอนจะแตกต่างกันไปตามแพลตฟอร์ม มองหาตัวเลือกที่มีป้ายกำกับว่า external MCP server, custom MCP หรือ remote MCP ในการตั้งค่าหรือการผสานรวมของแพลตฟอร์มของคุณ

CX Addon¶

หากไม่มี CX Addon บันทึกจะมาในรูปแบบข้อมูลดิบ Claude ต้องถอดเสียงและวิเคราะห์แต่ละสายเอง ซึ่งใช้โทเค็นจำนวนมากต่อบันทึก

ด้วย CX Addon นั้น Voipstudio จะจัดการการถอดเสียง การสรุปความ การวิเคราะห์ความรู้สึก การแยกการดำเนินการ และการให้คะแนน CX บนโครงสร้างพื้นฐานของตนเองใน ราคาคงที่รายเดือนโดยไม่มีค่าธรรมเนียมต่อสายและไม่มีข้อจำกัดในการถอดเสียง Claude ได้รับข้อมูลอัจฉริยะที่เสร็จสมบูรณ์ — พร้อมที่จะให้เหตุผลได้ทันที

ไม่มี CX Addon	มี CX Addon
บทถอดเสียง	Claude ต้องดึงเสียงและถอดเสียง/แปล	✓ รวมอยู่แล้ว แยกผู้พูด
บทสรุป	Claude ต้องสร้าง	✓ รวมอยู่แล้ว
ความรู้สึก	Claude ต้องอนุมาน	✓ รวมอยู่แล้ว
รายการสิ่งที่ต้องดำเนินการ	Claude ต้องแยก	✓ รวมอยู่แล้ว
คะแนน CX	ไม่พร้อมใช้งาน	✓ 1–10 ในทุกสาย
โทเค็นโดยประมาณ/สาย	10,000–15,000	300–500
รูปแบบค่าใช้จ่าย	ค่าใช้จ่าย AI ผันแปร	สมัครสมาชิกรายเดือนคงที่

ฟิลด์ที่ปลดล็อคโดย CX Addon¶

ฟิลด์	ประเภท	คำอธิบาย
transcript	string	บทถอดเสียงระดับคำเต็มรูปแบบ
transcript_speakers	object	ส่วนบทถอดเสียงที่แยกผู้พูด
summary	string	บทสรุปโดยย่อของผลลัพธ์การสนทนา
sentiment	string	ความรู้สึกของลูกค้า: บวก, เป็นกลาง, ลบ
cx_score	number (1–10)	คะแนนประสบการณ์ลูกค้า
metadata.timeline	array	ช่วงเวลาสำคัญและรายการสิ่งที่ต้องดำเนินการที่แยกจากการสนทนา

ข้อมูลอ้างอิงเครื่องมือ¶

ความเรียบง่ายของการผสานรวม MCP หมายความว่าไม่จำเป็นต้องเข้าใจ API ที่ซับซ้อน และในทางกลับกัน พรอมต์ง่ายๆ สามารถช่วยให้แพลตฟอร์ม AI ทำความเข้าใจข้อมูลที่ให้มาจาก Voipstudio และตอบกลับด้วยการตอบสนองที่เหมาะสม

อย่างไรก็ตาม ผู้ใช้ที่มีความเชี่ยวชาญด้านเทคนิคมากขึ้นอาจต้องการทราบว่าเกิดอะไรขึ้น "เบื้องหลัง" ดังนั้นด้านล่างนี้คือคู่มืออ้างอิงสำหรับฟังก์ชันเซิร์ฟเวอร์ MCP บางส่วน

get_recordings¶

ส่งคืนบันทึกการสนทนา เมื่อเปิดใช้งาน CX Addon แต่ละระเบียนจะรวมบทถอดเสียง บทสรุป ความรู้สึก คะแนน CX และไทม์ไลน์ หากไม่มี Addon ฟิลด์เหล่านี้จะส่งคืน null

พารามิเตอร์

พารามิเตอร์	ประเภท	ค่าเริ่มต้น	คำอธิบาย
filters	array	—	ออบเจ็กต์ตัวกรอง — ดูการกรอง
limit	number	10	ระเบียนต่อหน้า (สูงสุด 1000)
page	number	1	หมายเลขหน้า

ฟิลด์การตอบสนอง

ฟิลด์	ประเภท	คำอธิบาย
id	number	ID บันทึกที่ไม่ซ้ำกัน
call_id	number	เชื่อมโยงกับ CDR call_id
timestamp	string	การบันทึกเริ่มต้น (UTC, YYYY-MM-DD HH:mm:ss)
caller	string	หมายเลขฝ่ายที่โทร
called	string	หมายเลขฝ่ายที่ถูกรับสาย
src_name	string	ชื่อเจ้าหน้าที่ (ต้นทาง)
dst_name	string	ชื่อปลายทาง
duration	number	ระยะเวลาเป็นวินาที
type	string	I \= ขาเข้า, O \= ขาออก
context	string	บริบทการโทร (เช่น LOCAL_USER, QUEUE)
transcript	string	null
transcript_speakers	object	null
summary	string	null
sentiment	string	null
cx_score	number	null
metadata.timeline	array	null

ตัวอย่าง – คะแนน CX ต่ำในสัปดาห์นี้

ถาม Claude: "แสดงบันทึกทั้งหมดจากสัปดาห์นี้ที่มีคะแนน CX ต่ำกว่า 6 ให้ฉันดู โดยจัดกลุ่มตามเจ้าหน้าที่ พร้อมบทสรุปของสิ่งที่ผิดพลาดในแต่ละสาย"

Claude เรียกใช้เครื่องมือด้วย:

{
  "filters": [
    { "property": "calldate", "operator": "gte", "value": "2026-06-09 00:00:00" },
    { "property": "cx_score",  "operator": "lt",  "value": 6 }
  ],
  "limit": 100
}

get_cdrs¶

บันทึกรายละเอียดการโทร – บันทึกดิบของทุกขาการโทร ใช้สำหรับสถิติปริมาณ การวิเคราะห์ค่าใช้จ่าย การกระจายระยะเวลา และสรุปกิจกรรมของเจ้าหน้าที่ พร้อมใช้งานโดยไม่มี CX Addon

พารามิเตอร์: เช่นเดียวกับ get_recordings (filters, limit, page)

ฟิลด์การตอบสนองที่สำคัญ

ฟิลด์	ประเภท	คำอธิบาย
call_id	number	ตัวระบุการโทรที่ไม่ซ้ำกัน
calldate	string	การประทับเวลาเริ่มต้นการโทร (UTC)
src_name	string	ชื่อเจ้าหน้าที่ / ผู้โทร
dst_name	string	ชื่อปลายทาง
billsec	number	วินาทีที่คิดเงินได้
duration	number	วินาทีทั้งหมดรวมการส่งเสียงเรียก
disposition	string	เชื่อมต่อแล้ว, ไม่มีผู้รับสาย, ไม่ว่าง, ล้มเหลว
charge	number	ค่าใช้จ่ายในการโทร
type	string	I \= ขาเข้า, O \= ขาออก
src_ua	string	อุปกรณ์ต้นทาง / ซอฟต์โฟน user-agent
labels	array	แท็กแบบกำหนดเองที่ใช้ใน Voipstudio

get_live_calls¶

ส่งคืนสแนปชอตแบบเรียลไทม์ของสายสนทนาที่ใช้งานอยู่ทั้งหมดในบัญชีของคุณ ไม่จำเป็นต้องมีพารามิเตอร์

ตัวอย่าง: "ขณะนี้มีสายสนทนาที่กำลังดำเนินการอยู่กี่สาย และเจ้าหน้าที่คนใดบ้างที่อยู่ในสายเหล่านั้น"

get_voicemails¶

ดึงข้อความเสียง อินเทอร์เฟซ filters, limit และ page เช่นเดียวกับเครื่องมืออื่นๆ

ฟิลด์ที่กรองได้ที่สำคัญ: src, dst, calldate, duration, listened

get_recording_audio¶

ส่งคืน URL ดาวน์โหลดโดยตรงสำหรับเสียง MP3 ของการบันทึกเฉพาะ

พารามิเตอร์: id (number) — ฟิลด์ id จากการตอบสนอง get_recordings

ข้อมูล

URL เสียงมีเวลาจำกัด ใช้ทันที อย่าแคชเป็นระยะเวลานาน

การกรอง & การแบ่งหน้า¶

เครื่องมือรายการทั้งหมดยอมรับอาร์เรย์ filters ที่เป็นทางเลือก แต่ละออบเจ็กต์ตัวกรองมีคุณสมบัติสามประการ:

คุณสมบัติ	คำอธิบาย
property	ชื่อฟิลด์ที่จะกรอง (เช่น calldate, cx_score, src_name)
operator	eq, ne, lt, lte, gt, gte, in, like, notlike
value	สตริง, ตัวเลข หรืออาร์เรย์ (สำหรับตัวดำเนินการ in)

ตัวอย่างทั่วไป¶

ช่วงวันที่

[
  { "property": "calldate", "operator": "gte", "value": "2026-06-01 00:00:00" },
  { "property": "calldate", "operator": "lte", "value": "2026-06-30 23:59:59" }
]

เกณฑ์คะแนน CX

[{ "property": "cx_score", "operator": "gte", "value": 8 }]

เจ้าหน้าที่เฉพาะ

[{ "property": "src_name", "operator": "eq", "value": "Jane Ryder" }]

เฉพาะสายที่เชื่อมต่อแล้ว

[{ "property": "disposition", "operator": "eq", "value": "CONNECTED" }]

สายขาเข้าที่นานกว่า 5 นาที

[
  { "property": "type",     "operator": "eq",  "value": "I" },
  { "property": "billsec",  "operator": "gt",  "value": 300 }
]

กรณีการใช้งาน¶

รายงาน QA ของเจ้าหน้าที่¶

"ให้สรุป QA สำหรับเจ้าหน้าที่แต่ละคนในเดือนนี้ — ค่าเฉลี่ยคะแนน CX, หัวข้อข้อร้องเรียนทั่วไป และสายที่มีคะแนนต่ำสุดสามสายพร้อมบทสรุป"

สถิติปริมาณคอลเซ็นเตอร์¶

"ปริมาณการโทรของเราในแต่ละวันในสัปดาห์นี้เป็นเท่าใด เวลาจัดการเฉลี่ยของเราคือเท่าใด และมีสายที่ไม่ได้รับสายกี่สาย"

การวิเคราะห์แนวโน้มความรู้สึก¶

"ความรู้สึกของลูกค้าดีขึ้นหรือแย่ลงเมื่อเทียบกับเดือนที่แล้ว หัวข้อการโทรใดที่สัมพันธ์กับความรู้สึกเชิงลบ"

รายการติดตามผลสายที่ไม่ได้รับ¶

"แสดงรายการสายขาเข้าที่ไม่ได้รับทั้งหมดจาก 24 ชั่วโมงที่ผ่านมาพร้อม ID ผู้โทร เพื่อให้ฉันจัดลำดับความสำคัญในการโทรกลับ"

การตรวจสอบค่าใช้จ่ายและการเรียกเก็บเงิน¶

"หมายเลขภายในใดที่โทรออกขาออกที่มีค่าใช้จ่ายสูงที่สุดในไตรมาสนี้"

การตรวจสอบการดำเนินงานสด¶

"ขณะนี้มีเจ้าหน้าที่กี่คนที่กำลังอยู่ในสาย และมีสายใดที่ดำเนินการนานกว่า 20 นาทีหรือไม่"

ประสิทธิภาพของโทเค็น¶

แต่ละสายที่ Claude วิเคราะห์โดยไม่มี CX Addon นั้นต้องการให้ Claude ประมวลผลเนื้อหาเสียงและสร้างการถอดเสียงและการวิเคราะห์ของตนเอง CX Addon จะถ่ายโอนงานนี้ทั้งหมดไปยัง Voipstudio:

สิ่งที่ Voipstudio จัดการ (ค่าใช้จ่ายรายเดือนคงที่, ไม่จำกัดสาย):

• การถอดเสียง
• การแยกผู้พูด
• การสรุปการโทร
• การจำแนกความรู้สึก
• การแยกรายการสิ่งที่ต้องดำเนินการ
• การให้คะแนน CX

สิ่งที่ Claude ได้รับ: ฟิลด์ข้อความที่มีโครงสร้างสะอาด พร้อมสำหรับการให้เหตุผล การเปรียบเทียบ และการรายงาน

ซึ่งหมายความว่าคุณสามารถขอให้ Claude วิเคราะห์สายหลายร้อยสายในเซสชันเดียวด้วยต้นทุนโทเค็นเพียงเล็กน้อย ทำให้การทำ QA ขนาดใหญ่ การวิเคราะห์แนวโน้ม และรายงานการฝึกสอนเจ้าหน้าที่เป็นไปได้จริงโดยไม่มีค่าใช้จ่าย AI ที่คาดเดาไม่ได้