Voipstudio MCP

AI — Искусственный интеллект — MCP-сервер VoIPstudio

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

Добавьте 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-сервера

[!info] 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, могут подключаться к MCP-серверу VoIPstudio, используя тот же 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	Уникальный идентификатор записи
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

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.

[!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 минут?»

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

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

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

• Расшифровка аудио
• Разделение по спикерам
• Составление сводок вызовов
• Классификация тональности
• Извлечение пунктов действий
• Оценка CX

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

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