MCP para WhatsApp: o que é e como usar

MCP para WhatsApp, na busca brasileira, mistura duas coisas que não são a mesma: o protocolo aberto Model Context Protocol e um servidor concreto que um produto expõe. Este artigo explica o conceito com calma e, só depois, o que o Appi AutoZap realmente tem no código hoje — a página pública /mcp, o servidor remoto em https://api.appiautozap.com/functions/v1/inbox-mcp e as chaves geradas em Integrações. O mapa do canal (app grátis e Cloud) continua no guia de automação de WhatsApp.

O que é MCP, em português de gente

MCP é a sigla de Model Context Protocol. É um jeito padronizado de um cliente de IA — Cursor, Claude Desktop, um bot Grok, outro host que fale o protocolo — descobrir ferramentas e chamá-las com JSON-RPC. Em vez de cada fornecedor inventar um plugin proprietário, o cliente pergunta “quais ferramentas você tem?” e o servidor responde com nomes, descrições e parâmetros. O cliente então chama tools/call. Quem decide o que a IA pode fazer não é o modelo: é a chave, o escopo e o servidor.

Pense no MCP como uma tomada. A IA é o aparelho. O WhatsApp da sua empresa não entra no aparelho por mágica: entra se existir um servidor que fale a tomada e um cabo (URL + autenticação). Sem servidor, “MCP para WhatsApp” é só um slide. Com servidor, a IA do seu computador lê a fila da inbox, busca um artigo da base ou pede para um humano assumir — se você ligou essas permissões.

Por que isso aparece junto de WhatsApp

Atendimento brasileiro vive no WhatsApp. A equipe já tem inbox, CRM e agenda. O que o MCP muda não é o cliente final: o cliente continua mandando áudio e “tem horário amanhã?”. O que muda é o lado de dentro. Um operador ou um desenvolvedor pede, no próprio cliente de IA, “quem está esperando resposta?” sem abrir o navegador. A resposta vem das ferramentas, não de um chute do modelo sobre a sua operação.

Isso não substitui o assistente que já responde o cliente no Appi AutoZap. São camadas diferentes. A IA nativa do produto lê a base de conhecimento e fala com o contato no WhatsApp, gastando crédito. O MCP entrega a inbox e o CRM a um cliente de IA que você controla. Misturar as duas frases no comercial — “a IA do WhatsApp é um servidor MCP” — é o tipo de atalho que este texto recusa.

O que o Appi AutoZap oferece de verdade

Existe um servidor MCP remoto, transporte Streamable HTTP, stateless (não exige cookie de sessão MCP). A URL pública depois do deploy da Edge Function inbox-mcp é https://api.appiautozap.com/functions/v1/inbox-mcp. A página MCP para sua IA descreve permissões, exemplos de pedido e o caminho de configuração. A documentação irmã da REST está em /developers/docs.

Autenticação: API Key azp_… e Secret sk_… nos headers X-Api-Key e X-Api-Secret. Quem só aceita um header pode usar Authorization: Bearer azp_…:sk_… ou HTTP Basic com o mesmo par. O Secret aparece uma vez na criação da chave. Depois, só o identificador público fica na lista para revogar. Isso não é um “login Google do MCP”. É chave de workspace.

O plano do Appi AutoZap custa R$ 11.988 por 12 meses (até 12x de R$ 999) e inclui 1 número de WhatsApp pela API oficial da Meta, 3 usuários, CRM, IA nativa com 2.500 respostas, áudio em texto, disparos, REST API e webhooks. Sem cartão para criar a conta; o WhatsApp conecta depois da assinatura. Mais números ou usuários: fale com o suporte. Pagamento: PIX, cartão (até 12x) ou boleto. MCP não é um SKU à parte: usa as mesmas chaves da API. A tela Integrações (/developers, aba API e MCP) é de dono ou admin do workspace e, no código de hoje, exige plano pago — sem plano, aparece o aviso de assinatura em Integrações. Não afirmamos que dá para gerar chave MCP nos sete dias.

Como conectar, no produto

O caminho abaixo é o que a tela faz. Não é um assistente de um clique que “liga o ChatGPT no WhatsApp”.

1. Assine o plano e entre em Integrações com perfil de dono ou admin.
2. Abra a aba API e MCP. Dê um nome à chave. Marque só os escopos necessários. Nenhum escopo vem ligado; criar sem escopo é recusado.
3. Copie a API Key e o Secret. Guarde o Secret fora do repositório.
4. No Cursor, mescle o bloco mcpServers em ~/.cursor/mcp.json com a URL e os headers. No Claude Desktop, o painel oferece um bloco com npx e a ponte mcp-remote@0.15.2 (transporte http-only, Node.js LTS). Para outro cliente, há um modelo genérico Streamable HTTP — não existe um JSON universal para todos os hosts.
5. Confira tools/list. Só aparecem ferramentas que a chave pode chamar. GET sem chave não lista nomes de ferramentas.

O botão de copiar configuração com credenciais só existe durante a revelação inicial. Fechar a tela, recarregar ou trocar de workspace descarta essa cópia. Isso é proposital.

