WhatsApp Business Tools MCP

npx add-mcp 'https://mcp.facebook.com/whatsapp_business_tools'

Para desenvolvedores que estão criando soluções na Plataforma WhatsApp Business (Cloud API) — o servidor MCP WhatsApp Business Tools permite que seu agente de IA e assistente de IDE gerenciem e depurem sua integração com o WhatsApp Business em um só lugar. Ele permite que um agente descubra as empresas e contas do WhatsApp que você administra, integre e registre números de telefone, crie e gerencie modelos de mensagem, configure webhooks e envie mensagens — agindo como você, nos aplicativos e empresas que você administra.

Observação: O servidor MCP WhatsApp Business Tools está sendo disponibilizado gradualmente e pode não estar disponível para todos ainda. A interface e o conjunto de ferramentas estão em versão beta e podem mudar.

Visão geral

A tabela a seguir resume os detalhes do servidor:

Atributo	Valor
Nome do servidor	WhatsApp Business Tools
Transporte	HTTP Streamable
Endpoint	https://mcp.facebook.com/whatsapp_business_tools
Autenticação	Login de conta de desenvolvedor Meta (OAuth)
Status	Beta — a interface e o conjunto de ferramentas podem mudar

Pré-requisitos

O servidor atua sobre seus próprios ativos, portanto, antes que um agente possa usar a maioria das ferramentas, você precisa:

• Acesso de administrador a uma empresa que você deseja gerenciar (a função MANAGE).
• Um aplicativo habilitado para WhatsApp do qual você é administrador, conectado a essa empresa — um aplicativo com o caso de uso WhatsApp Business Messaging (ou o produto WhatsApp em um aplicativo mais antigo). Você deve ter acesso de administrador no aplicativo, não apenas na empresa.
• Termos de Serviço da WhatsApp Business Cloud API aceitos para essa empresa. O envio de mensagens e o registro de números de telefone são bloqueados até que um administrador os aceite.

Se algum pré-requisito estiver ausente, a ferramenta retorna um erro acionável que informa o que corrigir e fornece um link para a página onde você pode corrigir.

Configure seu IDE ou cliente de agente

O servidor MCP WhatsApp Business Tools é um servidor remoto. Clientes que suportam servidores MCP remotos podem se conectar ao endpoint diretamente. Para clientes que suportam apenas servidores locais (stdio), use a ponte mcp-remote, que faz proxy do servidor remoto via stdio.

Configure seu cliente usando uma das seções abaixo e, em seguida, conclua o login OAuth para autenticar.

Claude Code e Desktop

Claude Code — execute o seguinte comando para adicionar o servidor:

claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools

Em seguida, execute /mcp em uma sessão e selecione whatsapp_business_tools para autenticar.

Claude Desktop — abra Configurações > Conectores > Adicionar conector personalizado e defina:

• Nome: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools

OpenAI Codex App e ChatGPT

Codex App — abra Configurações (o ícone de engrenagem, no canto inferior esquerdo) > Servidores MCP > Adicionar servidores, escolha Streamable HTTP e defina:

• Nome: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Autenticação: OAuth

Clique em Autenticar e conclua o login OAuth.

ChatGPT — abra Configurações > Plugins > Procurar plugins, clique no + no canto superior direito para adicionar um novo plugin e defina:

• Nome: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Autenticação: OAuth

Salve o plugin e conclua o login OAuth.

Login OAuth

O servidor MCP WhatsApp Business Tools autentica com sua conta de desenvolvedor Meta via OAuth, portanto, o mesmo fluxo de login funciona com todos os clientes.

Fluxo de login

Depois de adicionar o servidor ao seu cliente (consulte Configure seu IDE ou cliente de agente):

1. Inicie a conexão. Muitos clientes iniciam o fluxo OAuth automaticamente quando o servidor é adicionado. Outros exigem que você clique em Conectar ou Autenticar primeiro.
2. Faça login. Seu navegador abre para fazer login com sua conta Meta. Se não abrir automaticamente, copie o link que seu cliente exibe e abra-o manualmente.
3. Conceda acesso. Na tela de consentimento, selecione as empresas e os aplicativos habilitados para WhatsApp aos quais você deseja que o servidor acesse.
4. Confirme. Volte ao seu cliente e verifique sua conexão.

Você precisará concluir o fluxo de login novamente ao reiniciar o cliente.

Escopos

O servidor solicita as seguintes permissões durante o consentimento:

Escopo	Acesso
business_management	Descobrir e agir nas empresas que você administra e que selecionou durante o consentimento.
whatsapp_business_management	Gerenciar contas do WhatsApp Business, números de telefone, modelos de mensagem e webhooks.
whatsapp_business_messaging	Enviar mensagens dos seus números de telefone registrados.

Você pode revisar ou revogar o acesso a qualquer momento em facebook.com > Configurações > Integrações de negócios.

Verifique sua conexão

Depois de adicionar o servidor, confirme que seu agente pode ver as ferramentas:

