WhatsApp MCP

npx add-mcp 'https://server.wa-mcp.com/mcp'

Documentação do WhatsApp MCP

O WhatsApp MCP conecta seu assistente de IA (Claude, ChatGPT, Cursor ou qualquer cliente que suporte o Model Context Protocol) ao número de WhatsApp que você já usa. Seu assistente pode ler e pesquisar suas conversas, descobrir quem está esperando uma resposta e enviar, agendar, editar ou reagir a mensagens, sempre a partir do seu próprio número e somente quando você pedir.

Ele se conecta ao WhatsApp como um dispositivo vinculado, da mesma forma que o WhatsApp Web. Não há aplicativo para instalar, nem número novo, nem Meta Business API.

Configuração

Você se conecta uma vez e depois vincula seu WhatsApp no chat.

Opção A: diretório de conectores do Claude

1. No Claude, abra o diretório de conectores e encontre o WhatsApp MCP.
2. Clique em Conectar. Nossa página de conexão abre: verifique se ela indica seu app de IA e clique em Conectar novamente.
3. De volta ao Claude, abra um novo chat e digite "Conecte meu WhatsApp" (veja "Vincule seu WhatsApp" abaixo).

Não há cadastro nem senha: seu número de WhatsApp é sua conta, e vinculá-lo é como sabemos que é você.

Opção B: um link de conexão pessoal (qualquer cliente MCP)

1. Acesse wa-mcp.com, escolha seu app de IA e clique em Gerar meu link.
2. Adicione o link ao seu app de IA como um conector personalizado (servidor MCP). O site mostra os passos exatos para cada app, e Como conectar o Claude ao WhatsApp explica o Claude passo a passo.
3. Abra um novo chat e digite "Conecte meu WhatsApp".

Mantenha o link privado: ele funciona como uma senha. Você pode usar o mesmo link em vários apps de IA.

Vincule seu WhatsApp

Quando você pede ao seu assistente para conectar seu WhatsApp, ele oferece duas formas:

• Código QR: seu assistente mostra um código QR (e um link para uma página com ele). No seu celular, abra o WhatsApp → Configurações → Dispositivos conectados → Conectar dispositivo e escaneie-o.
• Código de pareamento: informe ao seu assistente seu número de telefone com o código do país. Ele retorna um código de 8 caracteres. No seu celular, abra Dispositivos conectados → Conectar dispositivo → Conectar com número de telefone e digite o código.

Após a vinculação, o WhatsApp sincroniza seu histórico recente (até cerca de 90 dias) com o dispositivo vinculado, o que pode levar alguns minutos para contas grandes.

Planos

• Teste gratuito: todos os recursos por 1 hora após você vincular um telefone pela primeira vez.
• Plano gratuito: após o teste, ler, resumir e pesquisar conversas e enviar mensagens de texto continuam funcionando. As mensagens de texto terminam com "Sent via wa-mcp.com", e novas conversas (pessoas que não escreveram para você nos últimos 90 dias) não podem ser iniciadas.
• Plano pago: arquivos (fotos, vídeos, mensagens de voz, documentos), mensagens agendadas, edição, reação e exclusão de mensagens, novas conversas com proteções anti-banimento e sem rótulo.

Pergunte ao seu assistente "Qual é o meu plano?" para ver seu plano e as opções de assinatura.

Ferramentas

Seu assistente escolhe as ferramentas; você só precisa pedir com palavras simples.

Leitura

Ferramenta	O que faz
get_recent_chats	Suas conversas mais recentes, com a última mensagem de cada uma.
get_unanswered_chats	Conversas em que a última mensagem é da outra pessoa, para você ver quem está esperando uma resposta.
read_chat_history	As mensagens de uma conversa, pessoa ou grupo.
search_messages	Pesquisa o texto das suas mensagens, opcionalmente em uma conversa ou de uma pessoa.
search_contacts	Encontra um contato ou grupo por nome ou número.
download_media	Abre uma foto, mensagem de voz, vídeo, documento ou figurinha de uma mensagem.
get_writing_style	Exemplos de como você escreve, para que os rascunhos feitos para você soem como você.

Escrita

