Voipstudio MCP Server

AI - 人工智慧 - VoIPstudio MCP 伺服器¶

VoIPstudio MCP（模型上下文協定）伺服器讓 Claude AI 能夠直接、安全地存取您的 VoIPstudio 帳戶資料，包括錄音、CDR、即時通話和語音信箱。連接後，Claude 可以查詢通話、分析模式、找出客服績效問題，並以淺顯的英文生成 QA 報告，無需任何客製化開發。

加入 CX 附加元件後，每筆錄音都會預先附帶逐字稿、摘要、情緒分析、行動項目和 CX 分數。這大幅減少了 Claude 需要進行的 AI 工作，讓您的 token 用量更低，成本也更可預測。

取得 API 金鑰¶

MCP 伺服器使用 VoIPstudio API 權杖進行驗證。每個金鑰都限定於特定使用者，因此 Claude 只能存取該使用者能夠存取的資料。

產生金鑰的步驟：

1. 在管理後台中，開啟您要為其產生權杖的使用者。
2. 前往 API Keys 區段。
3. 輸入金鑰的名稱 — 例如，Claude MCP。
4. 點擊 Add。
5. 點擊 眼睛圖示 以顯示 API 金鑰 / user_token。複製此值。
6. 若要檢視更多詳細資料或刪除金鑰，請點擊 齒輪圖示 並選擇 Show Details。

注意： API 金鑰只要至少每 7 天使用一次（預設逾時），就會持續有效。如有需要，在點擊 Add 之前設定更長的逾時時間（或無限期）。

請參閱 REST API 文件

連接到 Claude¶

VoIPstudio 目前未列在 Claude.ai 的連接器目錄中。您需要手動將其新增為自訂 MCP 伺服器。

MCP 伺服器 URL¶

MCP 伺服器 URL

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

步驟 (Claude.ai)¶

1. 在 Claude.ai 中，前往 Settings → Integrations（或連接器面板，取決於您的方案）。
2. 選擇 Add custom MCP server（或同等選項）。
3. 輸入上述的 MCP 伺服器 URL。
4. 當提示進行驗證時，提供您的 VoIPstudio API 金鑰。
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 平台¶

大多數支援外部 MCP 的 AI 平台都可以使用相同的 URL 和 API 金鑰連接到 VoIPstudio MCP 伺服器。確切的設定步驟會因平台而異。請在您平台的整合或設定中尋找標示為 external MCP server、custom MCP 或 remote MCP 的選項。

CX 附加元件¶

若沒有 CX 附加元件，錄音會以原始中繼資料的形式送達。Claude 必須自行轉錄和分析每通電話，每筆錄音都會消耗大量 token。

有了 CX 附加元件，VoIPstudio 會在其自身的基礎架構上處理轉錄、摘要、情緒分析、行動項目提取和 CX 評分，並以 固定的月費提供，沒有按通話計費的費用，也沒有轉錄限制。Claude 會收到已完成的智慧分析 — 可以立即進行推理。

無 CX 附加元件	有 CX 附加元件
逐字稿	Claude 必須擷取音訊並轉錄/翻譯	✓ 包含，已標示說話者
摘要	Claude 必須生成	✓ 包含
情緒	Claude 必須推斷	✓ 包含
行動項目	Claude 必須提取	✓ 包含
CX 分數	不提供	✓ 每通電話 1–10 分
約略 token/通話	10,000–15,000	300–500
成本模型	變動的 AI 支出	固定月費訂閱

CX 附加元件解鎖的欄位¶

欄位	類型	說明
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 附加元件後，每筆記錄都包含逐字稿、摘要、情緒、CX 分數和時間軸。若無附加元件，這些欄位會傳回 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 附加元件即可使用。

參數： 與 get_recordings 相同（filters、limit、page）

主要回應欄位

欄位	類型	說明
call_id	number	唯一的通話識別碼
calldate	string	通話開始時間戳記（UTC）
src_name	string	客服 / 來電者名稱
dst_name	string	目的地名稱
billsec	number	計費秒數
duration	number	包含響鈴的總秒數
disposition	string	CONNECTED、NO ANSWER、BUSY、FAILED
charge	number	通話費用
type	string	I \= 來電，O \= 去電
src_ua	string	來源裝置 / 軟體電話使用者代理
labels	array	在 VoIPstudio 中套用的自訂標籤

get_live_calls¶

傳回您帳戶上所有進行中通話的即時快照。無需任何參數。

範例： "目前有多少通電話正在進行中，哪些客服正在通話中？"

get_voicemails¶

擷取語音信箱訊息。與其他工具相同的 filters、limit 和 page 介面。

可篩選的主要欄位： src、dst、calldate、duration、listened

get_recording_audio¶

傳回特定錄音的 MP3 音訊的直接下載 URL。

參數： id（數字）— 來自 get_recordings 回應中的 id 欄位。

資訊

音訊 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 分鐘？"

Token 效率¶

在沒有 CX 附加元件的情況下，Claude 分析的每通電話都需要 Claude 處理音訊內容，並生成自己的轉錄和分析。CX 附加元件將這些工作完全卸載給 VoIPstudio：

VoIPstudio 處理的內容（固定月費，通話數不限）：

• 音訊轉錄
• 說話者標示
• 通話摘要
• 情緒分類
• 行動項目提取
• CX 評分

Claude 接收到的內容： 乾淨、結構化的文字欄位，可供推理、比較和報告。

這意味著您可以在單一工作階段中要求 Claude 分析數百通電話，而 token 成本僅為一小部分，使得大規模的 QA、趨勢分析和客服輔導報告變得可行，且無需擔心不可預測的 AI 支出。