Voipstudio MCP

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

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

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

取得 API 金鑰

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

若要產生金鑰：

1. 在管理儀表板中，開啟您要為其產生 token 的使用者。
2. 前往 API 金鑰 區段。
3. 輸入金鑰名稱 — 例如，Claude MCP。
4. 按一下 新增。
5. 按一下 眼睛圖示 以顯示 API 金鑰 / user_token。複製此值。
6. 若要檢視更多詳細資料或刪除金鑰，請按一下 齒輪圖示，然後選取 顯示詳細資料。

注意： API 金鑰只要至少每 7 天使用一次（預設逾時），就會保持有效。如有需要，請在按一下「新增」之前設定較長的逾時時間（或設為無限制）。

請參閱 REST API 文件

連線至 Claude

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

MCP 伺服器 URL

[!info] MCP 伺服器 URL https://mcp.voipstudio.workers.dev/sse

步驟（Claude.ai）

1. 在 Claude.ai 中，前往 設定 → 整合（或連接器面板，視您的方案而定）。
2. 選擇 新增自訂 MCP 伺服器（或同等選項）。
3. 輸入上述 MCP 伺服器 URL。
4. 出現驗證提示時，提供您的 VoIPstudio API 金鑰。
5. 儲存並授權連線。

Claude 現在可以在任何對話中呼叫 VoIPstudio 工具。在會話中首次呼叫工具時，Claude 會要求您確認資料共用。按一下 一律允許 以在未來的會話中略過此提示。

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 伺服器。確切的設定步驟會因平台而異。請在您平台的整合或設定中尋找標示為 外部 MCP 伺服器、自訂 MCP 或 遠端 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	字串	完整的逐字逐句轉錄
transcript_speakers	物件	具備說話者分離的轉錄區段
summary	字串	通話結果的簡明摘要
sentiment	字串	客戶情緒：positive、neutral、negative
cx_score	數字（1–10）	客戶體驗評分
metadata.timeline	陣列	從通話中提取的關鍵時刻和行動項目

工具參考

MCP 整合的簡潔性意味著不需要理解複雜的 API，而是可以透過簡單的提示，讓 AI 平台理解 VoIPstudio 提供的資料，並回覆適當的回應。

不過，一些較技術性的使用者可能想知道「引擎蓋下」發生了什麼事，因此以下是 MCP 伺服器部分功能的參考指南。

get_recordings

傳回通話錄音。啟用 CX 附加元件後，每筆記錄都包含逐字稿、摘要、情緒分析、CX 評分和時間軸。若無附加元件，這些欄位會傳回 null。

參數

參數	類型	預設值	說明
filters	陣列	—	篩選物件 — 請參閱 篩選
limit	數字	10	每頁記錄數（最多 1000）
page	數字	1	頁碼

回應欄位

欄位	類型	說明
id	數字	唯一錄音 ID
call_id	數字	連結至 CDR call_id
timestamp	字串	錄音開始時間（UTC，YYYY-MM-DD HH:mm:ss）
caller	字串	發話方號碼
called	字串	受話方號碼
src_name	字串	客服人員名稱（來源）
dst_name	字串	目的地名稱
duration	數字	持續時間（秒）
type	字串	I \= 撥入，O \= 撥出
context	字串	通話情境（例如 LOCAL_USER、QUEUE）
transcript	字串	null
transcript_speakers	物件	null
summary	字串	null
sentiment	字串	null
cx_score	數字	null
metadata.timeline	陣列	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	數字	唯一通話識別碼
calldate	字串	通話開始時間戳記（UTC）
src_name	字串	客服人員 / 來電者名稱
dst_name	字串	目的地名稱
billsec	數字	可計費秒數
duration	數字	包含響鈴在內的總秒數
disposition	字串	CONNECTED、NO ANSWER、BUSY、FAILED
charge	數字	通話成本
type	字串	I \= 撥入，O \= 撥出
src_ua	字串	來源裝置 / 軟體電話使用者代理
labels	陣列	在 VoIPstudio 中套用的自訂標籤

get_live_calls

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

範例： 「目前有多少通話正在進行中，哪些客服人員正在通話中？」

get_voicemails

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

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

get_recording_audio

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

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

[!info] 資訊 音訊 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 支出。