Voipstudio MCP Server

chính thức

Máy chủ MCP VoIPstudio cung cấp cho các trợ lý AI tương thích quyền truy cập an toàn vào dữ liệu tài khoản VoIPstudio được ủy quyền, bao gồm bản ghi âm, bản ghi chi tiết cuộc gọi, cuộc gọi trực tiếp và thư thoại để truy vấn hoạt động cuộc gọi, phân tích mẫu, xác định vấn đề hiệu suất của đại lý và tạo báo cáo QA hoặc vận hành bằng tiếng Anh đơn giản.

Xem trên voipstudio.com

Tài liệu

AI - Trí tuệ nhân tạo - Máy chủ VoIPstudio MCP¶

Máy chủ VoIPstudio MCP (Model Context Protocol) cung cấp cho Claude AI quyền truy cập trực tiếp, an toàn vào dữ liệu tài khoản VoIPstudio của bạn, bao gồm bản ghi âm, CDR, cuộc gọi trực tiếp và thư thoại. Sau khi kết nối, Claude có thể truy vấn cuộc gọi, phân tích mẫu, phát hiện vấn đề hiệu suất của nhân viên và tạo báo cáo QA bằng ngôn ngữ tự nhiên mà không cần phát triển tùy chỉnh.

Thêm CX Addon và mỗi bản ghi âm sẽ được làm giàu sẵn với bản chép lời, tóm tắt, cảm xúc, mục hành động và điểm CX. Điều này giảm đáng kể công việc AI mà Claude cần thực hiện, giữ mức sử dụng token thấp và chi phí dễ dự đoán hơn.

Lấy khóa API¶

Máy chủ MCP xác thực bằng token API VoIPstudio. Mỗi khóa được giới hạn phạm vi cho một người dùng cụ thể, vì vậy Claude sẽ chỉ có thể truy cập dữ liệu mà người dùng đó có thể truy cập.

Để tạo khóa:

Trong bảng điều khiển quản trị, mở người dùng bạn muốn tạo token.
Đi đến phần API Keys.
Nhập tên cho khóa — ví dụ: Claude MCP.
Nhấp Add.
Nhấp biểu tượng con mắt để hiển thị khóa API / user_token. Sao chép giá trị này.
Để xem thêm chi tiết hoặc xóa khóa, nhấp biểu tượng bánh răng và chọn Show Details.

Lưu ý: Khóa API vẫn hợp lệ miễn là nó được sử dụng ít nhất một lần mỗi 7 ngày (thời gian chờ mặc định). Đặt thời gian chờ dài hơn (hoặc không giới hạn) nếu cần trước khi nhấp Add.

Xem tài liệu REST API

Kết nối với Claude¶

VoIPstudio hiện chưa được liệt kê trong thư mục kết nối Claude.ai. Bạn thêm nó thủ công như một máy chủ MCP tùy chỉnh.

URL máy chủ MCP¶

URL máy chủ MCP

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

Các bước (Claude.ai)¶

Trong Claude.ai, đi đến Settings → Integrations (hoặc bảng kết nối, tùy thuộc vào gói của bạn).
Chọn Add custom MCP server (hoặc tương đương).
Nhập URL máy chủ MCP ở trên.
Khi được nhắc xác thực, cung cấp khóa API VoIPstudio của bạn.
Lưu và ủy quyền kết nối.

Claude hiện có thể gọi các công cụ VoIPstudio trong bất kỳ cuộc trò chuyện nào. Lần đầu tiên một công cụ được gọi trong phiên, Claude sẽ yêu cầu bạn xác nhận chia sẻ dữ liệu. Nhấp Always allow để bỏ qua lời nhắc này trong các phiên sau.

Anthropic API (dành cho nhà phát triển)¶


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"
    }]
  })
});

Kết nối với các nền tảng AI khác¶

Hầu hết các nền tảng AI hỗ trợ MCP bên ngoài đều có thể kết nối với máy chủ VoIPstudio MCP bằng cùng URL và khóa API. Các bước cấu hình chính xác sẽ khác nhau tùy theo nền tảng. Tìm tùy chọn có nhãn external MCP server, custom MCP, hoặc remote MCP trong phần tích hợp hoặc cài đặt của nền tảng của bạn.

CX Addon¶

Nếu không có CX Addon, bản ghi âm đến dưới dạng siêu dữ liệu thô. Claude phải tự chép lời và phân tích từng cuộc gọi, tiêu tốn token đáng kể cho mỗi bản ghi.

