Assistentes de IA são bons em ler conversas longas, achar aquele detalhe de que você precisa e rascunhar uma resposta. E é no WhatsApp que muitas dessas conversas estão. O Model Context Protocol (MCP) é o padrão para ligar uma coisa à outra: um servidor MCP oferece um conjunto de ferramentas, e qualquer app de IA compatível com MCP pode usá-las quando você pede.
Este guia mostra como conectar o WhatsApp ao Claude, ao ChatGPT, ao Cursor, ao Claude Code e a outros clientes MCP usando o servidor MCP do Kaption. Ele explica as duas formas de conexão, o que a IA pode e não pode fazer depois de conectada e como desligar tudo.
Atualizado em setembro de 2026
Como funciona
O servidor MCP do Kaption tem três partes:
- Seu app de IA (Claude, ChatGPT, Cursor ou outro cliente MCP) percebe que precisa de informações do WhatsApp e chama uma ferramenta, por exemplo "pesquisar mensagens da Maria sobre a nota fiscal".
- A conexão. No modo nuvem, o pedido passa pelo relay do Kaption em
mcp.kaptionai.com, que confere se você fez login e repassa o pedido. O relay não consegue ler suas mensagens. No modo local, o pedido fica no seu computador.
- O Kaption no seu computador. A extensão do Kaption no WhatsApp Web, ou o app Kaption para computador, executa o pedido no seu WhatsApp e devolve só a resposta.
Como a última etapa roda no seu próprio computador, a conexão só funciona enquanto o Kaption estiver aberto: o WhatsApp Web com a extensão no Chrome ou no Edge, ou o app para computador.
Opção 1: conexão na nuvem (Claude, ChatGPT, Cursor)
Use esta opção com qualquer app de IA que consiga adicionar um servidor MCP remoto, muitas vezes chamado de conector personalizado, e fazer login com OAuth.
Passo 1. Abra o Kaption no seu computador. Abra o WhatsApp Web no Chrome ou no Edge com a extensão do Kaption, ou abra o app Kaption para computador. Confira se você está conectado à sua conta do Kaption.
Passo 2. Ative a conexão. Na extensão, abra Assistentes de IA (MCP), escolha Ponte na nuvem e clique em Ativar. No app para computador, ative MCP na nuvem em Configurações. A conexão fica desativada até você fazer isso.
Passo 3. Adicione o servidor ao seu app de IA. Adicione um servidor MCP remoto ou um conector personalizado com este endereço:
https://mcp.kaptionai.com/mcp
Passo 4. Faça login. Seu app de IA abre a página de login do Kaption. Digite seu número de telefone e depois o código de 6 dígitos que o Kaption envia para você no WhatsApp. Escolha por quanto tempo o app de IA fica conectado:
- Enquanto eu usar (recomendado): ele se desconecta após 90 dias sem uso.
- Por 1 ano.
- Até eu desconectar.
Pronto. Pergunte algo sobre seus chats ao seu app de IA e ele vai usar as ferramentas do WhatsApp.
Opção 2: conexão local (Claude Code, Claude Desktop, Cursor, VS Code)
Se você prefere que a conexão fique no seu computador, rode o servidor MCP local do Kaption. Ele fala com a extensão via localhost e precisa do Node.js 18 ou mais recente.
Primeiro, ative a ponte MCP nas configurações da extensão do Kaption (ou MCP local em Configurações, no app para computador) e mantenha o WhatsApp Web aberto.
Claude Code: rode um único comando.
claude mcp add whatsapp -- npx -y @kaptionai/mcp-extension@latest
Claude Desktop, Cursor, Windsurf, VS Code e outros clientes: adicione isto ao arquivo de configuração MCP do app.
{
"mcpServers": {
"whatsapp": {
"command": "npx",
"args": ["-y", "@kaptionai/mcp-extension@latest"]
}
}
}
O servidor local pode conectar vários números de WhatsApp ao mesmo tempo, e vários apps de IA podem compartilhar a mesma conexão.
O que seu assistente de IA pode fazer
As ferramentas do servidor na nuvem, agrupadas pelo que elas acessam:
- Pesquisar e ler: pesquise mensagens e chats, encontre contatos e grupos, exporte contatos, baixe mídias de um chat e veja estatísticas dos chats.
- Resumir: resuma uma conversa. O resumo fica visível só para você.
- Organizar: arquive, fixe, silencie e marque chats como lidos ou não lidos; deixe um rascunho; gerencie listas e lembretes. Em contas do WhatsApp Business, gerencie etiquetas e notas.
- Agendar: agende uma mensagem para uma pessoa, com até 800 caracteres, que o Kaption envia no horário que você definir.
O que ele não pode fazer
- Enviar uma mensagem na hora. Não existe ferramenta de envio imediato. A IA pode deixar um rascunho para você, ou agendar uma mensagem para uma pessoa quando você pedir.
- Ver chats trancados. Os chats que você trancou no WhatsApp ficam sempre ocultos.
- Funcionar com o Kaption fechado. Se o WhatsApp Web com a extensão, ou o app para computador, não estiver aberto, as ferramentas retornam um erro pedindo para você abri-lo.
- Enviar mensagens em massa ou não solicitadas. Os termos do Kaption proíbem usar o acesso MCP para isso, e o acesso tem limite de taxa.
Pedidos que funcionam bem
- "Resuma o que o grupo de Vendas conversou hoje."
- "Encontre o endereço que a Maria me mandou na semana passada."
- "Quais chats eu não respondi desde sexta-feira?"
- "Me lembre amanhã às 9h de retomar o contato com o Carlos."
- "Escreva um rascunho de resposta para o João confirmando quinta-feira às 15h."
Seja específico sobre o chat ou a pessoa. "Pesquise no meu WhatsApp" funciona, mas "pesquise no meu chat com o proprietário o valor da caução" é mais rápido e mais confiável.
Privacidade e segurança
- Desativado por padrão, revogável a qualquer momento. É você quem ativa a conexão, e você pode desativá-la no Kaption ou remover o conector no seu app de IA.
- O relay não consegue ler suas mensagens. Ele repassa pedidos e respostas entre o seu app de IA e o Kaption no seu computador. O código-fonte dele é público em github.com/Kaption-AI/mcp-extension-remote, e cada deploy é assinado e registrado em um log público encadeado por hash.
- OAuth com um único escopo. O login usa OAuth 2.1 com PKCE e um só escopo de permissão, e os tokens de acesso expiram depois de uma hora.
- O que fica armazenado. Lembretes e mensagens agendadas ficam guardados no Kaption Cloud para dispararem na hora certa. Suas mensagens, não.
Lembre-se de que tudo o que o seu app de IA lê passa a ser processado pelo fornecedor dessa IA, sob os termos dele. Conecte só os apps de IA em que você já confia com as informações dos seus chats.
Solução de problemas
"Extension not connected" (extensão não conectada). Abra o WhatsApp Web no Chrome ou no Edge com o Kaption (ou o app para computador) e confira se a opção Ponte na nuvem ou MCP na nuvem está ativada.
O app de IA não encontra as ferramentas. Confira se você adicionou https://mcp.kaptionai.com/mcp exatamente assim, incluindo o /mcp no final, e se o login foi concluído.
O servidor local não inicia. Rode node --version e confira se a versão é 18 ou mais recente; depois, verifique se a ponte MCP está ativada na extensão.
Para um resumo de tudo isso, veja a página de MCP do Kaption.
Perguntas frequentes
A conexão na nuvem funciona com o Claude, o ChatGPT, o Cursor e qualquer cliente MCP compatível com servidores remotos com OAuth. O servidor local funciona com o Claude Desktop, o Claude Code, o Cursor, o VS Code, o Windsurf, o Zed e outros clientes que rodam servidores MCP locais.
O Claude ou o ChatGPT podem enviar mensagens no WhatsApp por mim?
Não na hora. Eles podem deixar um rascunho ou agendar uma mensagem para uma pessoa quando você pedir. Nada é enviado imediatamente.
Existe um servidor MCP oficial do WhatsApp?
O WhatsApp não publica um. O servidor do Kaption funciona pelo WhatsApp Web no seu próprio computador. O Kaption não tem vínculo com o WhatsApp nem com a Meta.
Sim. Contas do WhatsApp Business também ganham ferramentas de etiquetas e notas.
Como desconecto um app de IA?
Desative a conexão no Kaption ou remova o conector no seu app de IA. Se você escolheu "Enquanto eu usar", a conexão também termina sozinha após 90 dias sem uso.
Tem algum custo?
O acesso ao MCP depende do seu plano do Kaption. A extensão mostra o que o seu plano inclui.
