Voipstudio MCP Server

IA - Inteligência Artificial - Servidor MCP VoIPstudio¶

O servidor MCP (Model Context Protocol) da VoIPstudio oferece ao Claude AI acesso direto e seguro aos dados da sua conta VoIPstudio, incluindo gravações, CDRs, chamadas em tempo real e correios de voz. 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 natural, 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.

Obtendo uma chave de API¶

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

Para gerar uma chave:

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

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 Adicionar.

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¶

URL do servidor MCP

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

Passos (Claude.ai)¶

1. No Claude.ai, vá para Configurações → Integrações (ou o painel de conectores, dependendo do seu plano).
2. Escolha Adicionar servidor MCP personalizado (ou equivalente).
3. Insira a URL do servidor MCP acima.
4. Quando solicitada a autenticação, forneça sua chave de API da VoIPstudio.
5. Salve e autorize a conexão.

O Claude agora pode chamar as 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 Permitir sempre 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. As etapas exatas de configuração variam conforme a plataforma. Procure uma opção rotulada como servidor MCP externo, MCP personalizado ou MCP remoto 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 lida com 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	Claude deve buscar áudio e transcrever/traduzir	✓ Incluída, com diarização de falantes
Resumo	Claude deve gerar	✓ Incluído
Sentimento	Claude deve inferir	✓ Incluído
Itens de ação	Claude deve extrair	✓ Incluídos
Pontuação CX	Não disponível	✓ 1–10 em cada chamada
Tokens aprox./chamada	10.000–15.000	300–500
Modelo de custo	Gasto variável com 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: positivo, neutro, negativo
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 interpretar os dados fornecidos pela Voipstudio e responder adequadamente.

No entanto, alguns usuários mais técnicos podem querer saber o que acontece "nos bastidores", 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 — veja Filtragem
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 único da gravação
call_id	number	Vincula ao call_id do CDR
timestamp	string	Início da gravação (UTC, AAAA-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 perna de chamada. Use para estatísticas de volume, análise de custos, distribuições de duração e resumos de atividade do agente. Disponível sem o CX Addon.

Parâmetros: mesmo que get_recordings (filters, limit, page)

Campos de resposta principais

Campo	Tipo	Descrição
call_id	number	Identificador único da chamada
calldate	string	Timestamp 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	Segundos totais incluindo chamada
disposition	string	CONECTADO, SEM RESPOSTA, OCUPADO, FALHA
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 correio de voz. Mesma interface de filters, limit e page que as outras ferramentas.

Campos filtráveis principais: 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 get_recordings.

Informação

As URLs de áudio são limitadas no tempo. Use-as prontamente; não as armazene em cache por períodos prolongados.

Filtragem e Paginação¶

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

Propriedade	Descrição
property	Nome do campo a filtrar (ex. calldate, cx_score, src_name)
operator	eq, ne, lt, lte, gt, gte, in, like, notlike
value	String, number 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" }]

Apenas 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 do agente¶

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

Estatísticas de volume da central de chamadas¶

"Qual foi o volume de chamadas por dia esta semana? Qual foi o 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 diminuindo em comparação com o mês passado? Quais tópicos de chamada se correlacionam com sentimento negativo?"

Lista de acompanhamento de chamadas perdidas¶

"Liste todas as chamadas de entrada perdidas das últimas 24 horas com IDs de chamador, para que eu possa priorizar os 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 que esteja durando 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 lida (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 por uma fração do custo de tokens, tornando QA em larga escala, análise de tendências e relatórios de coaching de agentes práticos sem gastos imprevisíveis com IA.