1. Reinicie o IDE ou o cliente de agente.
2. Peça ao agente para listar as ferramentas que ele tem do servidor whatsapp_business_tools.
3. Execute uma ferramenta de leitura de baixo risco. Por exemplo, peça para listar as empresas que você administra com whatsapp_biz_businesses.

Se o agente relatar nenhuma ferramenta ou um erro de autenticação, verifique novamente a URL do endpoint e confirme se você concluiu o fluxo de login.

Ferramentas

O MCP WhatsApp Business Tools expõe ferramentas com namespace prefixado por whatsapp_biz_. A maioria das ferramentas é limitada a uma empresa que você administra, portanto, uma sessão típica começa listando suas empresas e escolhendo uma. O conjunto de ferramentas está evoluindo durante o beta.

Descoberta

• whatsapp_biz_businesses — Lista as empresas que você administra e que concedeu durante o consentimento. Use esta primeiro para escolher uma empresa. Exemplo: "Liste as empresas que posso gerenciar no WhatsApp."
• whatsapp_biz_accounts — Lista as contas do WhatsApp (e contas de mensagens) sob uma empresa. Exemplo: "Mostre as contas do WhatsApp para a empresa 1234567890."
• whatsapp_biz_phone_numbers — Lista os números de telefone em uma empresa ou conta do WhatsApp, com status e estado de integração. Exemplo: "Liste os números de telefone e seus status para esta empresa."

Integração de números de telefone

• whatsapp_biz_add_phone_number — Adiciona um número de telefone a uma conta do WhatsApp. Exemplo: "Adicione o número de telefone +1 555 010 1234 à minha conta do WhatsApp."
• whatsapp_biz_send_verification_code — Envia um código de verificação para um número de telefone. Exemplo: "Envie um código de verificação por SMS para este número."
• whatsapp_biz_verify_phone_number — Verifica um número de telefone com o código recebido. Exemplo: "Verifique este número com o código 123456."
• whatsapp_biz_register_phone_number — Registra um número verificado para que ele possa enviar e receber. Exemplo: "Registre este número para mensagens."

Modelos de mensagem

• whatsapp_biz_list_templates / whatsapp_biz_get_template — Lista e inspeciona modelos de mensagem em uma conta. Exemplo: "Liste os modelos aprovados para esta conta."
• whatsapp_biz_create_template / whatsapp_biz_update_template / whatsapp_biz_delete_template — Cria, atualiza e exclui modelos de mensagem. Exemplo: "Crie um modelo de marketing chamado order_update em en_US."

Mensagens

• whatsapp_biz_send_message — Envia uma mensagem de texto de formato livre (entregue apenas dentro da janela de atendimento ao cliente de 24 horas) ou uma mensagem de modelo aprovada de um número registrado. Confirma o destino com você antes de enviar. Exemplo: "Envie o modelo order_update para +1 555 010 9999 deste número."

Webhooks

• whatsapp_biz_configure_webhooks — Define a URL de callback e o token de verificação para o tópico do WhatsApp e assina os campos permitidos. Exemplo: "Configure webhooks para esta empresa com callback https://example.com/webhook."
• whatsapp_biz_subscribe_webhook — Assina uma conta do WhatsApp aos webhooks do seu aplicativo para que seus eventos sejam entregues. Exemplo: "Assine esta conta do WhatsApp aos webhooks."

Configuração da conta

• whatsapp_biz_configure_payments — Configura um método de pagamento para que a conta possa enviar mensagens cobráveis. Exemplo: "Ajude-me a configurar pagamentos para esta conta."
• whatsapp_biz_verify_business — Verifica e inicia a verificação da empresa. Exemplo: "Qual é o status da verificação da empresa e como faço para iniciá-la?"
• whatsapp_biz_system_user_token — Obtém um link para gerar um token de acesso de usuário do sistema para sua empresa, para que você possa criar uma solução de mensagens personalizada que chame a WhatsApp Cloud API diretamente. A geração do token ocorre com segurança nas Configurações de Negócios — a ferramenta retorna um link profundo para a página Usuários do sistema, onde você seleciona um usuário do sistema e gera o token. Para saber mais, consulte <a href="/documentation/business-messaging/whatsapp/get-started#step-5-create-a-system-user-and-generate-a-permanent-access-token" target="_blank">Criar um usuário do sistema e gerar um token de acesso permanente</a>. Exemplo: "Dê-me um link para criar um token de acesso de usuário do sistema para esta empresa."

Limites de taxa

As solicitações são limitadas por usuário e por ferramenta para proteger a plataforma. Se você exceder o limite, a ferramenta retorna um erro de limite de taxa; tente novamente após uma breve espera.

Feedback

Se você tiver feedback ou quiser ver mais ferramentas, compartilhe seu feedback.

Relacionados

• Visão geral do MCP
• Documentação da Plataforma WhatsApp Business

---

Índice completo da documentação deste produto: https://developers.facebook.com/documentation/mcp/llms.txt