Voipstudio MCP Server

AI - 人工智能 - VoIPstudio MCP 服务器¶

VoIPstudio MCP（模型上下文协议）服务器让 Claude AI 能够直接、安全地访问您的 VoIPstudio 账户数据，包括录音、通话详单、实时通话和语音邮件。连接后，Claude 可以查询通话、分析模式、发现客服绩效问题，并用通俗易懂的语言生成质检报告，无需任何定制开发。

添加 CX 插件后，每条录音都会预先附带转录文本、摘要、情感分析、行动项和 CX 评分。这大大减少了 Claude 需要处理的 AI 工作量，从而降低 token 消耗，使成本更可预测。

获取 API 密钥¶

MCP 服务器使用 VoIPstudio API 令牌进行身份验证。每个密钥都限定于特定用户，因此 Claude 只能访问该用户有权访问的数据。

生成密钥的步骤：

1. 在管理后台中，打开您要为其生成令牌的用户。
2. 进入 API 密钥 部分。
3. 输入密钥名称 — 例如，Claude MCP。
4. 点击 添加。
5. 点击 眼睛图标 显示 API 密钥 / user_token。复制此值。
6. 要查看更多详情或删除密钥，请点击 齿轮图标 并选择 显示详情。

注意： 只要 API 密钥每 7 天至少使用一次（默认超时时间），它就会保持有效。如有需要，可在点击添加前设置更长的超时时间（或无限期）。

查看 REST API 文档

连接到 Claude¶

VoIPstudio 目前未在 Claude.ai 连接器目录中列出。您需要手动将其添加为自定义 MCP 服务器。

MCP 服务器 URL¶

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	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	已接通、无应答、忙、失败
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 }
]

用例¶

客服质检报告¶

"给我本月每位客服的质检摘要 — CX 评分平均值、常见投诉主题，以及他们评分最低的三次通话及其摘要。"

呼叫中心通话量统计¶

"本周我们每天的通话量是多少？我们的平均处理时长是多少，有多少通话未接听？"

情感趋势分析¶

"与上个月相比，客户情感是在改善还是下降？哪些通话主题与负面情感相关？"

未接来电回访列表¶

"列出过去 24 小时内所有未接的呼入电话及其来电显示，以便我优先回拨。"

成本与账单审查¶

"本季度哪些分机产生了最昂贵的呼出通话？"

实时运营检查¶

"当前有多少客服正在通话中，是否有通话时长超过 20 分钟？"

Token 效率¶

在没有 CX 插件的情况下，Claude 分析每条通话都需要处理音频内容，并自行生成转录和分析。CX 插件将这些工作完全转移给 VoIPstudio：

VoIPstudio 处理的内容（固定月费，不限通话数）：

• 音频转录
• 说话人分离
• 通话摘要
• 情感分类
• 行动项提取
• CX 评分

Claude 接收到的内容： 干净、结构化的文本字段，可直接用于推理、比较和报告。

这意味着您可以让 Claude 在单个会话中分析数百条通话，而 token 成本仅为原来的零头，使大规模质检、趋势分析和客服辅导报告变得切实可行，且无需担心不可预测的 AI 支出。