WhatsApp MCP: o que é e como o agente fala com o WhatsApp
Fundador e CEO da Chatsac5 min de leitura
Quem busca whatsapp mcp quase nunca quer um tutorial genérico de protocolo. Quer o agente que já usa no computador (Claude, ou outro cliente MCP) enxergar a caixa de WhatsApp da empresa sem montar um Frankenstein de QR, ponte local e esperança.
O que você vai ver neste guia
- O que é WhatsApp MCP, em uma frase que dá para citar
- O que essa busca não é (claude mcp, n8n mcp, cursor mcp sem WhatsApp)
- Como o MCP se encaixa na API oficial do WhatsApp
- A diferença entre servidor MCP de GitHub (sessão Web) e MCP em cima da Cloud API
- O que o agente pode ler, o que ele não envia sozinho, e para onde ir depois: /mcp
O que é WhatsApp MCP?
WhatsApp MCP é a junção de duas peças que o mercado ainda mistura.
A primeira é o Model Context Protocol, padrão aberto para um aplicativo de IA se conectar a sistemas externos. A analogia oficial do projeto é USB-C: um conector só, vários aparelhos. O cliente (Claude, Cursor, VS Code, outros que falem MCP) não precisa de um conector proprietário por ferramenta.
A segunda é o WhatsApp da empresa, o número com WABA e Cloud API. Sem essa perna, o MCP até pode existir. Só não é operação. É demo.
Juntas, as duas peças viram isto: o agente ganha ferramentas (listar conversas, abrir um fio, localizar contato, preparar um envio) sobre a caixa que o time já atende. O protocolo é o fio. O WhatsApp é o sistema. Quem autoriza o disparo continua sendo uma pessoa.
Se a sua pergunta era "mcp whatsapp" no Google, é desta família. Se era só "mcp server", você está no tutorial do protocolo, não neste post.
WhatsApp MCP é a mesma coisa que Claude MCP ou n8n MCP?
Não, e essa confusão queima tráfego e expectativa.
- claude mcp / cursor mcp / n8n mcp: o cliente de IA (ou o n8n) falando MCP. O sistema do outro lado pode ser arquivo, banco, GitHub, calendário. WhatsApp não entra na query.
- whatsapp mcp / mcp whatsapp: o sistema do outro lado é o WhatsApp.
- agente de IA no WhatsApp: o bot que conversa com o cliente na caixa. Já tem dono no blog, o guia de melhor IA para WhatsApp e o de IA para atendimento. Não abra um segundo slug para essa intenção.
Um jeito curto de guardar: MCP é como o agente do operador pega ferramenta. Chatbot e agente de atendimento são como a empresa responde o lead. Os dois podem coexistir no mesmo número. Não são o mesmo produto.
O spoke deste cluster, Claude WhatsApp, aprofunda só a query do Claude. Este pillar segura o protocolo.
Como o WhatsApp MCP se conecta à API oficial?
O desenho que opera pela API oficial é este, nesta ordem:
- Número da empresa na WhatsApp Business Platform (Cloud API), com WABA.
- Plataforma ISV (a Chatsac) operando conversa, contato, template e fila.
- Servidor MCP em cima desse workspace, não em cima de uma sessão de WhatsApp Web.
- Cliente de IA autenticado no MCP.
- Envio no WhatsApp do cliente só depois de aprovação humana.
A Cloud API é o canal que a Meta documenta para mensagem programática: texto, mídia, interativos, template, webhook. O MCP não substitui isso. Ele traduz a caixa já autorizada para a linguagem que o agente já sabe chamar (tools, resources).
Quem pula o passo 1 e aponta o MCP para uma ponte que imita o WhatsApp Web (QR no servidor, biblioteca tipo whatsmeow) está no mesmo terreno da API WhatsApp não oficial: viola a política comercial do WhatsApp. Repositórios públicos desse tipo existem, inclusive o whatsapp-mcp de referência no GitHub. São úteis para entender o protocolo. Não são o caminho de uma PME que não pode perder o número.
Qual a diferença entre MCP de GitHub e MCP na Cloud API?
| Sessão Web / QR (típico no GitHub) | Cloud API + MCP (operação) | |
|---|---|---|
| Como autentica | Pareamento de WhatsApp Web no servidor | WABA e token da Cloud API, via BSP/ISV |
| O que a Meta autoriza | Fora da política de Business Platform | Canal oficial de mensagem programática |
| Quem segura o número | A sessão. Caiu o QR, caiu a caixa | A conta WABA, independente do celular |
| Envio | O agente dispara se a tool deixar | Na Chatsac, só depois de aprovação humana |
| Serve para | Demo, hobby, estudo do protocolo | Empresa que já atende no número oficial |
| Para onde ir | README do repositório | Página /mcp da Chatsac |
O SERP de whatsapp mcp hoje é README. Este post não tenta ganhar o GitHub no volume. Tenta ser a resposta de empresa: o que o protocolo faz, o que a Meta autoriza, e onde a Chatsac coloca o agente.
O que o agente pode (e não pode) fazer no WhatsApp via MCP?
No workspace da Chatsac, o recorte público é estreito de propósito.
Pode (leitura): ver conversas e contatos de um workspace, abrir um fio, localizar template, olhar o que está aberto. O operador pede em linguagem natural: "quais conversas estão paradas desde ontem".
Pode (escrita, com trava): preparar um envio. A trava é humana. O agente não vira disparador.
Não é: o livro de todos os tenants, fatura, MRR, "o MCP da Chatsac" no singular como se fosse um conector só. São dois recortes. O Nexus MCP enxerga conversas, contatos e ações de um workspace. O Premium MCP enxerga o portfólio (o que cada sistema tem ligado). Um não substitui o outro. Detalhe de conexão, auth e recorte está em /mcp, não neste artigo.
Também não é: ChatGPT já vindo pronto com o conector. Compatibilidade de cada host (Claude, Claude Code, outros) muda. O que este texto afirma é o protocolo e o recorte de produto, não uma lista de lojas com "plugou e funcionou".
Como a Chatsac expõe o WhatsApp MCP?
Três regras de operação, iguais no produto e neste cluster:
- Destino público é chatsac.com/mcp. Explainer, não GitHub, não hostname interno.
- Envio no WhatsApp do cliente só depois de aprovação humana.
- O MCP senta em cima da API oficial, não em cima de QR.
Se você chegou aqui porque o agente já opera o restante da empresa (arquivo, CRM interno, calendário) e a caixa de WhatsApp ainda é um ilhéu, o próximo clique é o explainer. Se você chegou porque quer IA respondendo o lead na conversa, o post certo é o de melhor IA para WhatsApp, não este.
Para o caso específico do Claude, o spoke é Claude WhatsApp: como o Claude opera o número via MCP.
Se a operação ainda nem tem Cloud API, comece pelo guia da API oficial e pela página de API. MCP em cima de número no app grátis é o atalho que este pillar recusa.
