WhatsApp Business Tools: o MCP Oficial da Meta no Claude
Conecte o MCP oficial da Meta ao Claude Code para gerir o WhatsApp Business Cloud API, sabendo o que ele escreve, cobra e exige de admin.
O que é
WhatsApp Business Tools: o MCP Oficial da Meta no Claude
O WhatsApp Business Tools é um servidor MCP remoto da Meta que deixa o Claude conversar com a WhatsApp Business Platform (Cloud API): listar os negócios e números que você administra, cadastrar e registrar um número, gerir templates e webhooks, configurar pagamento, checar a verificação da empresa e enviar mensagens. Neste tutorial você conecta o servidor ao Claude Code e testa primeiro só leitura.
O servidor tem 18 ferramentas segundo a documentação oficial conferida em 20/10/2026. Ele está em beta e o acesso é liberado aos poucos, então pode não aparecer na sua conta. É um produto diferente do OpenWA do tutorial Claude no WhatsApp: aquele é um cliente não oficial, este é a API oficial da Meta.
A ressalva principal: ele não é somente leitura. As ferramentas escrevem na sua conta e enviam mensagens como você, e a documentação não traz um modo de leitura. Por isso o tutorial começa com consultas, usa número novo e pede confirmação a cada ação.
Um comando no Claude Code
claude mcp add com transporte http e login OAuth com a sua conta Meta, sem chave de API.
Teste só leitura primeiro
Listar negócios, contas, números e templates antes de qualquer ação que escreva.
Cadastro de número novo
Adicionar, enviar o código, verificar e registrar, com confirmação a cada etapa.
Templates e janela de 24 h
Texto livre só dentro da janela de 24 horas. Fora dela, só template aprovado.
Admin e escopos explicados
Papel de admin no negócio e no app, termos da Cloud API e os 3 escopos pedidos no consentimento.
Nível: avançado · Tempo estimado: ~30 min se você já é admin do negócio e do app na Meta. Se ainda precisa criar o app ou aceitar os termos, conte bem mais.
Leia antes de qualquer passo: este MCP NÃO é somente leitura. Segundo a documentação da Meta, as 18 ferramentas incluem cadastrar e registrar número, criar, editar e apagar templates, configurar webhooks, configurar pagamento e enviar mensagens, tudo agindo como você nos negócios e apps que administra. A documentação não traz modo de leitura nem uma opção para desligar as ferramentas de escrita. Comece só consultando, peça confirmação a cada ação e nunca use conta ou número de cliente para testar.
Beta e liberação gradual. A Meta avisa que o servidor está sendo liberado aos poucos e que a interface e o conjunto de ferramentas podem mudar. Se o servidor ou o login não funcionar na sua conta, espere e tente de novo em outro dia. Esta página reflete a documentação de 20/10/2026.
Exige admin e termos aceitos. Você precisa de acesso de administrador no negócio (papel MANAGE), ser admin de um app com WhatsApp habilitado (caso de uso WhatsApp Business Messaging) e ter os Termos de Serviço da WhatsApp Business Cloud API aceitos pelo negócio. Sem isso, envio e registro de número ficam bloqueados. O consentimento pede 3 escopos: business_management, whatsapp_business_management e whatsapp_business_messaging.
Use um número NOVO. Um número registrado na Cloud API deixa de funcionar no aplicativo do WhatsApp. A página de documentação do MCP não detalha isso, mas é regra da Cloud API: confirme na documentação da plataforma antes de registrar. Nunca registre o seu número principal nem o de um cliente.
Custo e regras de mensagem. Mensagens de template são cobradas pela Meta e a documentação do MCP não traz valores: consulte a tabela de preços oficial antes de enviar. Envie só para quem aceitou receber, siga as políticas do WhatsApp Business e trate números e conversas de clientes como dados pessoais (LGPD).
Não testado neste tutorial: o login OAuth, o cadastro de número, o envio e a lista de 18 ferramentas dentro do Claude Code. Comando, escopos, pré-requisitos e ferramentas vêm da documentação oficial da Meta lida em 20/10/2026.
Pré-requisitos
- Claude Code instalado e logado (documentação: https://code.claude.com/docs). A documentação da Meta também lista Claude Desktop, Codex App e ChatGPT
- Conta Meta com papel de administrador (MANAGE) no negócio e administrador do app com WhatsApp habilitado
- Termos da WhatsApp Business Cloud API aceitos para o negócio
- Acesso liberado ao MCP na sua conta (liberação gradual)
- Um número novo e secundário para testar o cadastro, nunca o principal
- Custo: mensagens de template são cobradas pela Meta, sem valores na documentação do MCP
Conceitos-chave
- 01
MCP remoto
Um servidor que o Claude chama por uma URL. Este é da Meta e fica em mcp.facebook.com. Nada roda na sua máquina, e o login é OAuth com a sua conta Meta.
- 02
Cloud API
A API oficial do WhatsApp Business. O MCP é uma camada que deixa o Claude usar essa API nos negócios e apps que você administra.
- 03
Template e janela de 24 horas
Texto livre só é entregue dentro da janela de 24 horas do atendimento ao cliente. Fora dela, só template aprovado, que é cobrado.
- 04
Escopos
Permissões pedidas no consentimento: gerir o negócio, gerir contas, números, templates e webhooks, e enviar mensagens. Você escolhe quais negócios e apps o servidor pode ver e pode revogar depois.
Não é o OpenWA. O tutorial Claude no WhatsApp (/open-source/integracoes/claude-no-whatsapp) usa o OpenWA, um cliente não oficial, com número secundário e leitura por padrão. Este MCP é oficial, passa pela Cloud API e escreve na conta. Os riscos são diferentes e as duas páginas não se substituem.
Passo a passo
- 01
Confirme o seu acesso na Meta
Antes de instalar, confira que você é admin do negócio e do app com WhatsApp habilitado e que os termos da Cloud API foram aceitos. Se algo faltar, a ferramenta devolve um erro com o link para corrigir.
- 02
Adicione o servidor ao Claude Code
Rode no terminal. O comando é o da documentação oficial.
claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools - 03
Faça o login OAuth
Abra uma sessão do Claude Code, rode /mcp e escolha whatsapp_business_tools. O navegador abre para você entrar na conta Meta. Na tela de consentimento, selecione só os negócios e apps que quer usar. Depois de reiniciar o cliente, o login precisa ser feito de novo.
/mcp - 04
Ou use o Claude Desktop
Em Configurações > Conectores > Adicionar conector personalizado, use o nome WhatsApp Business Tools e a URL abaixo, depois conclua o login.
https://mcp.facebook.com/whatsapp_business_tools - 05
Verifique a conexão
Reinicie o cliente, peça a lista de ferramentas do servidor e rode uma ferramenta de leitura, como a que lista os negócios (prompts abaixo).
- 06
Teste só leitura
Liste negócios, contas, números e templates. Não cadastre nem envie nada nesta etapa.
- 07
Cadastre um número novo, se for o caso
A ordem da documentação é adicionar o número, enviar o código de verificação, verificar o número e registrar. Peça ao Claude para confirmar com você antes de cada etapa e use só número novo.
- 08
Faça um envio de teste, só com o seu número
Envie um template ou um texto dentro da janela de 24 horas para um número seu. A ferramenta confirma o destinatário antes de enviar. Leia o destinatário e o texto antes de dizer sim.
- 09
Revogue o acesso quando terminar
No facebook.com, em Configurações > Integrações de negócios, você revisa e remove o acesso do servidor.
Prompts prontos
Troque [NOME DO NEGÓCIO] pelo negócio que você escolheu no consentimento, [NOME DA CONTA] pela conta do WhatsApp dentro dele, [NÚMERO COM DDI] pelo número novo que você vai cadastrar, [NÚMERO DE ORIGEM] pelo número registrado de onde sai a mensagem, [MEU NÚMERO DE TESTE] por um número seu e [NOME DO TEMPLATE] por um template aprovado. Os prompts de cadastro e de envio pedem o seu ok antes de agir.
Prompt: listar as ferramentas e separar leitura de escrita
Liste as ferramentas disponíveis no servidor whatsapp_business_tools e agrupe por tipo: só leitura, escreve na conta e envia mensagem. Não execute nenhuma.
Prompt: teste de leitura (negócios e números)
Use a ferramenta whatsapp_biz_businesses para listar os negócios que eu administro. Depois use whatsapp_biz_phone_numbers para o negócio [NOME DO NEGÓCIO] e mostre o status de cada número. Só consulta: não altere nada.
Prompt: listar os templates
Liste os templates de mensagem da conta [NOME DA CONTA] com nome, categoria e status de aprovação. Só consulta: não crie, não edite e não apague nada.
Prompt: cadastrar um número novo, passo a passo
Quero cadastrar o número novo [NÚMERO COM DDI] na conta [NOME DA CONTA] do negócio [NOME DO NEGÓCIO]. Antes de cada etapa (adicionar, enviar o código, verificar e registrar), me diga o que vai fazer e espere meu ok. Eu informo o código quando chegar.
Prompt: preparar um envio de teste
Prepare o envio do template [NOME DO TEMPLATE] do número [NÚMERO DE ORIGEM] para [MEU NÚMERO DE TESTE]. Mostre o destinatário, o template e o texto final e só envie depois do meu ok explícito.
Prompt: ver o status da verificação da empresa
Mostre o status da verificação do negócio [NOME DO NEGÓCIO] e o que falta para concluir. Só consulte: não inicie a verificação e não configure pagamento.
Erros comuns
- O servidor ou o login não aparece para a conta → liberação gradual em beta → confirme a URL e o comando, tente de novo em outro dia e acompanhe a documentação da Meta
- Pede login de novo depois de reiniciar → a documentação diz que o OAuth se repete a cada reinício do cliente → rode /mcp e autentique de novo
- A ferramenta devolve erro de pré-requisito → falta ser admin do app, ter o papel MANAGE ou aceitar os termos da Cloud API → siga o link do próprio erro para corrigir
- O texto livre não foi entregue → a janela de 24 horas não estava aberta → envie um template aprovado, lembrando que ele é cobrado
- Erro de limite de requisições → o limite é por usuário e por ferramenta → espere um pouco e repita
- O número sumiu do aplicativo do WhatsApp → ele foi registrado na Cloud API → use número novo e não registre o principal
- O agente não lista ferramentas → o cliente não foi reiniciado, a URL está errada ou o login não terminou → confira os três e peça a lista de novo
Checklist final
- Sou admin do negócio e do app e os termos da Cloud API estão aceitos
- O servidor aparece no /mcp e o login OAuth foi concluído
- Rodei primeiro só ferramentas de leitura e conferi o resultado
- Usei somente um número novo e secundário
- Li o destinatário e o texto antes de qualquer envio
- Revoguei o acesso em Integrações de negócios quando não precisei mais
Perguntas frequentes
Este MCP é somente leitura?
Não. A documentação lista ferramentas que cadastram número, mexem em templates e webhooks, configuram pagamento e enviam mensagens, e não traz modo de leitura. O envio pede confirmação do destinatário.
Funciona no Codex e no ChatGPT?
A documentação da Meta lista Claude Code, Claude Desktop, OpenAI Codex App e ChatGPT. O Antigravity não consta nela.
Quantas ferramentas ele tem?
18, pela lista da documentação em 20/10/2026: 3 de descoberta, 4 de cadastro de número, 5 de templates, 1 de envio, 2 de webhooks e 3 de configuração da conta. Como é beta, o conjunto pode mudar.
Quanto custa?
O MCP em si não traz preço na documentação. Mensagens de template são cobradas pela Meta, então confira a tabela de preços oficial antes de enviar.
É o mesmo que o OpenWA?
Não. O OpenWA do tutorial Claude no WhatsApp é um cliente não oficial. Este MCP é oficial e usa a Cloud API.
Fontes oficiais
- Documentação do WhatsApp Business Tools MCPdevelopers.facebook.com/documentation/mcp/whatsapp-business-tools-mcp (abre em nova aba)
- Visão geral dos MCPs da Metadevelopers.facebook.com/documentation/mcp (abre em nova aba)
- WhatsApp Business Platformdevelopers.facebook.com/documentation/business-messaging/whatsapp (abre em nova aba)
- Documentação do Claude Codecode.claude.com/docs (abre em nova aba)
Próximos passos
Comece agora
Pronto para colocar WhatsApp Business Tools: o MCP Oficial da Meta no Claude para rodar?
Ver a documentação oficial da MetaPróximo passo
Veja os outros recursos do catálogo
Dezenas de recursos entre squads, skills, apps e integrações — todos usados em produção pelo João.
Voltar ao catálogo