Với CX Addon, VoIPstudio xử lý việc chép lời, tóm tắt, phân tích cảm xúc, trích xuất hành động và chấm điểm CX trên cơ sở hạ tầng riêng với chi phí cố định hàng tháng, không có phí mỗi cuộc gọi và không giới hạn chép lời. Claude nhận được thông tin tình báo đã hoàn chỉnh — sẵn sàng để suy luận ngay lập tức.

Không có CX Addon	Với CX Addon
Bản chép lời	Claude phải lấy âm thanh và chép lời/dịch	✓ Bao gồm, phân biệt người nói
Tóm tắt	Claude phải tạo	✓ Bao gồm
Cảm xúc	Claude phải suy luận	✓ Bao gồm
Mục hành động	Claude phải trích xuất	✓ Bao gồm
Điểm CX	Không có sẵn	✓ 1–10 trên mỗi cuộc gọi
Token/cuộc gọi xấp xỉ	10.000–15.000	300–500
Mô hình chi phí	Chi tiêu AI biến đổi	Đăng ký cố định hàng tháng

Các trường được mở khóa bởi CX Addon¶

Trường	Loại	Mô tả
transcript	string	Bản chép lời cấp độ từ đầy đủ
transcript_speakers	object	Phân đoạn bản chép lời phân biệt người nói
summary	string	Tóm tắt ngắn gọn về kết quả cuộc gọi
sentiment	string	Cảm xúc khách hàng: tích cực, trung tính, tiêu cực
cx_score	number (1–10)	Điểm trải nghiệm khách hàng
metadata.timeline	array	Các khoảnh khắc chính và mục hành động được trích xuất từ cuộc gọi

Tham khảo Công cụ¶

Sự đơn giản của tích hợp MCP có nghĩa là các API phức tạp không cần phải hiểu và thay vào đó, các lời nhắc đơn giản có thể giúp nền tảng AI hiểu dữ liệu được cung cấp từ Voipstudio và trả lời với phản hồi phù hợp.

Tuy nhiên, một số người dùng kỹ thuật hơn có thể muốn biết điều gì đang xảy ra "bên dưới", vì vậy dưới đây là hướng dẫn tham khảo về một số chức năng của máy chủ MCP.

get_recordings¶

Trả về bản ghi âm cuộc gọi. Với CX Addon đang hoạt động, mỗi bản ghi bao gồm bản chép lời, tóm tắt, cảm xúc, điểm CX và dòng thời gian. Nếu không có addon, các trường này trả về null.

Tham số

Tham số	Loại	Mặc định	Mô tả
filters	array	—	Đối tượng bộ lọc — xem Lọc
limit	number	10	Bản ghi mỗi trang (tối đa 1000)
page	number	1	Số trang

Các trường phản hồi

Trường	Loại	Mô tả
id	number	ID bản ghi duy nhất
call_id	number	Liên kết đến call_id CDR
timestamp	string	Bắt đầu ghi âm (UTC, YYYY-MM-DD HH:mm:ss)
caller	string	Số bên gọi
called	string	Số bên được gọi
src_name	string	Tên nhân viên (nguồn)
dst_name	string	Tên đích
duration	number	Thời lượng tính bằng giây
type	string	I \= đến, O \= đi
context	string	Ngữ cảnh cuộc gọi (ví dụ: LOCAL_USER, QUEUE)
transcript	string	null
transcript_speakers	object	null
summary	string	null
sentiment	string	null
cx_score	number	null
metadata.timeline	array	null

Ví dụ – Điểm CX thấp tuần này

Hỏi Claude: "Hiển thị tất cả bản ghi âm từ tuần này có điểm CX dưới 6, được nhóm theo nhân viên, với tóm tắt về những gì đã sai trong mỗi cuộc gọi."

Claude gọi công cụ với:

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

get_cdrs¶

Bản ghi chi tiết cuộc gọi – nhật ký thô của mỗi chặng cuộc gọi. Sử dụng cho thống kê khối lượng, phân tích chi phí, phân phối thời lượng và tóm tắt hoạt động của nhân viên. Có sẵn mà không cần CX Addon.

Tham số: giống như get_recordings (filters, limit, page)

Các trường phản hồi chính

