Voipstudio MCP Server

ИИ — Искусственный интеллект — VoIPstudio MCP Server¶

Сервер VoIPstudio MCP (Model Context Protocol) предоставляет Claude AI прямой и безопасный доступ к данным вашего аккаунта VoIPstudio, включая записи, CDR, текущие звонки и голосовую почту. После подключения Claude может запрашивать звонки, анализировать закономерности, выявлять проблемы с производительностью агентов и генерировать отчёты по контролю качества на естественном языке без необходимости в разработке.

Добавьте CX Addon, и каждая запись будет поступать уже обогащённой транскриптом, кратким содержанием, тональностью, пунктами действий и оценкой CX. Это значительно сокращает объём работы, которую должен выполнять ИИ Claude, снижая расход токенов и делая затраты более предсказуемыми.

Получение API-ключа¶

Сервер MCP аутентифицируется с помощью API-токена VoIPstudio. Каждый ключ привязан к конкретному пользователю, поэтому 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.

URL сервера MCP¶

URL сервера MCP

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

Шаги (Claude.ai)¶

1. В Claude.ai перейдите в Settings → Integrations (или панель коннекторов, в зависимости от вашего тарифа).
2. Выберите Add custom MCP server (или аналогичный пункт).
3. Введите указанный выше URL сервера MCP.
4. При запросе аутентификации предоставьте ваш API-ключ VoIPstudio.
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"
    }]
  })
});

Подключение к другим ИИ-платформам¶

Большинство ИИ-платформ, поддерживающих внешние MCP, могут подключаться к серверу VoIPstudio MCP, используя тот же URL и API-ключ. Точные шаги настройки зависят от платформы. Ищите опцию с названием external MCP server, custom MCP или remote MCP в настройках интеграций вашей платформы.

CX Addon¶

Без CX Addon записи поступают в виде необработанных метаданных. Claude вынужден самостоятельно транскрибировать и анализировать каждый звонок, расходуя значительное количество токенов на запись.

С CX Addon VoIPstudio выполняет транскрипцию, суммаризацию, анализ тональности, извлечение действий и оценку CX на собственной инфраструктуре за фиксированную ежемесячную плату без платы за звонок и без ограничений на транскрипцию. Claude получает готовую аналитику, готовую к немедленному осмыслению.

Без CX Addon	С CX Addon
Транскрипт	Claude должен получить аудио и транскрибировать/перевести	✓ Включено, с диаризацией говорящих
Краткое содержание	Claude должен сгенерировать	✓ Включено
Тональность	Claude должен определить	✓ Включено
Пункты действий	Claude должен извлечь	✓ Включено
Оценка CX	Недоступно	✓ 1–10 по каждому звонку
Примерный расход токенов/звонок	10 000–15 000	300–500
Модель затрат	Переменные расходы на ИИ	Фиксированная ежемесячная подписка

Поля, доступные с CX Addon¶

Поле	Тип	Описание
transcript	string	Полный пословный транскрипт
transcript_speakers	object	Сегменты транскрипта с диаризацией говорящих
summary	string	Краткое резюме исхода звонка
sentiment	string	Тональность клиента: positive, neutral, negative
cx_score	number (1–10)	Оценка качества обслуживания
metadata.timeline	array	Ключевые моменты и пункты действий, извлечённые из звонка

Справочник инструментов¶

Простота интеграции MCP означает, что нет необходимости разбираться в сложных API, а простые запросы помогают ИИ-платформе осмыслить данные, предоставленные Voipstudio, и дать соответствующий ответ.

Однако некоторым технически подкованным пользователям может быть интересно, что происходит «под капотом», поэтому ниже приведён справочник по некоторым функциям сервера MCP.

get_recordings¶

Возвращает записи звонков. При активном CX Addon каждая запись включает транскрипт, краткое содержание, тональность, оценку CX и временную шкалу. Без аддона эти поля возвращают null.

Параметры

Параметр	Тип	По умолчанию	Описание
filters	array	—	Объекты фильтра — см. Фильтрация
limit	number	10	Записей на странице (макс. 1000)
page	number	1	Номер страницы

Поля ответа

Поле	Тип	Описание
id	number	Уникальный ID записи
call_id	number	Ссылка на call_id в CDR
timestamp	string	Начало записи (UTC, ГГГГ-ММ-ДД ЧЧ:мм:сс)
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¶

Call Detail Records – сырой журнал каждого плеча звонка. Используется для статистики объёмов, анализа затрат, распределения длительности и сводок по активности агентов. Доступно без CX Addon.

Параметры: такие же, как у 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	Устройство источника / user-agent софтфона
labels	array	Пользовательские метки, применённые в VoIPstudio

get_live_calls¶

Возвращает мгновенный снимок всех активных звонков на вашем аккаунте. Параметры не требуются.

Пример: "Сколько звонков сейчас в процессе и какие агенты на них?"

get_voicemails¶

Извлекает сообщения голосовой почты. Тот же интерфейс filters, limit и page, что и у других инструментов.

Ключевые фильтруемые поля: src, dst, calldate, duration, listened

get_recording_audio¶

Возвращает прямую ссылку для скачивания MP3-аудио конкретной записи.

Параметр: id (number) — поле id из ответа get_recordings.

Информация

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 минут?"

Эффективность использования токенов¶

Каждый звонок, анализируемый Claude без CX Addon, требует от Claude обработки аудиоконтента и генерации собственной транскрипции и анализа. CX Addon полностью перекладывает это на VoIPstudio:

Что VoIPstudio берёт на себя (фиксированная ежемесячная плата, неограниченное количество звонков):

• Транскрипция аудио
• Диаризация говорящих
• Суммаризация звонков
• Классификация тональности
• Извлечение пунктов действий
• Оценка CX

Что получает Claude: Чистые, структурированные текстовые поля, готовые для осмысления, сравнения и составления отчётов.

Это означает, что вы можете попросить Claude проанализировать сотни звонков за один сеанс за небольшую долю стоимости токенов, делая масштабный контроль качества, анализ трендов и отчёты по коучингу агентов практичными без непредсказуемых расходов на ИИ.