WACrew

Guia

MCP de WhatsApp sobre WAHA ou Evolution API

Já roda WAHA, Evolution API, Z-API ou a Cloud API? Como os servidores MCP que embrulham essas APIs se comparam com os que conectam direto no WhatsApp, e quando cada um faz sentido.

Atualizado em 2 min de leitura
Nesta página
  1. Os que existem hoje
  2. Quando o embrulho faz sentido
  3. Quando o direto é melhor
  4. Evolution API, WAHA e WACrew
  5. Perguntas frequentes

Há dois jeitos de dar WhatsApp a um agente por MCP. Um servidor direto segura a sessão do WhatsApp (lharries/whatsapp-mcp, whatzmcp, WACrew). Um servidor embrulho conversa com uma API HTTP de WhatsApp que você já roda, como WAHA ou Evolution API, e traduz em ferramentas MCP. Se a empresa já tem uma dessas APIs em produção, o embrulho pode ser o caminho mais curto.

Os que existem hoje

ServidorEmbrulhaObservação
seejux/waha-whatsapp-mcpWAHATypeScript, stdio; conversas, mensagens, envio, marcar como lida; sem licença detectada pelo GitHub
@codespar/mcp-evolution-apiEvolution APIParte da coleção da codespar para a América Latina, MIT
@codespar/mcp-z-apiZ-API (hospedada)Mesma coleção
@codespar/mcp-whatsapp-cloud, FredShred7/whatsapp-mcp-serverCloud API oficialNúmero na plataforma Business e templates
msaelices/whatsapp-mcp-serverGreenAPI (hospedada)Python, gestão de grupos; último commit em abril de 2025

Quando o embrulho faz sentido

  • A API já está lá, servindo o chatbot ou o CRM, com sessão e webhooks próprios. Um segundo aparelho só para o agente seria redundante.
  • Vários sistemas dividem um número. A API é a dona da sessão e o MCP é mais um cliente.
  • Você precisa do oficial. Só os servidores sobre a Cloud API dão a plataforma da Meta, templates e suporte.

Quando o direto é melhor

  • Você ainda não tem API. Subir WAHA ou Evolution API só para embrulhar é uma peça a mais.
  • Você quer mais que mensagens. Transcrição, revisão antes de enviar, fila por espera e CRM vivem em apps como o WACrew, não em embrulhos finos.
  • Uso pessoal. whatzmcp ou um fork do lharries é mais simples.

Evolution API, WAHA e WACrew

Evolution API e WAHA são APIs para desenvolvedores: entregam endpoints e webhooks, e você constrói o produto. O WACrew é um produto: fila, painel, respostas com IA e servidor MCP, conectando pelo Baileys direto. Se você já tem Evolution API, pode mantê-la para as integrações e usar o WACrew noutro número para as conversas que você atende pessoalmente. Mais em Evolution API ou WACrew e WAHA ou Evolution API.

Perguntas frequentes

Existe servidor MCP oficial do WAHA? Não encontramos nos repositórios do WAHA em novembro de 2026; o seejux/waha-whatsapp-mcp é da comunidade.

Os embrulhos transcrevem áudio? Em geral não; expõem o que a API devolve.

Embrulho é mais seguro para o número? O risco vem da API por baixo. WAHA e Evolution API sobre WhatsApp Web têm o mesmo risco de cliente não oficial; a Cloud API não.