Como conectar Claude Code ao WhatsApp Business com o MCP oficial da Meta
Passo a passo para configurar o WhatsApp Business Tools MCP no Claude Code, autenticar sua conta Meta e consultar recursos com prompts prontos para copiar.
Guia independente sobre ferramentas dessas marcas.
O que esta integração permite
O WhatsApp Business Tools MCP é o servidor remoto oficial da Meta para consultar e administrar recursos da WhatsApp Business Platform em clientes compatíveis, como o Claude Code. Este guia começa por consultas de leitura. Ele exige uma conta empresarial habilitada e não conecta o WhatsApp pessoal nem transforma, sozinho, o Claude Code em atendente automático.
O que você precisa
- Claude Code instalado e funcionando no seu computador.
- Conta de desenvolvedor da Meta com acesso de administrador à empresa e ao aplicativo com WhatsApp Business Messaging.
- Termos da WhatsApp Business Cloud API aceitos para a empresa. Algumas operações ficam bloqueadas até essa etapa.
O servidor oficial está em beta e tem liberação gradual. Se a conexão ou as ferramentas não aparecerem para sua conta, consulte a documentação da Meta antes de tentar outra integração.
Adicione o servidor no Claude Code
Execute o comando abaixo no terminal. Ele registra o endpoint remoto oficial da Meta como servidor MCP no Claude Code.
claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools Depois, abra uma sessão do Claude Code, digite /mcp, selecione whatsapp_business_tools e conclua o login OAuth com a Meta. Escolha apenas as empresas e os aplicativos que pretende testar.
Revise as permissões na tela de consentimento: o servidor solicita acesso de gerenciamento da empresa e da conta WhatsApp Business, além de permissão para enviar mensagens. Os prompts deste teste pedem somente consultas de leitura.
Confira o acesso sem mudar nada
Cole este prompt na conversa. O objetivo é descobrir as ferramentas e listar as empresas disponíveis antes de mexer em números, modelos de mensagem ou webhooks.
Liste as ferramentas disponíveis do servidor whatsapp_business_tools. Depois use apenas ferramentas de leitura para listar as empresas que posso administrar. Não altere configurações, não crie recursos e não envie mensagens.
Resultado esperado: o agente encontra as ferramentas do servidor e usa uma consulta como whatsapp_biz_businesses. Se não encontrar, confira o endpoint, reinicie o cliente e refaça a autenticação.
Veja contas e números
Selecione a empresa correta na conversa e peça uma visão do estado atual. Revise o nome antes de prosseguir se você administrar mais de uma empresa.
Para a empresa que eu selecionar, liste as contas do WhatsApp Business e os números associados, incluindo o estado de cada número. Apenas consulte os dados. Não registre números nem envie mensagens.
Peça um plano antes de alterar a conta
O MCP também oferece ações de escrita, como registrar número, criar template, configurar webhook e enviar mensagem. Use o prompt abaixo para identificar o que falta e revisar cada ação antes de autorizá-la.
Com base no estado da conta selecionada e na documentação oficial da Meta, monte um checklist para preparar um teste da WhatsApp Business Platform. Separe o que já está pronto do que depende de ação minha. Não execute nenhuma mudança; peça minha aprovação antes de cadastrar número, criar template, configurar webhook, pagamento ou enviar mensagem.
Conectar esse MCP permite administrar e testar a integração. Isso não cria automaticamente um atendente de IA que responde às conversas recebidas. Para isso, seria necessário construir um fluxo próprio sobre a Cloud API e seus webhooks.
Referências oficiais
- Meta · WhatsApp Business Tools MCP ↗
Endpoint, autenticação OAuth, requisitos e ferramentas disponíveis.
- Meta · Primeiros passos na WhatsApp Business Platform ↗
Configuração da plataforma, aplicativo e acesso à Cloud API.
- Meta · Documentação da WhatsApp Business Platform ↗
Referência geral da plataforma e seus recursos.