Agentes de IA ficaram bons em executar tarefas — mas continuam presos no terminal ou no chat do navegador. Se o agente precisa de uma decisão sua às 22h, ele espera você voltar ao computador. A partir de hoje, não mais: o servidor MCP da WPPAPI (@iproute/wppapi-mcp) conecta qualquer agente compatível com MCP ao seu número de WhatsApp — e o agente passa a te chamar no WhatsApp quando precisa de você.
O que é MCP, em dois parágrafos
MCP (Model Context Protocol) é o padrão aberto que dá “mãos” aos agentes de IA: em vez de só gerar texto, o agente chama tools — funções reais expostas por um servidor. Um servidor MCP de banco de dados deixa o agente consultar tabelas; um de Git deixa ele ler repositórios.
O @iproute/wppapi-mcp é esse servidor para o seu WhatsApp. Ele roda na sua máquina (ou no seu servidor) e transforma a sua instância WPPAPI em 9 tools que o agente sabe usar: enviar e ler mensagens, verificar números, listar conversas — e duas tools que mudam o jogo.
Human-in-the-loop: o agente pergunta antes de agir
A tool ask_user envia uma pergunta para o seu WhatsApp e bloqueia o agente aguardando a sua resposta (por polling na API — sem webhook público para configurar):
agente: preciso de aprovação…
→ ask_user("Posso deletar os arquivos da pasta tmp?")
você (no WhatsApp): "pode, menos o .env"
agente: entendido — deletei tudo, exceto o .env ✅Casos de uso que isso destrava hoje:
- Aprovações em tarefas sensíveis: deploy, exclusão, envio de e-mail — o agente só age depois do seu “sim” no WhatsApp;
- Notificações de tarefas longas: com
notify_user, o agente avisa quando termina (ou quando quebra) — sem você ficar polando terminal; - Modo listener: com
--listen, a direção inverte — cada mensagem que você manda no WhatsApp vira uma tarefa do agente (claude -p), e a resposta volta no seu WhatsApp. É um assistente pessoal de verdade, com sessão contínua (--resume) e comandos/nova,/ping,/parar.
Configuração em 1 minuto
Na aba IA / Agentes do detalhe da sua instância, o painel gera uma credencial dedicada (API key de escopo SEND, revogável a qualquer momento) e os snippets já preenchidos. Para o Claude Code, é um comando:
claude mcp add whatsapp \
--env WPPAPI_BASE_URL=https://api.wpp-api.com \
--env WPPAPI_INSTANCE_ID=sua-instancia \
--env WPPAPI_TOKEN=sua-api-key \
--env WPPAPI_OWNER_PHONE=5511999999999 \
-- npx -y @iproute/wppapi-mcpTambém há snippet para Claude Desktop (.mcp.json) e para o modo HTTP — para agentes rodando em servidor, com autenticação Bearer própria (WPPAPI_MCP_AUTH_TOKEN).
Boas práticas (a parte honesta)
A WPPAPI é uma API não-oficial do WhatsApp. Um agente com poder de envio exige o mesmo cuidado de qualquer automação: prefira fluxos em que o destinatário espera a mensagem, use a API key de escopo SEND (nunca o token principal), proteja o modo HTTP com token e respeite opt-in e LGPD. Feito isso, você tem algo que nenhum concorrente brasileiro oferece hoje: seu agente de IA, no seu WhatsApp, te tratando como o chefe.
Crie sua conta, conecte uma instância e gere a credencial na aba IA / Agentes — o trial de 3 dias não pede cartão. A documentação completa está em docs/mcp.md e a página da integração em /integracoes/ia.