Voipstudio MCP

IA - Inteligência Artificial - Servidor MCP VoIPstudio

O servidor MCP (Model Context Protocol) da VoIPstudio dá ao Claude AI acesso direto e seguro aos dados da sua conta VoIPstudio, incluindo gravações, CDRs, chamadas ao vivo e caixas postais. Uma vez conectado, o Claude pode consultar chamadas, analisar padrões, identificar problemas de desempenho de agentes e gerar relatórios de QA em linguagem simples, sem necessidade de desenvolvimento personalizado.

Adicione o CX Addon e cada gravação chega pré-enriquecida com transcrição, resumo, sentimento, itens de ação e uma pontuação CX. Isso reduz drasticamente o trabalho de IA que o Claude precisa fazer, mantendo o uso de tokens baixo e os custos mais previsíveis.

Como obter uma chave de API

O servidor MCP autentica usando um token de API da VoIPstudio. Cada chave é vinculada a um usuário específico, então o Claude só poderá acessar dados que esse usuário pode acessar.

Para gerar uma chave:

1. No painel administrativo, abra o usuário para o qual deseja gerar um token.
2. Vá para a seção API Keys.
3. Insira um nome para a chave — por exemplo, Claude MCP.
4. Clique em Add.
5. Clique no ícone de olho para revelar a chave de API / user_token. Copie esse valor.
6. Para ver mais detalhes ou excluir a chave, clique no ícone de engrenagem e selecione Show Details.

Nota: A chave de API permanece válida enquanto for usada pelo menos uma vez a cada 7 dias (tempo limite padrão). Defina um tempo limite maior (ou ilimitado) se necessário antes de clicar em Add.

Consulte a documentação da API REST

Conectando ao Claude

A VoIPstudio não está listada atualmente no diretório de conectores do Claude.ai. Você a adiciona manualmente como um servidor MCP personalizado.

URL do servidor MCP

[!info] URL do servidor MCP https://mcp.voipstudio.workers.dev/sse

Passos (Claude.ai)

1. No Claude.ai, vá para Settings → Integrations (ou o painel de conectores, dependendo do seu plano).
2. Escolha Add custom MCP server (ou equivalente).
3. Insira a URL do servidor MCP acima.
4. Quando solicitado para autenticação, forneça sua chave de API da VoIPstudio.
5. Salve e autorize a conexão.

O Claude agora pode chamar ferramentas da VoIPstudio em qualquer conversa. Na primeira vez que uma ferramenta for chamada em uma sessão, o Claude pedirá que você confirme o compartilhamento de dados. Clique em Always allow para pular esse aviso em sessões futuras.

API Anthropic (para desenvolvedores)

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"
    }]
  })
});

Conectando a outras plataformas de IA

A maioria das plataformas de IA que suportam MCPs externos pode se conectar ao servidor MCP da VoIPstudio usando a mesma URL e chave de API. Os passos exatos de configuração variam por plataforma. Procure por uma opção rotulada como external MCP server, custom MCP ou remote MCP nas integrações ou configurações da sua plataforma.

CX Addon

Sem o CX Addon, as gravações chegam como metadados brutos. O Claude deve transcrever e analisar cada chamada por conta própria, consumindo tokens significativos por gravação.

Com o CX Addon, a VoIPstudio cuida da transcrição, sumarização, análise de sentimento, extração de ações e pontuação CX em sua própria infraestrutura a um custo mensal fixo, sem taxas por chamada e sem limites de transcrição. O Claude recebe inteligência pronta — pronta para raciocinar imediatamente.

	Sem CX Addon	Com CX Addon
Transcrição	O Claude deve buscar o áudio e transcrever/traduzir	✓ Incluída, com diarização de falantes
Resumo	O Claude deve gerar	✓ Incluído
Sentimento	O Claude deve inferir	✓ Incluído
Itens de ação	O Claude deve extrair	✓ Incluídos
Pontuação CX	Não disponível	✓ 1–10 em cada chamada
Aprox. tokens/chamada	10.000–15.000	300–500
Modelo de custo	Gasto variável de IA	Assinatura mensal fixa

Campos desbloqueados pelo CX Addon

Campo	Tipo	Descrição
transcript	string	Transcrição completa em nível de palavra
transcript_speakers	object	Segmentos de transcrição com diarização de falantes
summary	string	Resumo conciso do resultado da chamada
sentiment	string	Sentimento do cliente: positive, neutral, negative
cx_score	number (1–10)	Pontuação de experiência do cliente
metadata.timeline	array	Momentos-chave e itens de ação extraídos da chamada

Referência de Ferramentas

A simplicidade da integração MCP significa que APIs complexas não precisam ser compreendidas e, em vez disso, prompts simples podem ajudar a plataforma de IA a dar sentido aos dados fornecidos pela VoIPstudio e responder com uma resposta apropriada.

No entanto, alguns usuários mais técnicos podem querer saber o que está acontecendo "sob o capô", então abaixo está um guia de referência para algumas das funções do servidor MCP.

get_recordings

Retorna gravações de chamadas. Com o CX Addon ativo, cada registro inclui transcrição, resumo, sentimento, pontuação CX e linha do tempo. Sem o addon, esses campos retornam null.

Parâmetros

Parâmetro	Tipo	Padrão	Descrição
filters	array	—	Objetos de filtro — consulte Filtering
limit	number	10	Registros por página (máx. 1000)
page	number	1	Número da página

Campos de resposta

