AstraChatWhatsApp no ChatGPT e no Claude com MCP: como conectar
Para conectar o WhatsApp no ChatGPT e no Claude com MCP, você cria uma chave MCP no painel do AstraCalls e cola a URL dela como conector no Claude ou como plugin no ChatGPT. A partir daí, você pede na conversa e a IA manda texto, botões e listas para o WhatsApp, sem você pegar o celular.
No vídeo eu faço o processo inteiro nas duas plataformas e disparo as mensagens ao vivo. Aqui eu explico o que é MCP, mostro o passo a passo e falo da parte que o vídeo passa rápido: como manter isso seguro e onde faz sentido usar.
O que é MCP e por que ele facilita
MCP (Model Context Protocol) é um jeito padronizado de entregar ferramentas para um agente de IA. A diferença para uma API comum fica mais clara com a analogia que uso no vídeo, a do restaurante:
- API sem MCP é como um restaurante sem cardápio. Cada vez que você quer saber o que existe, alguém precisa ir até a cozinha perguntar. Quem integra tem que conhecer cada endpoint e montar cada chamada.
- MCP é o cardápio na mesa. Você senta e já vê tudo que a casa oferece. A IA recebe a lista de ações que o AstraCalls sabe fazer e escolhe sozinha qual usar a partir do que você pediu.
Na prática, você não escreve código nem monta fluxo. Você diz "manda essa mensagem para esse número" e a IA chama a ferramenta certa.
O que você precisa
- O AstraCalls instalado no seu servidor. É a nossa API de WhatsApp open source, com o código no GitHub. A instalação está no artigo sobre ligações do WhatsApp no Chatwoot.
- Um número de WhatsApp conectado no painel do AstraCalls, pelo QR Code ou pelo código de pareamento.
- Uma conta no Claude ou no ChatGPT com a opção de adicionar conector ou plugin MCP.
Se você não tem servidor ou não quer cuidar da instalação, esse é um serviço que fazemos. O contato está no fim do artigo.
Passo 1: criar a chave MCP no AstraCalls
- Entre no painel do AstraCalls e abra a área de MCP.
- Clique para criar um novo MCP e dê um nome, por exemplo "AstraCalls".
- Decida o nível de acesso. Existe a opção de deixar só leitura, para a IA consultar sem conseguir enviar nada. No vídeo eu deixei acesso total porque queria disparar.
- Clique em criar a chave. O painel mostra o endereço e os dados de autenticação.
- Copie a primeira URL. Ela já vem pronta para colar no Claude e no ChatGPT, com a autorização embutida.
Você pode criar quantos MCPs quiser. Vale ter um para cada uso, assim você apaga um sem derrubar os outros.
Passo 2: conectar no Claude
- No Claude, abra Configurações e depois Conectores.
- Clique em adicionar um conector personalizado.
- Coloque o nome e cole a URL do AstraCalls.
- Na tela de autenticação, deixe sem login, porque a autorização já está na URL.
- Clique em adicionar e depois em vincular.
Para testar, abra uma conversa nova e escreva algo como "tenho um conector chamado AstraCalls, veja se consegue usar". Depois peça para mandar uma mensagem para o seu número. Na primeira vez o Claude pede autorização para usar a ferramenta. No teste do vídeo, a mensagem chegou no WhatsApp em poucos segundos.
Passo 3: conectar no ChatGPT
No ChatGPT o processo é parecido, muda o nome do menu. Lá o MCP aparece como plugin:
- Abra a área de plugins e clique em adicionar.
- Escolha MCP personalizado.
- Dê o nome, uma descrição se quiser, e cole a mesma URL do AstraCalls.
- Escolha sem autenticação, pelo mesmo motivo do Claude. Se preferir, dá para usar autenticação no formato Bearer.
- Confirme o aviso e conecte.
O ChatGPT muda os nomes dos menus com frequência. Se não encontrar "plugins", procure por conectores ou apps nas configurações. Testei pedindo "olá, vim do ChatGPT" para o meu número, e chegou na hora.
O que dá para mandar pelo chat
O MCP dá à IA acesso ao que a API do AstraCalls faz. No vídeo eu testei texto e botões, e os botões chegaram no WhatsApp como mensagem interativa. A documentação no repositório mostra o resto:
| Recurso | Exemplo de pedido |
|---|---|
| Texto | "manda para o número X: amanhã a loja abre às 9h" |
| Botões e listas | "manda um botão com as opções mensagem, ligação e vídeo" |
| Arquivos e imagens | "envia este PDF para o cliente X" |
| Carrossel e formulários | mensagens interativas mais completas |
| Grupos | enviar e consultar grupos do número |
| Ligações de áudio e vídeo | inclusive em massa, pelo endpoint de broadcast |
O AstraCalls também tem webhooks, node para n8n, integração com Chatwoot e tronco SIP para quem usa PABX. O MCP é só mais uma porta de entrada para tudo isso.
Segurança: trate a URL como senha
Esta é a parte que mais importa. A URL do MCP carrega a autorização. Quem tem a URL consegue mandar mensagem pelo seu número. Por isso:
- Não compartilhe a URL nem mostre em print ou vídeo. Se vazar, apague aquele MCP no painel e crie outro.
- Use só leitura quando a IA só precisa consultar.
- Um MCP por uso. Se você conectou num agente de teste, crie uma chave separada para ele.
- Pense antes de clicar em "sempre permitir". Para mensagens a clientes, aprovar cada envio evita que a IA mande algo que você não revisou.
Disparo pelo chat e risco de bloqueio
Dá para pedir "dispara essa mensagem para esta lista de 200 contatos" e a IA usa o endpoint de disparos. Funciona, mas o AstraCalls é uma API não oficial, e disparo em massa sempre pode levar ao bloqueio do número. Use um número separado do principal, mande só para quem autorizou o contato e espace os envios. Os cuidados estão detalhados no artigo sobre disparo de ligações no WhatsApp com n8n, e valem também para texto.
Onde isso faz sentido no dia a dia
- Recado rápido sem abrir o celular ou outro sistema, enquanto você já está trabalhando no chat com a IA.
- Reativar clientes com uma mensagem que a própria IA ajuda a escrever.
- Follow-up e relatórios puxando informação e mandando o resumo para o seu WhatsApp.
- Outros agentes que aceitam MCP, como o Hermes, ganham o WhatsApp do mesmo jeito.
Uma observação do vídeo: mensagens com botões costumam ter mais resposta do que texto puro, porque o cliente toca em vez de digitar. E um botão com link permite levar a pessoa para fora do WhatsApp, para uma página sua, onde você consegue capturar o contato por outros canais.
Se o que você quer é a IA atendendo clientes dentro de uma central com vários atendentes, o caminho é outro: veja como funciona a API do Chatwoot e do AstraChat.
Perguntas frequentes
O que é MCP no WhatsApp?
É uma forma de entregar as ações de uma API de WhatsApp, como enviar texto, botões e arquivos, para um agente de IA. Com o MCP do AstraCalls, o ChatGPT, o Claude ou outro agente compatível escolhe sozinho a ação certa a partir do que você pede na conversa.
Dá para conectar o WhatsApp no ChatGPT?
Sim. Você cria uma chave MCP no AstraCalls e adiciona a URL como plugin MCP personalizado no ChatGPT. Depois é só pedir na conversa para mandar a mensagem. O ChatGPT pede autorização antes de usar a ferramenta.
Como conectar o WhatsApp no Claude?
No Claude, vá em Configurações, Conectores, adicione um conector personalizado e cole a URL do MCP do AstraCalls, sem login. Depois clique em vincular e teste numa conversa nova.
Conectar o WhatsApp na IA por MCP é seguro?
É, desde que a URL fique protegida, porque ela carrega a autorização. Não compartilhe a URL, use a opção só leitura quando não precisar enviar, crie um MCP por uso e apague a chave se ela vazar.
Preciso pagar a API oficial do WhatsApp para isso?
Não. O AstraCalls é open source e conecta o número pelo QR Code, sem cobrança por mensagem da Meta. Por ser uma API não oficial, existe o risco de bloqueio em disparos em massa, então use um número separado e mande só para quem autorizou.
Quer isso rodando sem montar servidor?
Instalamos o AstraCalls no seu servidor com tudo configurado, ou entregamos em formato mensal, para você não se preocupar com infraestrutura. Também fazemos consultoria e treinamento para equipes que querem ligar o WhatsApp nos seus agentes de IA.
Se você quer atendimento com vários atendentes, Kanban, agentes de IA e ligações pelo WhatsApp numa central só, isso é o AstraChat, a nossa versão do Chatwoot, que vem na Comunidade Astra Online com a primeira instalação feita pelo especialista em Chatwoot Raphael Popiolek. Chame no WhatsApp e conte o que você quer automatizar.