Ferramentas e escopos (catálogo, não promessa extra)

O painel agrupa permissões canônicas. Conversas e mídia: listar conversas, ler histórico, enviar texto, ligar/desligar a IA, listar e enviar templates da Meta, marcar espera humana, atribuir, anotar, encerrar, enviar imagem/áudio/documento e enviar mídia por URL ou Storage. Contatos: buscar, ver, mover etapa, tag, nota. Agenda: disponibilidade, listar, criar, reagendar, cancelar, além da agenda do contato e horários livres. Handoff: ler status, transferir para humano, retomar. Base de conhecimento: buscar, listar, ler, criar, editar, remover artigos. Insights: resumo da conversa, fila de espera, resumo do dia. Apollo: busca de leads, se a operação usa essa integração. Sentinela é leitura restrita a chave de administrador da plataforma — chave comum não recebe.

No MCP, exemplos de nomes de ferramenta que o servidor expõe quando o escopo está ligado: list_conversations, read_messages, send_message, toggle_ai, list_templates, send_template, send_media, get_handoff_status, transfer_to_human, resume_handoff, search_knowledge, summarize_conversation, list_waiting_conversations, summarize_day. Cada uma espelha um endpoint REST. Não inventamos aqui um construtor visual, nem “MCP que dispara campanha de lista fria”, nem Instagram.

Janela de 24 horas na Cloud API

Se o número está na API oficial WhatsApp Cloud da Meta, texto livre e mídia só entram com a janela de atendimento aberta: 24 horas após a última mensagem inbound daquele contato naquela conexão. Fora da janela, send_message e mídia respondem que a janela fechou; o caminho é template aprovado, com o escopo de template ligado. Número continua sujeito a denúncia e política da Meta. Detalhes de custo do plano: R$ 11.988 por 12 meses (até 12x de R$ 999). Tarifas de mensagem da Meta são da Meta, na WABA.

MCP não é a API oficial da Meta

Três portas, três nomes. A Cloud API é o canal do WhatsApp na infraestrutura da Meta. A REST do AutoZap e o MCP são o seu sistema (ou o seu cliente de IA) falando com o workspace AutoZap. Um desenvolvedor que “quer a API do WhatsApp” pode estar pedindo a Cloud, a REST, o token da instância ou o MCP. Se a reunião não separa isso, alguém vai colar a URL do Graph no Cursor e achar que o produto quebrou. O post API do WhatsApp: oficial vs não oficial e o de WhatsApp Business API separam canal e produto. Este H1 segura “MCP para WhatsApp”.

O que o MCP não faz neste código

Não abre o WhatsApp Web por QR para o Claude “virar atendente” num computador desatendido. Não é Baileys, não é whatsapp-web.js, não é um gateway de WhatsApp exposto como MCP. Não prometemos integração nativa com n8n ou Make; REST e webhooks existem para quem monta o próprio fluxo. Não há depoimento de “redução de 80% no tempo do desenvolvedor”. Não há estrela de loja. Sentinela não vira ferramenta de chave comum. Upload genérico para bucket arbitrário não existe: mídia por Storage só nos buckets e prefixos do workspace.

Segurança que o comercial costuma pular

Uma chave, um workspace. Limite por minuto. Log de chamadas MCP. Revogação imediata. Escopos de escrita e envio começam desligados. Idempotência em envios e em várias escritas: a mesma chave de operação com o mesmo payload devolve o recibo, sem disparar o gateway de novo. Texto de insights oculta dados pessoais conhecidos do lead. Isso não é anonimato universal de toda frase livre. Trate o Secret como senha. Não cole o Secret em issue pública nem em captura de tela do onboarding.

Fila, base e handoff — o que pedir de verdade

Pedidos que cabem no produto, se a permissão estiver ligada: “quem espera resposta, há quanto tempo?”; “busque na base a política de troca”; “passe esta conversa para um humano, prioridade alta, com um motivo”. Pedidos que não cabem: “manda mil templates de marketing para a planilha anexada”; “inventa um desconto de 40%”; “abre o grupo da família e responde”. A ferramenta de insights devolve trecho ocultado, não um dump de CPF. A busca da base devolve artigo com fonte; conteúdo da base é referência, não instrução secreta para o agente ignorar a lei.

Áudio no histórico

Mensagens de áudio no histórico podem trazer transcrição (quando o motor já rodou) e uma URL assinada de curta duração do arquivo, se ele ainda existe no Storage do workspace. Isso serve para um cliente MCP resumir um recado sem fingir que “ouviu” o ogg. Transcrição pendente não é garantia de que uma tentativa ainda está no forno. URL nula não autoriza caçar o arquivo em outro bucket.

Quanto custa “ter MCP”

Não há linha “MCP Pro” no checkout. Você paga o plano AutoZap (no plano anual de R$ 11.988) e a Meta cobra as mensagens na WABA. Créditos de IA são da IA que fala com o cliente, não de cada tools/call. Chamada MCP de leitura não é “mais um crédito de assistente” neste texto — o produto não vende MCP por token. O que existe é limite por minuto da chave. Se a operação precisa de várias automações, crie chaves com escopos estreitos, não uma chave dona do mundo.