Campo	Tipo	Descrição
id	number	ID exclusivo da gravação
call_id	number	Links para CDR call_id
timestamp	string	Início da gravação (UTC, YYYY-MM-DD HH:mm:ss)
caller	string	Número da parte chamadora
called	string	Número da parte chamada
src_name	string	Nome do agente (origem)
dst_name	string	Nome do destino
duration	number	Duração em segundos
type	string	I \= entrada, O \= saída
context	string	Contexto da chamada (ex.: LOCAL_USER, QUEUE)
transcript	string	null
transcript_speakers	object	null
summary	string	null
sentiment	string	null
cx_score	number	null
metadata.timeline	array	null

Exemplo – Pontuações CX baixas esta semana

Pergunte ao Claude: "Mostre-me todas as gravações desta semana em que a pontuação CX foi inferior a 6, agrupadas por agente, com um resumo do que deu errado em cada chamada."

O Claude chama a ferramenta com:

{
  "filters": [
    { "property": "calldate", "operator": "gte", "value": "2026-06-09 00:00:00" },
    { "property": "cx_score",  "operator": "lt",  "value": 6 }
  ],
  "limit": 100
}

get_cdrs

Registros de detalhes de chamada – o log bruto de cada etapa da chamada. Use para estatísticas de volume, análise de custos, distribuições de duração e resumos de atividade de agentes. Disponível sem o CX Addon.

Parâmetros: iguais aos de get_recordings (filters, limit, page)

Campos-chave de resposta

Campo	Tipo	Descrição
call_id	number	Identificador exclusivo da chamada
calldate	string	Carimbo de data/hora de início da chamada (UTC)
src_name	string	Nome do agente / chamador
dst_name	string	Nome do destino
billsec	number	Segundos faturáveis
duration	number	Total de segundos incluindo toque
disposition	string	CONNECTED, NO ANSWER, BUSY, FAILED
charge	number	Custo da chamada
type	string	I \= entrada, O \= saída
src_ua	string	Dispositivo de origem / user-agent do softphone
labels	array	Tags personalizadas aplicadas na VoIPstudio

get_live_calls

Retorna um instantâneo em tempo real de todas as chamadas ativas na sua conta. Nenhum parâmetro necessário.

Exemplo: "Quantas chamadas estão em andamento agora e quais agentes estão nelas?"

get_voicemails

Busca mensagens de caixa postal. Mesma interface de filters, limit e page que outras ferramentas.

Campos-chave filtráveis: src, dst, calldate, duration, listened

get_recording_audio

Retorna uma URL de download direto para o áudio MP3 de uma gravação específica.

Parâmetro: id (number) — o campo id de uma resposta de get_recordings.

[!info] Informação As URLs de áudio têm tempo limitado. Use-as prontamente; não armazene em cache por períodos prolongados.

Filtragem e Paginação

Todas as ferramentas de listagem aceitam um array opcional de filters. Cada objeto de filtro tem três propriedades:

Propriedade	Descrição
property	Nome do campo para filtrar (ex.: calldate, cx_score, src_name)
operator	eq, ne, lt, lte, gt, gte, in, like, notlike
value	String, número ou array (para o operador in)

Exemplos comuns

Intervalo de datas

[
  { "property": "calldate", "operator": "gte", "value": "2026-06-01 00:00:00" },
  { "property": "calldate", "operator": "lte", "value": "2026-06-30 23:59:59" }
]

Limite de pontuação CX

[{ "property": "cx_score", "operator": "gte", "value": 8 }]

Agente específico

[{ "property": "src_name", "operator": "eq", "value": "Jane Ryder" }]

Somente chamadas conectadas

[{ "property": "disposition", "operator": "eq", "value": "CONNECTED" }]

Chamadas de entrada com mais de 5 minutos

[
  { "property": "type",     "operator": "eq",  "value": "I" },
  { "property": "billsec",  "operator": "gt",  "value": 300 }
]

Casos de Uso

Relatório de QA

"Dê-me um resumo de QA para cada agente neste mês — médias de pontuação CX, temas de reclamações comuns e as três chamadas com menor pontuação de cada um, com resumos."

Estatísticas de volume do call center

"Qual foi nosso volume de chamadas por dia nesta semana? Qual foi nosso tempo médio de atendimento e quantas chamadas ficaram sem resposta?"

Análise de tendência de sentimento

"O sentimento do cliente está melhorando ou piorando em comparação ao mês passado? Quais tópicos de chamadas se correlacionam com sentimento negativo?"

Lista de acompanhamento de chamadas perdidas

"Liste todas as chamadas de entrada perdidas nas últimas 24 horas com os identificadores de chamada, para que eu possa priorizar retornos."

Revisão de custos e faturamento

"Quais ramais fizeram as chamadas de saída mais caras neste trimestre?"

Verificação de operações ao vivo

"Quantos agentes estão atualmente em chamadas e há alguma chamada em andamento há mais de 20 minutos?"

Eficiência de Tokens

Cada chamada que o Claude analisa sem o CX Addon exige que o Claude processe o conteúdo de áudio e gere sua própria transcrição e análise. O CX Addon transfere isso inteiramente para a VoIPstudio:

O que a VoIPstudio gerencia (custo mensal fixo, chamadas ilimitadas):

• Transcrição de áudio
• Diarização de falantes
• Sumarização de chamadas
• Classificação de sentimento
• Extração de itens de ação
• Pontuação CX

O que o Claude recebe: Campos de texto limpos e estruturados, prontos para raciocínio, comparação e relatórios.

Isso significa que você pode pedir ao Claude para analisar centenas de chamadas em uma única sessão a uma fração do custo de tokens, tornando QA em larga escala, análise de tendências e relatórios de treinamento de agentes práticos sem gastos imprevisíveis com IA.