Servidor MCP da CloudTalk: Conecte o Claude, o Cursor e Seus Próprios Agentes de IA

O servidor MCP da CloudTalk é a implementação de MCP própria da CloudTalk, hospedada em mcp.cloudtalk.io. Ele disponibiliza 49 ferramentas em seis áreas: chamadas e análises, contatos, mensagens e chamadas, Agentes de Voz de IA, campanhas, e consultas de conexão e conta. Conecte-o ao Claude, Cursor ou a um agente desenvolvido por você, e esse assistente poderá pesquisar seu histórico de chamadas, ler transcrições, gerenciar contatos, enviar SMS e executar Agentes de Voz de IA usando os dados reais da sua conta.

Nada além do seu plano. O MCP está incluso a partir do plano Essential, que começa em $29 por usuário por mês com faturamento anual. Duas áreas dependem do que mais você contratou: insights de IA (como resumos, sentimentos, tópicos e transcrições) exigem o Conversation Intelligence, e as ferramentas de campanha exigem o add-on Sales Dialer. As ferramentas do Agente de Voz funcionam com seus minutos gratuitos de Agente de Voz de IA, sem necessidade de add-on. Veja a tabela de preços completa para entender a divisão dos planos.

Do plano Essential ou superior. O MCP não está disponível no plano Starter. Se você está no plano Starter hoje, fazer o upgrade para o Essential é o que ativa o recurso. Chamadas que não foram analisadas retornam campos de IA vazios em vez de um erro, de modo que a ausência do add-on Conversation Intelligence aparece como um resumo em branco, e não como uma conexão corrompida.

Não há um botão de ligar/desligar no produto. Você conecta um cliente ao servidor em quatro etapas:

1. Gere uma chave de API. No Painel da CloudTalk, crie um ID e um Segredo de Chave de Acesso de API. Você precisará de acesso de administrador.
2. Codifique as credenciais. Codifique em Base64 o ID e o Segredo e envie-os como um cabeçalho Authorization: Basic.
3. Aponte seu cliente para o servidor. Use mcp.cloudtalk.io para tudo, ou uma URL de perfil como mcp.cloudtalk.io/analytics para uma lista de ferramentas reduzida.
4. Verifique a conexão. Execute cloudtalk_health_check. Se a chave for validada, você estará conectado.

O guia de início rápido para desenvolvedores traz a configuração exata de cada cliente, além das falhas comuns esperadas em cada um.

Qualquer coisa coberta pelas 49 ferramentas, dita da mesma forma que você falaria com um colega. Quatro tarefas que ele executa muito bem:

• Treinamento e QA: encontre as chamadas onde uma negociação travou, leia as transcrições e resuma o que o vendedor deixou passar.
• Assistência em chamadas ao vivo: puxe o histórico completo de um contato antes de discar e depois registre o resultado sem sair do assistente.
• Trabalho com agentes de voz: crie um Agente de Voz de IA, conecte uma base de conhecimento e verifique o andamento das chamadas dele.
• Dados de contato: localize registros duplicados ou antigos, atualize-os e adicione tags em lote.

Clientes que você mesmo configura funcionam hoje mesmo: Claude Code, Cursor e qualquer cliente compatível com Streamable HTTP usando um cabeçalho personalizado. Eles enviam a chave de API diretamente da sua máquina, então nada precisa ser habilitado previamente para você.

Conectores hospedados são diferentes. O Claude.ai, Claude Desktop e Claude mobile se conectam a partir da nuvem da Anthropic e precisam de um campo de cabeçalho de requisição, que a Anthropic ativa por organização. Assim, a exibição desse recurso depende da sua organização no Claude, e não da CloudTalk. O ChatGPT oferece apenas login via OAuth, que a CloudTalk ainda não suporta. Por isso, o ChatGPT não consegue se conectar no momento, mas o suporte ao OAuth está planejado.

Quatro controles garantem essa segurança. Toda ferramenta é limitada à sua empresa pela chave de API, e nenhuma ferramenta aceita um ID de conta externo, impedindo que um assistente acesse dados de outra empresa. A CloudTalk visualiza apenas os parâmetros da ferramenta (como intervalo de datas ou ID da chamada), nunca sua conversa com o assistente. Links de gravações são assinados, expiram em até 12 horas (geralmente antes) e todo acesso é registrado na trilha de auditoria da CloudTalk. Revogar a chave de API em seu Painel corta o acesso imediatamente, podendo levar alguns minutos para fazer efeito completo.

Ele não pode excluir um contato, uma chamada ou uma gravação. Ainda assim, ele pode remover dados por meio de gravação (sobrescrevendo-os): atualizar um contato ou substituir as fontes de uma campanha remove tags, números ou e-mails que você não incluiu, e remover tags de chamadas as desvincula. Excluir uma campanha é a única ação definitiva, e o arquivamento é a opção reversível. As ações mais críticas exibem uma prévia e solicitam confirmação antes de serem executadas.

Use o MCP quando uma pessoa ou agente precisar decidir o próximo passo, e a API quando as etapas já forem conhecidas antecipadamente. O MCP fornece um catálogo ao assistente e permite que ele escolha, o que é ideal para investigações, treinamentos, análises pontuais e tarefas de agentes. Uma sincronização noturna agendada para o seu banco de dados não envolve decisões, tornando a API a escolha mais simples. A maioria das equipes acaba utilizando ambos.

Sim, 60 requisições por minuto por empresa. Uma resposta 429 significa que você deve aguardar um minuto e tentar novamente. Leituras são armazenadas em cache brevemente (de segundos a minutos) para manter as respostas rápidas, e estatísticas de fila ao vivo nunca são armazenadas em cache. Os registros alterados pelo assistente são atualizados imediatamente, embora um agente de voz ou base de conhecimento recém-criados possam levar um curto período para aparecer nos resultados de listagem.

Desenvolvedores, administradores técnicos e parceiros que utilizam seu próprio assistente de IA integrado com os dados da CloudTalk. A configuração envolve uma chave de API, uma etapa de codificação Base64 e um arquivo de configuração, de modo que ter alguém da área técnica do seu lado faz toda a diferença para concluir o processo em vinte minutos, em vez de uma tarde inteira. Depois de conectado, qualquer pessoa da equipe que utilize o assistente colherá os benefícios sem precisar mexer na configuração novamente.