Voipstudio MCP

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.comDùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với Voipstudio MCP?

Kéo bản ghi cuộc gọi với bộ lọc — Yêu cầu bản ghi theo ngày, đại lý hoặc điểm CX qua get_recordings, bao gồm cả bản ghi âm và tóm tắt khi CX Addon đang hoạt động.
Phân tích chi tiết bản ghi cuộc gọi — Sử dụng để lấy số liệu khối lượng, phân tích chi phí, phân bố thời lượng và tóm tắt hoạt động của đại lý.
Theo dõi cuộc gọi trực tiếp theo thời gian thực — Kiểm tra các cuộc gọi đang hoạt động và đại lý nào đang tham gia.
Truy xuất tin nhắn thư thoại — Lấy thư thoại với các bộ lọc như người gọi, ngày hoặc trạng thái đã nghe.
Nhận liên kết tải xuống âm thanh trực tiếp — Lấy URL MP3 có giới hạn thời gian cho các bản ghi cụ thể.

Tài liệu

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

Máy chủ MCP (Giao thức ngữ cảnh mô hình) VoIPstudio 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 đại lý và tạo báo cáo QA bằng tiếng Anh đơn giả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 bổ sung sẵn bản ghi chép, 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úp giảm mức sử dụng token và chi phí dễ dự đoán hơn.

Lấy khóa API

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

Để tạo khóa:

Trong bảng điều khiển quản trị, hãy mở người dùng mà bạn muốn tạo mã thông báo.
Đi tới phần API Keys.
Nhập tên cho khóa — ví dụ: Claude MCP.
Nhấp vào Add.
Nhấp vào 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, hãy nhấp vào biểu tượng bánh răng và chọn Show Details.

Lưu ý: Khóa API vẫn có hiệu lực 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 vào Add.

Xem Tài liệu API REST

Kết nối với Claude

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

URL máy chủ MCP

[!info] URL máy chủ MCP https://mcp.voipstudio.workers.dev/sse

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

Trong Claude.ai, đi tới Settings → Integrations (hoặc bảng trình 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, hãy cung cấp khóa API VoIPstudio của bạn.
Lưu và ủy quyền kết nối.

Claude giờ 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 vào Always allow để bỏ qua lời nhắc này trong các phiên tương lai.

API Anthropic (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ủ MCP VoIPstudio 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. Hãy 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.

CX Addon

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

Với CX Addon, VoIPstudio xử lý phiên âm, 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 của mình với chi phí hàng tháng cố định, không có phí mỗi cuộc gọi và không giới hạn phiên âm. Claude nhận được thông tin hoàn chỉnh — sẵn sàng để suy luận ngay lập tức.

	Không có CX Addon	Có CX Addon
Bản ghi chép	Claude phải tải âm thanh và phiên âm/dịch	✓ Bao gồm, có phân tách 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 khả dụng	✓ 1–10 cho mỗi cuộc gọi
Xấp xỉ token/cuộc gọi	10.000–15.000	300–500
Mô hình chi phí	Chi tiêu AI biến đổi	Đăng ký hàng tháng cố định

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

Trường	Loại	Mô tả
`transcript`	chuỗi	Bản ghi chép đầy đủ từng từ
`transcript_speakers`	đối tượng	Các phân đoạn bản ghi chép có phân tách người nói
`summary`	chuỗi	Tóm tắt ngắn gọn về kết quả cuộc gọi
`sentiment`	chuỗi	Cảm xúc khách hàng: `positive`, `neutral`, `negative`
`cx_score`	số (1–10)	Điểm trải nghiệm khách hàng
`metadata.timeline`	mảng	Các khoảnh khắc chính và mục hành động được trích xuất từ cuộc gọi

Tài liệu 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 trong", vì vậy dưới đây là hướng dẫn tham khảo cho 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 hoạt động, mỗi bản ghi bao gồm bản ghi chép, tóm tắt, cảm xúc, điểm CX và dòng thời gian. 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`	mảng	—	Đối tượng lọc — xem Lọc
`limit`	số	10	Bản ghi mỗi trang (tối đa 1000)
`page`	số	1	Số trang

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

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

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

Hỏi Claude: "Hiển thị cho tôi tất cả bản ghi âm từ tuần này có điểm CX dưới 6, nhóm theo đại lý, kèm 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 bố thời lượng và tóm tắt hoạt động của đại lý. Khả dụng 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`	số	Định danh cuộc gọi duy nhất
`calldate`	chuỗi	Dấu thời gian bắt đầu cuộc gọi (UTC)
`src_name`	chuỗi	Tên đại lý / người gọi
`dst_name`	chuỗi	Tên đích
`billsec`	số	Giây tính phí
`duration`	số	Tổng số giây bao gồm cả đổ chuông
`disposition`	chuỗi	`CONNECTED`, `NO ANSWER`, `BUSY`, `FAILED`
`charge`	số	Chi phí cuộc gọi
`type`	chuỗi	`I` \= gọi đến, `O` \= gọi đi
`src_ua`	chuỗi	Thiết bị nguồn / user-agent softphone
`labels`	mảng	Thẻ tùy chỉnh được áp dụng trong VoIPstudio

get_live_calls

Trả về ảnh chụp nhanh theo thời gian thực của tất 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 đại lý nào đang tham gia?"

get_voicemails

Tìm nạp tin nhắn thư thoại. Giao diện filters, limit và page tương tự 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 (số) — trường id từ phản hồi get_recordings.

[!info] Thông tin URL âm thanh có giới hạn thời gian. Sử dụ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ông cụ danh sách chấp nhận mảng filters tùy chọn. Mỗi đối tượng 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`)

Các 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 }]

Đại lý cụ thể

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

Chỉ các 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 }
]

Các trường hợp sử dụng

Tạo báo cáo QA

"Cung cấp cho tôi bản tóm tắt QA cho mỗi đại lý trong tháng này — điểm trung bình CX, 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 lâ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 khách hàng đang cải thiện hay suy giảm 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 bị bỏ lỡ

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

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

"Những extension 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 đại lý đang tham gia cuộc gọi và có cuộc gọi nào đã chạy quá 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 phiên âm và phân tích của riêng mình. CX Addon chuyển hoàn toàn việc này sang VoIPstudio:

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

Phiên âm âm thanh
Phân tách 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 sạch, có cấu trúc sẵn sàng để 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ỏ, giúp việc QA quy mô lớn, phân tích xu hướng và báo cáo huấn luyện đại lý trở nên thực tế mà không có chi tiêu AI không thể dự đoán.