Servidor MCP do WhatsApp: conecte agentes de IA a WhatsApp e SMS
Como um servidor MCP do WhatsApp deixa Claude, Cursor e outros agentes de IA enviarem WhatsApp e SMS com segurança: setup, guardrails, consentimento e usos.
Por OmniChannels.ai Editorial Team · Revisado por BroadNet Messaging Solutions Team
Integração
Resposta curta
Um servidor MCP do WhatsApp expõe operações de mensageria como ferramentas que um agente de IA pode descobrir e chamar por meio do Model Context Protocol. Com o servidor MCP da OmniChannels.ai em https://mcp.broadnet.me/mcp, um cliente como o Claude Code ou o Cursor se autentica com um token Bearer e pode enviar mensagens de SMS e WhatsApp, listar templates e ler relatórios de entrega. O agente age com as permissões da sua conta, então os guardrails importam.
Nesta página
- O que é um servidor MCP do WhatsApp?
- Como funciona o servidor MCP da OmniChannels.ai?
- Como conecto o Claude, o Cursor ou outro cliente?
- O que um agente de IA pode fazer com WhatsApp e SMS?
- Como evito que um agente de IA envie mensagens às pessoas erradas?
- Que regras de WhatsApp e SMS ainda se aplicam?
- Exemplo prático: uma equipe de suporte adiciona um assistente de status de entrega
- Quando o MCP é a escolha errada?
- Como a OmniChannels.ai ajuda
Pontos principais
- MCP (Model Context Protocol) é um padrão aberto que permite a um cliente de IA listar e chamar ferramentas em um servidor remoto; o servidor da OmniChannels.ai mapeia suas ferramentas para a mesma API REST que o seu código usaria.
- Um endpoint, https://mcp.broadnet.me/mcp via Streamable HTTP, e um cabeçalho, Authorization: Bearer <token>, conectam Claude Code, Cursor, VS Code, Claude Desktop e outros clientes.
- Um agente com ferramentas de envio pode enviar mensagens a pessoas reais e gastar saldo real, então habilite apenas as ferramentas de que ele precisa e exija confirmação humana antes de qualquer envio.
- As regras do WhatsApp continuam valendo para agentes: opt-in, templates aprovados fora da janela de atendimento ao cliente e regras de sender ID para SMS.
- Use uma chave temporária durante os experimentos e uma chave permanente apenas para um agente de produção revisado.
Este guia é para desenvolvedores e líderes técnicos que querem que um agente de IA envie ou acompanhe mensagens de WhatsApp e SMS sem escrever à mão cada integração. Ele explica o que é um servidor MCP do WhatsApp, como conectar um, quais guardrails definir antes de o agente tocar em clientes reais e onde o MCP é a ferramenta errada.
O que é um servidor MCP do WhatsApp?
Um servidor MCP do WhatsApp é um serviço que expõe operações de mensageria, como enviar um template ou ler um relatório de entrega, como ferramentas que um cliente de IA pode descobrir e chamar. Ele fala o Model Context Protocol (MCP), um padrão aberto para conectar assistentes de IA a ferramentas e dados externos.
Sem o MCP, dar a um assistente a capacidade de enviar uma mensagem significa escrever uma função personalizada para cada modelo ou framework. Com o MCP, o cliente se conecta a uma única URL, pergunta ao servidor quais ferramentas existem e as chama quando o pedido de um usuário precisa delas. Nosso verbete do glossário sobre servidores MCP traz a definição curta.
Dois pontos são fáceis de perder:
- O MCP não contorna as regras do WhatsApp. O servidor chama as mesmas operações da plataforma WhatsApp Business que qualquer outra integração, então templates, opt-in e a janela de atendimento ao cliente continuam valendo.
- O agente é tão seguro quanto o seu token. As ferramentas agem com as permissões, os sender IDs e o saldo da chave que você fornece.
Como funciona o servidor MCP da OmniChannels.ai?
É um servidor MCP remoto em um único endpoint, autenticado com um token Bearer. Suas ferramentas mapeiam para a mesma API REST documentada na documentação para desenvolvedores, então o que um agente pode fazer é o que o seu próprio código poderia fazer com esse token.
| Configuração | Valor |
|---|---|
| Endpoint | https://mcp.broadnet.me/mcp |
| Transporte | MCP Streamable HTTP |
| Autenticação | Authorization: Bearer <token> em toda requisição |
| Atua sobre | Sua conta: canais, sender IDs, templates e saldo |
| Áreas típicas de ferramentas | Envio em cada canal (SMS, WhatsApp, RCS, Telegram, Messenger, Instagram, Push), listagem e envio de templates de WhatsApp, leitura de relatórios de entrega |
A lista exata de ferramentas depende da versão do servidor e da sua conta, então leia-a no seu cliente em vez de em um post de blog. Uma requisição sem token é recusada no nível do protocolo, o que é um bom teste rápido.
Como conecto o Claude, o Cursor ou outro cliente?
Você adiciona o endpoint e o cabeçalho à configuração MCP do seu cliente e mantém o token em uma variável de ambiente ou em uma entrada secreta, para que ele nunca vá parar em um repositório.
Conecte em cinco passos
- Obtenha uma chave. No portal de administração, abra Integrações, depois Integração MCP, e escolha Obter chave temporária. Uma chave permanente para um agente de produção vem do administrador da sua conta ou da conta master.
- Guarde-a como segredo. Por exemplo, exporte-a como
BROADNET_TOKENno seu shell. - Adicione o servidor ao seu cliente. Para o Claude Code:
claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp \
--header "Authorization: Bearer $BROADNET_TOKEN"
- Verifique as ferramentas. No Claude Code, o comando
/mcpmostra o servidor e suas ferramentas. No Cursor, no VS Code e no Claude Desktop, a configuração fica no próprio arquivo de configurações MCP do cliente. - Desative o que o agente não precisa, antes do primeiro prompt real.
Os formatos dos clientes mudam entre versões, então os trechos exatos para Cursor, VS Code e Claude Desktop estão na documentação, com páginas passo a passo para o Claude Code, o Cursor e o n8n. A própria documentação de MCP do Claude Code é a referência para seus comandos.
Para testar sem nenhum cliente, envie a requisição MCP initialize ao endpoint com o seu token. A documentação mostra o comando curl completo.
O que um agente de IA pode fazer com WhatsApp e SMS?
Tudo o que as ferramentas conectadas permitirem: enviar, consultar e reportar. O valor prático está nas tarefas flexíveis, em linguagem humana, em torno da mensageria, e não nos fluxos de alto volume que você deve manter em código.
Exemplos de prompts que combinam com um agente:
- "Envie um SMS de OmniDemo para 447700900123 dizendo que o técnico chega às 15h."
- "Liste meus templates de WhatsApp aprovados em árabe."
- "Envie o template de WhatsApp
order_updatepara 971500000000 com o número de pedido INV-400." - "Quantas mensagens da campanha de extratos de ontem falharam, e por quê?"
- "Redija um card de RCS para o nosso lançamento de outono e mostre-o a mim antes de enviar qualquer coisa."
Bons casos de uso, em ordem aproximada de segurança:
| Caso de uso | Ferramentas necessárias | Risco |
|---|---|---|
| Dúvidas de entrega da equipe de suporte ("esse cliente recebeu o SMS?") | Ferramentas somente de leitura de relatórios | Baixo |
| Assistente de desenvolvedor que envia mensagens de teste aos seus próprios números enquanto constrói uma integração | Ferramentas de envio, apenas números de teste | Baixo a médio |
| Consulta de templates e redação de textos para revisão | Ferramentas de listagem de templates | Baixo |
| Assistente de operações que envia avisos pontuais depois que um humano aprova | Ferramentas de envio mais confirmação | Médio |
| Agente autônomo enviando a clientes | Ferramentas de envio, sem confirmação | Alto; exige um desenho revisado |
Um assistente interno que responde a dúvidas de entrega não precisa de nenhuma ferramenta de envio. Remova-as.
Como evito que um agente de IA envie mensagens às pessoas erradas?
Trate o agente como um funcionário novo com um celular da empresa: permissões limitadas, supervisão no início e um registro do que ele fez. A documentação lista as salvaguardas; aqui estão elas com a justificativa.
- Privilégio mínimo. Habilite apenas as ferramentas de que a tarefa precisa. Um agente que responde a dúvidas de entrega não precisa de ferramentas de envio; um que envia OTPs não precisa de ferramentas de templates nem de conta.
- Humano no circuito. Configure o cliente para pedir confirmação antes de qualquer ferramenta que envie e sempre antes de envios a muitos destinatários. No Claude Code, as regras de permissão se referem às ferramentas MCP como
mcp__<server>__<tool>, então você pode deixar as ferramentas de leitura rodarem livremente enquanto as de envio ainda pedem confirmação. - Chaves temporárias para experimentos. Use uma chave temporária nos testes e uma chave permanente apenas para um agente de produção revisado.
- Números de teste primeiro. Aponte os novos agentes para os seus próprios números verificados até confiar no comportamento deles.
- Acompanhe os logs. Revise o que o agente enviou nos seus relatórios de entrega, sobretudo nas primeiras semanas.
- Revogue rápido. Se uma chave for exposta, peça ao administrador da sua conta ou ao nosso suporte que a revogue e emita uma nova.
- Respeite o consentimento. Os agentes devem seguir as mesmas regras de opt-in, sender ID e canal que qualquer outro remetente.
A injeção de prompt merece uma menção especial. Se um agente lê texto não confiável, como uma mensagem de cliente recebida ou uma página web, esse texto pode conter instruções. Não dê a um agente que lê conteúdo não confiável acesso sem supervisão a ferramentas de envio. Mantenha a leitura e o envio em etapas separadas, com uma pessoa aprovando o envio.
Que regras de WhatsApp e SMS ainda se aplicam?
Todas. O agente é só mais um remetente.
- Opt-in. A Política de Mensagens Comerciais do WhatsApp da Meta exige que as pessoas tenham feito opt-in para ouvir de você. Um agente capaz de enviar mensagem a qualquer pessoa de uma planilha não muda isso.
- Templates e a janela. Mensagens livres de WhatsApp só são possíveis dentro da janela de atendimento ao cliente; fora dela é preciso um template aprovado. Veja nosso guia da janela de atendimento ao cliente de 24 horas e a documentação da API de WhatsApp.
- Custo. A Meta cobra por mensagem entregue, por categoria, e um agente pode gerar volume rapidamente. Limite o que ele pode enviar e simule os custos com nossa calculadora de preços do WhatsApp.
- Sender IDs de SMS. O SMS exige um sender ID registrado em muitos países. O agente usa os sender IDs aprovados na sua conta.
Exemplo prático: uma equipe de suporte adiciona um assistente de status de entrega
A "Souq Rafiq" (sintética), uma varejista online dos Emirados Árabes Unidos, quer que sua equipe de suporte responda "o cliente recebeu a nossa mensagem?" sem abrir painéis.
- Configuração: um administrador gera uma chave temporária e conecta o Claude Desktop ao servidor MCP para dois líderes de suporte.
- Ferramentas: apenas as de leitura de relatórios estão habilitadas. As ferramentas de envio estão desligadas.
- Uso: um líder pergunta: "Quantas mensagens da campanha de extratos de ontem falharam, e por quê?". O agente lê o relatório de entrega e resume os motivos por status.
- Revisão: após duas semanas, o administrador confere os relatórios de entrega, confirma que nada foi enviado e solicita uma chave permanente para um pequeno assistente de produção.
- Próximo passo: para que o assistente reenvie um aviso perdido, a equipe habilita uma ferramenta de envio com a confirmação ativada e a limita antes a um grupo de números de teste.
Quando o MCP é a escolha errada?
Use a API REST, a especificação OpenAPI ou o SDK para tudo que for determinístico e de alto volume.
- Fluxos de OTP e transacionais. Um código de login deve vir de um código que você controla, não de um modelo que pode parafraseá-lo. Veja o quickstart da API REST.
- Campanhas em massa. Use as ferramentas de campanha ou os endpoints em massa com um arquivo revisado, não um prompt conversacional.
- Chat com clientes sem supervisão. Um agente voltado ao cliente precisa de um fluxo de conversa desenhado, conhecimento, transferência para humanos e monitoramento. Isso é um produto de agente de IA, não uma sessão MCP de desenvolvedor.
- Limites deste guia. Os formatos de configuração dos clientes e a lista de ferramentas mudam entre versões. Confirme ambos na documentação e no seu cliente.
Como a OmniChannels.ai ajuda
A OmniChannels.ai oferece o servidor MCP em https://mcp.broadnet.me/mcp junto com a API REST em https://api.broadnet.me, com um único modelo de token Bearer para SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, e-mail e Push. A BroadNet é uma Meta Business Solution Provider oficial, e seu produto de agentes de IA oferece suporte a inglês e árabe, com transferência para um atendente humano e uso de ferramentas via MCP; veja agentes de IA. O acesso de teste vai para os seus próprios números verificados. Comece pelo guia de MCP e pela visão geral para desenvolvedores.
Perguntas frequentes
O que é um servidor MCP?
Um servidor MCP é um programa que oferece ferramentas a clientes de IA por meio do Model Context Protocol, um padrão aberto. O cliente se conecta, lista as ferramentas e as chama quando o pedido de um usuário precisa delas. Um servidor MCP remoto roda na infraestrutura do provedor, então você se conecta a uma URL e se autentica em vez de instalar código.
O Claude consegue enviar mensagens de WhatsApp?
O Claude não alcança o WhatsApp sozinho, mas um cliente Claude com suporte a MCP pode chamar as ferramentas de um servidor MCP de mensageria. Com o servidor MCP da OmniChannels.ai conectado, o Claude Code ou o Claude Desktop pode enviar um template de WhatsApp aprovado ou um SMS a partir da sua conta, sujeito às suas configurações de ferramentas e às regras da Meta.
É seguro deixar um agente de IA enviar mensagens?
Só é seguro com guardrails. Habilite o conjunto mínimo de ferramentas, exija confirmação humana nos envios, teste antes com os seus próprios números verificados, use chaves temporárias durante os experimentos e revise os relatórios de entrega. O agente age com as permissões do seu token, então pode gastar saldo e alcançar pessoas reais se você permitir.
Preciso de um template de WhatsApp para um agente enviar mensagem a alguém?
Sim, fora da janela de atendimento ao cliente. A Meta permite mensagens livres apenas enquanto uma janela aberta pelo cliente estiver ativa; do contrário, a empresa precisa enviar um template aprovado. Um agente pode listar seus templates aprovados e enviar um pelo nome, mas não pode inventar na hora um novo template aprovado.
O servidor MCP substitui a API REST?
Não. As ferramentas mapeiam para a mesma API REST, com o mesmo token e as mesmas permissões. Use o MCP quando um cliente de IA deve descobrir e chamar operações por conta própria e use a API REST, a especificação OpenAPI ou o SDK para código de produção determinístico, como fluxos de OTP e notificações de pedidos.
Como obtenho uma chave MCP?
Entre no portal de administração, abra Integrações e depois Integração MCP e escolha Obter chave temporária. Uma chave permanente para um agente de produção é emitida pelo administrador da sua conta ou pela conta master. O acesso de teste vai para os seus próprios números verificados, e não há cadastro self-service instantâneo.
Fontes
Continue lendo
Mais guiasIntegração
Enviar mensagem de WhatsApp por API: cURL, Node, Python, PHP
Como enviar mensagem de WhatsApp por API: exemplos funcionais em cURL, Node.js, Python e PHP para templates e mensagens de sessão, além de rastreamento e erros.
10 min de leitura
Integração
Webhooks do WhatsApp: eventos, segurança e novas tentativas
Como funcionam os webhooks do WhatsApp: eventos de mensagem e status, handler confiável, assinatura da Meta, retries, idempotência e eventos perdidos.
10 min de leitura
Atendimento ao cliente
Agente de IA no WhatsApp para atendimento: design e regras
Como desenhar um agente de IA no WhatsApp para atendimento: conhecimento, guardrails, transferência para humano, árabe e inglês e termos de IA da Meta.
10 min de leitura
