Como usar o MCP do WhatsApp Business da Meta pra registrar um número na API com Claude ou ChatGPT?
Por NumioPublicado em
O WhatsApp Business Tools MCP é um servidor MCP oficial da Meta, lançado em beta em 15 de setembro de 2026, que deixa um agente de IA (Claude, ChatGPT ou Codex) configurar a API oficial do WhatsApp (Cloud API) por conversa. Você conecta o servidor https://mcp.facebook.com/whatsapp_business_tools no seu cliente, entra com a sua conta de desenvolvedor da Meta e pede em português: "adiciona este número na minha conta do WhatsApp Business e registra na API". O agente cadastra o número, pede o código de verificação, valida, registra, cria templates de mensagem, configura o webhook e manda uma mensagem de teste.
O único passo que o agente não faz sozinho é receber o código de verificação: a Meta manda o código pro número, e alguém precisa ler e entregar. Com um número fixo virtual da Numio, a Meta liga pro número, a Numio atende automaticamente e o código aparece no painel e no seu e-mail. Você cola o código na conversa e o agente termina o registro.
O MCP é uma ferramenta de configuração e teste, não o atendente. Ele não lê as conversas que chegam e a própria Meta diz que não é feito pra envio em escala. Pra ter um agente de IA atendendo clientes no WhatsApp, o número registrado pelo MCP é conectado ao seu sistema (pelo webhook da Cloud API) ou a uma plataforma de atendimento.
O que o MCP da Meta pro WhatsApp Business consegue fazer?
Pela documentação da Meta (lida em 5 de outubro de 2026), as ferramentas se dividem em seis grupos. Todas funcionam só nas empresas que você administra e que você autorizou no login.
| Grupo | O que o agente faz |
|---|---|
| Consulta | Lista as empresas, as contas do WhatsApp Business (WABA) e os números que você administra, com o status de cada um. |
| Cadastro de número | Adiciona o número à conta, pede o código de verificação, valida o código e registra o número na Cloud API. |
| Templates | Lista, cria, edita e apaga templates de mensagem. A aprovação continua sendo da Meta. |
| Envio | Manda texto livre (só dentro da janela de 24 horas de atendimento) ou um template aprovado. Confirma o destino com você antes de cada envio. |
| Webhooks | Define a URL de retorno, o token de verificação e quais eventos sua aplicação recebe. |
| Conta | Forma de pagamento das mensagens, situação da verificação da empresa e um link pra gerar o token permanente da sua integração. |
O que o MCP não faz?
- Não lê as conversas que chegam. Mensagens recebidas vão pro webhook da sua aplicação, não pro agente.
- Não é o seu atendente de IA. Ele configura a API; quem atende o cliente é o sistema ligado ao webhook.
- Não serve pra disparo em volume. A Meta descreve o MCP como ferramenta de desenvolvimento e teste.
- Não age sozinho. Toda ação que muda alguma coisa exige uma pessoa logada; não dá pra deixar rodando num servidor.
- Não fornece o número nem recebe o código. O número é seu, e o código chega nele por SMS ou por ligação.
O MCP está em beta: a Meta avisa que as ferramentas e o comportamento podem mudar, e o acesso está sendo liberado aos poucos.
O que preciso ter antes de começar?
- Uma conta de desenvolvedor da Meta com acesso de administrador (função "gerenciar") a uma empresa no Business Manager.
- Um app com o produto WhatsApp, do qual você é administrador, ligado a essa empresa.
- Os termos de uso da Cloud API do WhatsApp aceitos pra essa empresa.
- Um número livre: que não esteja registrado em nenhuma conta do WhatsApp (app pessoal, app Business ou outra API) e que receba o código por SMS ou por ligação.
- Um cliente de IA compatível: Claude (aplicativo ou Claude Code), ChatGPT ou Codex.
O número da Numio não recebe SMS. Ele recebe o código por ligação, e a Numio mostra o código pra você. Veja o número virtual recebe SMS?.
Como conectar o MCP no Claude, no ChatGPT ou no Codex?
O endereço do servidor é o mesmo em todos os clientes. O login é feito com a conta da Meta (OAuth), então nenhum token aparece na conversa. O login cai quando o cliente reinicia; é só entrar de novo.
Endereço do servidor (Streamable HTTP)
https://mcp.facebook.com/whatsapp_business_tools- Claude (aplicativo): Configurações › Conectores › Adicionar conector personalizado. Nome:
WhatsApp Business Tools; URL: o endereço acima. - ChatGPT: Configurações › Plugins › Adicionar novo plugin. Mesmo nome e URL, autenticação OAuth.
- Codex (aplicativo): Configurações › Servidores MCP › Adicionar servidor › Streamable HTTP. Mesmo nome e URL, autenticação OAuth.
Aplicativo em inglês? Os caminhos são Settings › Connectors › Add custom connector (Claude), Settings › Plugins › Add new plugin (ChatGPT) e Settings › MCP Servers › Add servers (Codex).
Claude Code (terminal). Depois rode /mcp e escolha whatsapp_business_tools pra fazer o login.
claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_toolsPasso a passo: registrar um número da Numio na Cloud API pelo agente
1. Contrate o número
Em comprar número, escolha o DDD e o número, pague e valide a identidade. O número fica pronto no mesmo dia. Não ative ele no app do WhatsApp: o número precisa estar livre pra entrar na API.
2. Peça ao agente pra adicionar o número
Com o MCP conectado, diga qual empresa e qual conta usar e informe o número com +55 e DDD. O agente vai pedir o nome de exibição, que passa pela revisão da Meta.
3. Abra a ativação no painel da Numio
No painel, abra o número e deixe a tela de ativação aberta. É nela que o código aparece.
4. Peça o código por ligação de voz
Diga ao agente pra mandar o código por ligação de voz, não por SMS. Se ele responder que só consegue por SMS, peça o código por ligação no WhatsApp Manager, na lista de números da conta, e siga para o próximo passo.
5. Entregue o código ao agente
A Meta liga em até 5 minutos; a Numio atende e mostra o código de 6 dígitos no painel e no seu e-mail. Cole o código na conversa e o agente valida o número. No painel, toque em "Ouvi e digitei o código".
6. Registre o número na API
Peça "registra este número pra mensagens". O registro pede um PIN de 6 dígitos (a verificação em duas etapas do número). Guarde esse PIN: ele é pedido de novo se você registrar o número em outro lugar.
7. Configure o webhook e teste
Peça pra configurar o webhook com a URL da sua aplicação, criar um template e mandar uma mensagem de teste pro seu celular. Pra integração definitiva, peça o link do token permanente.
Que pedidos posso fazer ao agente?
Pedidos em português funcionam. Alguns exemplos, na ordem do passo a passo:
Exemplos de pedidos
Lista as empresas e as contas do WhatsApp Business que eu administro.
Adiciona o número +55 11 3000-0000 na conta "Atendimento", com o nome de exibição "Loja Exemplo".
Manda o código de verificação para esse número por ligação de voz, não por SMS.
O código é 123456. Valida o número.
Registra o número para mensagens.
Configura o webhook para https://exemplo.com.br/webhook/whatsapp com o campo messages.
Cria um template de confirmação de pedido em português, categoria utilidade.
Manda o template de teste para o meu celular, +55 11 99999-9999.Por que o número precisa receber ligação?
Porque é o único jeito de um número fixo provar que é seu. A Meta verifica todo número antes de liberar a API, mandando um código de 6 dígitos por SMS ou por ligação de voz. Número fixo não recebe SMS, então a verificação é pela ligação: a Meta liga e dita o código.
Num número fixo comum, alguém teria que estar perto do telefone pra atender e anotar. No número da Numio, a ligação é atendida automaticamente e o código vira texto no painel. Depois de verificado, o número tem os mesmos recursos de um celular verificado por SMS: a API não vê como o código chegou. Mais detalhes em número virtual pra API do WhatsApp.
Posso usar o mesmo número no app do WhatsApp e na API?
Não ao mesmo tempo, salvo nos casos de coexistência que alguns provedores oficiais (BSPs) oferecem. Um número registrado na Cloud API sai do app do WhatsApp no celular. Se o número já está ativo no app, faça backup e apague a conta no app antes de pedir ao agente pra registrar.
Se você quer o número no app do WhatsApp Business do celular, não precisa do MCP: siga o passo a passo de número virtual pro WhatsApp Business.
Quero vários números ou embutir isso no meu produto
Uma conta do WhatsApp Business aceita vários números, e o agente repete o passo a passo pra cada um. Na Numio você contrata até 20 números no mesmo pedido, a partir de R$ 16,90/mês cada no anual.
Pra quem constrói produto (CRM, plataforma de atendimento, revenda), a API de parceiros da Numio contrata o número em nome do cliente e devolve o código de verificação por API (GET /api/v1/dids/{id}/whatsapp-verification). Assim o seu sistema compra o número na Numio e lê o código, enquanto o MCP ou a Cloud API cuidam do registro na Meta.
Perguntas frequentes
É um servidor MCP oficial da Meta, o WhatsApp Business Tools MCP, lançado em beta em 15 de setembro de 2026. Ele deixa um agente de IA como Claude, ChatGPT ou Codex configurar a Cloud API do WhatsApp por conversa: cadastrar e registrar números, criar templates, configurar webhooks e mandar mensagens de teste.
https://mcp.facebook.com/whatsapp_business_tools, com transporte Streamable HTTP e login pela conta de desenvolvedor da Meta (OAuth).
Não. O MCP configura e testa a API. Ele não lê as mensagens que chegam e não é feito pra envio em escala. Pra ter um agente de IA atendendo clientes, o número registrado é ligado ao webhook do seu sistema ou a uma plataforma de atendimento.
A documentação da Meta só mostra o exemplo por SMS. Peça ao agente por ligação de voz; se ele só conseguir por SMS, peça o código por ligação no WhatsApp Manager e entregue o código ao agente pra ele validar o número.
Sim. O número precisa estar livre e receber o código de verificação. O número fixo virtual da Numio recebe o código por ligação: a Numio atende automaticamente e mostra o código no painel e no e-mail.
O MCP usa a Cloud API da Meta, que exige uma empresa no Business Manager e verificação de empresa pra liberar o nome de exibição e limites maiores de envio. Pra contratar o número na Numio, pessoa física também pode.
A Meta não anunciou cobrança pelo MCP. As mensagens enviadas pela Cloud API seguem a tabela de preços da Meta, e por isso a configuração inclui uma forma de pagamento.