Voipstudio MCP

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

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

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

获取 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

[!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 必须自行转写和分析每次通话，每条录音会消耗大量令牌。

使用 CX 插件后，VoIPstudio 会在其自身基础设施上处理转写、摘要、情感分析、行动提取和 CX 评分，按月固定收费，无按次通话费用，也无转写限制。Claude 收到的是成品情报 — 可立即进行推理分析。

	无 CX 插件	有 CX 插件
转写文本	Claude 必须获取音频并转写/翻译	✓ 已包含，带说话人分离
摘要	Claude 必须自行生成	✓ 已包含
情感分析	Claude 必须自行推断	✓ 已包含
行动项	Claude 必须自行提取	✓ 已包含
CX 评分	不可用	✓ 每次通话 1–10 分
每次通话约需令牌数	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 小时内所有未接的呼入电话及主叫号码，以便我优先安排回拨。”

成本与账单审查

“本季度哪些分机拨打了最昂贵的呼出电话？”

实时运营检查

“当前有多少客服在通话中？是否有通话已持续超过 20 分钟？”

令牌效率

没有 CX 插件时，Claude 分析的每次通话都需要 Claude 处理音频内容并自行生成转写和分析。CX 插件将这一切完全卸载到 VoIPstudio：

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

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

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

这意味着您可以要求 Claude 在单次会话中分析数百通通话，而令牌成本仅为原来的一小部分，使大规模 QA、趋势分析和客服辅导报告变得切实可行，而无需承担不可预测的 AI 支出。