Trường	Loại	Mô tả
call_id	number	Định danh cuộc gọi duy nhất
calldate	string	Dấu thời gian bắt đầu cuộc gọi (UTC)
src_name	string	Tên nhân viên / người gọi
dst_name	string	Tên đích
billsec	number	Giây tính cước
duration	number	Tổng số giây bao gồm đổ chuông
disposition	string	CONNECTED, NO ANSWER, BUSY, FAILED
charge	number	Chi phí cuộc gọi
type	string	I \= đến, O \= đi
src_ua	string	Thiết bị nguồn / user-agent softphone
labels	array	Thẻ tùy chỉnh được áp dụng trong VoIPstudio

get_live_calls¶

Trả về ảnh chụp nhanh thời gian thực của tất cả các cuộc gọi đang hoạt động trên tài khoản của bạn. Không yêu cầu tham số.

Ví dụ: "Có bao nhiêu cuộc gọi đang diễn ra ngay bây giờ và những nhân viên nào đang tham gia?"

get_voicemails¶

Lấy tin nhắn thư thoại. Cùng giao diện filters, limit và page như các công cụ khác.

Các trường có thể lọc chính: src, dst, calldate, duration, listened

get_recording_audio¶

Trả về URL tải xuống trực tiếp cho âm thanh MP3 của một bản ghi cụ thể.

Tham số: id (number) — trường id từ phản hồi get_recordings.

Thông tin

URL âm thanh có giới hạn thời gian. Sử dụng chúng kịp thời; không lưu trữ trong thời gian dài.

Lọc & Phân trang¶

Tất cả các công cụ danh sách chấp nhận một mảng filters tùy chọn. Mỗi đối tượng bộ lọc có ba thuộc tính:

Thuộc tính	Mô tả
property	Tên trường để lọc (ví dụ: calldate, cx_score, src_name)
operator	eq, ne, lt, lte, gt, gte, in, like, notlike
value	Chuỗi, số hoặc mảng (cho toán tử in)

Ví dụ phổ biến¶

Phạm vi ngày

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

Ngưỡng điểm CX

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

Nhân viên cụ thể

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

Chỉ cuộc gọi đã kết nối

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

Cuộc gọi đến trên 5 phút

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

Trường hợp sử dụng¶

Báo cáo QA nhân viên¶

"Cho tôi tóm tắt QA cho mỗi nhân viên tháng này — điểm CX trung bình, chủ đề khiếu nại phổ biến và ba cuộc gọi có điểm thấp nhất của họ kèm tóm tắt."

Thống kê khối lượng trung tâm cuộc gọi¶

"Khối lượng cuộc gọi của chúng tôi theo ngày trong tuần này là bao nhiêu? Thời gian xử lý trung bình của chúng tôi là bao nhiêu và có bao nhiêu cuộc gọi không được trả lời?"

Phân tích xu hướng cảm xúc¶

"Cảm xúc của khách hàng đang cải thiện hay giảm sút so với tháng trước? Chủ đề cuộc gọi nào tương quan với cảm xúc tiêu cực?"

Danh sách theo dõi cuộc gọi nhỡ¶

"Liệt kê tất cả các cuộc gọi đến bị nhỡ trong 24 giờ qua với ID người gọi, để tôi có thể ưu tiên gọi lại."

Đánh giá chi phí & thanh toán¶

"Máy nhánh nào đã thực hiện các cuộc gọi đi đắt nhất trong quý này?"

Kiểm tra hoạt động trực tiếp¶

"Có bao nhiêu nhân viên hiện đang gọi và có cuộc gọi nào đã kéo dài hơn 20 phút không?"

Hiệu quả Token¶

Mỗi cuộc gọi Claude phân tích mà không có CX Addon yêu cầu Claude xử lý nội dung âm thanh và tạo bản chép lời và phân tích riêng. CX Addon chuyển hoàn toàn việc này cho VoIPstudio:

Những gì VoIPstudio xử lý (chi phí cố định hàng tháng, cuộc gọi không giới hạn):

Chép lời âm thanh
Phân biệt người nói
Tóm tắt cuộc gọi
Phân loại cảm xúc
Trích xuất mục hành động
Chấm điểm CX

Những gì Claude nhận được: Các trường văn bản có cấu trúc, sạch sẽ sẵn sàng cho suy luận, so sánh và báo cáo.

Điều này có nghĩa là bạn có thể yêu cầu Claude phân tích hàng trăm cuộc gọi trong một phiên duy nhất với chi phí token chỉ bằng một phần nhỏ, làm cho QA quy mô lớn, phân tích xu hướng và báo cáo huấn luyện nhân viên trở nên thực tế mà không có chi tiêu AI không thể đoán trước.