Ferramenta	O que faz
send_message	Envia um texto, ou um arquivo a partir de um link, para uma pessoa ou grupo. Mostra um indicador de digitação primeiro.
schedule_message	Agenda uma mensagem para depois, uma vez ou repetidamente (diariamente, semanalmente, mensalmente e mais).
list_scheduled_messages	Lista as mensagens agendadas futuras e o histórico das anteriores.
cancel_scheduled_message	Cancela uma mensagem agendada (todas as suas repetições).
react_to_message	Reage a uma mensagem com um emoji, ou remove a reação.
edit_message	Altera o texto de uma das suas próprias mensagens.
delete_message	Exclui uma das suas próprias mensagens para todos.
mark_as_read	Marca uma conversa como lida.

Conexão e conta

Ferramenta	O que faz
get_session_status	Informa se seu WhatsApp está vinculado e conectado.
get_pairing_qr	Inicia a vinculação com um código QR.
request_pairing_code	Inicia a vinculação com um código de pareamento.
restart_session	Reconecta ao WhatsApp se as mensagens pararem de chegar.
manage_subscription	Mostra seu plano e as opções de assinatura.
report_feedback	Envia para nós um relatório de bug ou solicitação de recurso.
unlink_whatsapp	Desvincula seu WhatsApp (sua conta permanece).
delete_account	Exclui sua conta e todos os seus dados, após você confirmar.

Exemplos de comandos

• "Quem está esperando uma resposta minha desde ontem?"
• "Resuma o que o grupo da família conversou esta semana."
• "Encontre a mensagem em que o Carlos me enviou o endereço."
• "Diga à Ana que o pedido será enviado na quinta-feira." (seu assistente mostra o rascunho primeiro, a menos que você tenha dado as palavras exatas)
• "Toda segunda-feira às 9h, lembre o grupo da equipe de enviar a atualização semanal."

Segurança

• Você mantém o controle do que é enviado. Quando seu assistente escreve uma mensagem para você, ele mostra o rascunho antes de enviar, a menos que você tenha dado o texto exato.
• Proteções anti-banimento. Mensagens para pessoas que não escreveram para você nos últimos 90 dias são espaçadas (no máximo 1 por minuto e 10 pessoas diferentes a cada 12 horas), porque é isso que faz números serem sinalizados como spam. Conversas com pessoas que já escreveram para você nunca são limitadas. Não há ferramentas de envio em massa.
• Indicador de digitação. Um breve "digitando…" aparece antes de cada mensagem, como apareceria se você a tivesse digitado.

Solução de problemas

• "O WhatsApp não está vinculado": o dispositivo vinculado foi removido (do seu celular ou por desvinculação). Peça ao seu assistente para conectar seu WhatsApp novamente com o mesmo número.
• O código de pareamento não funciona: os códigos expiram após um curto período. Peça um novo, verifique se o número inclui o código do país e use Conectar com número de telefone no seu celular.
• As mensagens pararam de chegar: peça ao seu assistente para reiniciar sua conexão com o WhatsApp. Se o WhatsApp no seu celular ficou offline por cerca de 14 dias, o WhatsApp desconecta os dispositivos vinculados: abra o WhatsApp no seu celular e vincule novamente.
• "Esta conexão está permanentemente registrada ao número de telefone…": cada conexão pertence a um telefone. Para usar outro número, desvincule e depois remova o conector e adicione-o novamente (ou, com um link pessoal, gere um novo).
• O conector diz que não está conectado (usuários do diretório): remova o WhatsApp MCP dos seus conectores e conecte-o novamente, depois vincule o mesmo telefone. Sua conta e assinatura são mantidas.

Privacidade e seus dados

Suas mensagens são armazenadas por 90 dias em nossos servidores para que seu assistente possa pesquisá-las, e nunca são usadas para publicidade ou treinamento de IA. O que seu assistente lê é tratado pelo provedor dele conforme a política deles. Peça ao seu assistente para desvincular seu WhatsApp ou excluir sua conta a qualquer momento; a exclusão remove tudo imediatamente. Os detalhes completos estão na nossa Política de Privacidade e nos Termos.