REST ao lado do MCP

Quem já tem backend próprio talvez nem precise de MCP: a REST em https://api.appiautozap.com/functions/v1/public-api cobre conversas, envio, CRM, agenda, conhecimento, insights e webhooks de saída assinados. MCP brilha quando o consumidor é um modelo com ferramentas, não um cron em Node. Os dois compartilham escopos. Documentação: referência da API. Há ainda token por instância (API da conexão), com tela própria no WhatsApp do painel, para assinantes. Não misture token de instância com a chave MCP no mesmo parágrafo de treinamento.

Clientes suportados na cópia do painel

Cursor, Claude Desktop e um modelo genérico. A página pública cita também clientes com Streamable HTTP. Não listamos aqui “todos os GPTs da OpenAI” nem um marketplace. Se o seu host não aceita header customizado, use o Bearer composto ou a ponte mcp-remote do Claude Desktop. Se o host exigir OAuth de usuário final, este servidor não é esse produto: é chave de API.

Relação com o assistente interno da conta

O Appi AutoZap tem um assistente interno da conta, com ferramentas próprias para quem já está logado no produto. As ferramentas MCP/REST exigem chave ativa. Não são o mesmo botão. Treinar a equipe com “é tudo a mesma IA” gera ticket. A IA do WhatsApp fala com o cliente. O assistente interno fala com o dono. O MCP fala com o cliente de IA que você instalou.

Checklist antes de ligar envio no MCP

• O número está conectado? Qual canal?
• Na Cloud, a janela está aberta ou o template está aprovado?
• O escopo de envio está ligado só nessa chave, não numa chave de leitura compartilhada com um estagiário?
• Há idempotency_key estável por envio?
• A equipe sabe pausar a IA no painel? Envio manual pelo MCP também pausa a IA da conversa, como um humano na inbox.

Conflito de interesse, dito alto

Este texto é do Appi AutoZap. Descrevemos o servidor que o produto publica. O protocolo MCP não é nosso. Cursor e Claude Desktop não são nossos. A Meta não endossa este artigo. Preço do plano vem de /preco e do preço em código (R$ 11.988 por 12 meses, com a API oficial inclusa). Sem depoimento inventado.

Quando MCP não é a resposta

Se a operação só precisa da IA respondendo o cliente com a base, você não precisa de MCP. Ensine a base, teste áudio, pause quando for humano. Se a operação precisa de um cron que cria lead, use a REST. Se a operação precisa de template oficial fora da janela, precisa da Cloud — que é o canal do plano — não de um cliente MCP milagroso. MCP é para quem já tem (ou vai ter) um host de ferramentas e quer a inbox no mesmo teclado do código.

Comece pela página de produto, não pelo JSON

Leia /mcp, depois crie a chave no plano pago. Leia a API oficial do WhatsApp se o número vai para Cloud. Preço do plano em /preco. Compra do assistente em bot de WhatsApp. Posts irmãos: guia da Cloud API, oficial vs não oficial, WhatsApp Business API e custos. O pilar: automação de WhatsApp.

Uma analogia para a reunião de segunda

O WhatsApp é a rua. A Cloud é o asfalto. O AutoZap é a loja na calçada (inbox, CRM, agenda, IA nativa). O MCP é a porta dos fundos com crachá, para o seu robô de escritório entrar sem atravessar a vitrine. Quem vende “MCP para WhatsApp” sem loja está vendendo crachá sem porta. Quem vende loja sem dizer que o crachá existe esconde uma porta que o código já tem. Este artigo existe para as duas frases ficarem no quadro.

Logs e auditoria

O painel lista chamadas MCP (ferramenta, desfecho, duração). Use isso no dia em que alguém perguntar “quem mandou essa mensagem?”. Não publique o log em case de marketing. Não inventamos aqui um SIEM. Há histórico o suficiente para revogar a chave certa.

Idempotência, em uma paragrafada

Envio de template e mídia pede chave de idempotência. No MCP você passa idempotency_key ou o header; se mandar os dois, têm de coincidir. Retry com a mesma chave e o mesmo payload devolve o recibo. Payload diferente na mesma chave: conflito. Dois envios de verdade: duas chaves. Isso evita o clássico “o modelo tentou de novo e o cliente ganhou duas bolhas”.

Conclusão

MCP para WhatsApp, neste domínio, é um servidor remoto com permissões desligadas por padrão, chave de workspace e ferramentas de inbox — não um atalho para a API oficial da Meta e não um bot de menu. Conecte no plano pago, comece pela leitura, só então ligue envio. O restante do canal está no guia de automação. A vitrine do protocolo está em /mcp.

Se a busca era “WhatsApp MCP server”, a resposta honesta é: o Appi AutoZap publica um. A URL, os headers e os escopos estão neste artigo e na página de produto. O que não está é um milagre de atendimento sem base, sem humano e sem plano.