Guia de WhatsApp
Como conectar o Claude ao WhatsApp em cinco minutos, sem a API do Business
- Verificado em novembro de 2026
- Testado em 2026-11-08: claude.ai na web, plano Ultra
Adicione https://api.spun.com/api/mcp como conector personalizado no claude.ai e entre com a sua conta do Spun. O Spun é um servidor MCP hospedado no seu próprio número de WhatsApp: não é uma extensão de navegador, não é um bot que atende seus clientes, não usa a API do WhatsApp Business e não pede chave de API. Depois do teste de 7 dias, continua grátis dentro de limites de uso, com um cartão que nunca é cobrado a menos que você escolha um plano pago. A sua assinatura do Claude é à parte.
O Spun é uma caixa de entrada compartilhada do WhatsApp que roda um servidor MCP hospedado em cima do WhatsApp da sua empresa: as conversas do seu próprio número e os contatos por trás delas. Aponte o Claude para ele: o seu assistente vê o que importa, redige o que ajuda e só envia o que alguém da sua equipe aprovar. Uma imobiliária pode perguntar quais compradores estão esperando retorno, e uma clínica, quais consultas ainda não foram confirmadas.
Esta página é o passo a passo: três aplicativos, os cliques exatos e a única decisão que você toma na tela de consentimento. Todo o resto sobre o servidor, suas permissões, limites e posturas de envio está na página do Spun MCP.
Free MCP: o Claude no seu número de WhatsApp, grátis depois do teste
Toda conta começa com 7 dias de tudo, sem cartão. Conecte o Claude durante o teste e cadastre um cartão: depois disso, sua conta continua no Free MCP enquanto você usar, com 100 chamadas de IA por mês, até 200 contatos diferentes por mês e cada envio aguardando a sua aprovação. Nada é cobrado a menos que você escolha um plano pago.
01
Antes de começar
- Um espaço no Spun com um número de WhatsApp conectado. O Spun se liga ao número que você já usa; nada passa pela API do Business.
- Você precisa ser gerente da organização no Spun para liberar acesso a um aplicativo. Os membros não conseguem.
- O endereço do servidor, o mesmo para todos os aplicativos: https://api.spun.com/api/mcp
Comece pela leitura. A tela de consentimento nunca concede envio autônomo, e a primeira chave sensata é uma chave somente leitura. Amplie as permissões depois de ver como o assistente se comporta.
Veja também: Conectar o seu WhatsApp ao Spun com o Free MCP
02
claude.ai (web, celular e Desktop): um conector personalizado, sem chave de API
- 1
Abra Customize e depois a aba Connectors
No claude.ai na web, abra Customize no menu da esquerda e escolha a aba Connectors. Os nomes ficam em inglês, como o Claude os mostra. Settings não guarda mais os conectores: Settings → Connectors só diz "Connectors have moved to Customize".
- 2
Escolha Add e depois Add custom connector
Escolha Add no canto superior direito e depois Add custom connector. O Spun não está no diretório de conectores do Claude, então uma busca por "Spun" lá não encontra nada: você mesmo adiciona.
- 3
Preencha o nome e a URL do servidor MCP e escolha Continue
Digite Spun como nome (Name) e cole o endereço do servidor https://api.spun.com/api/mcp em MCP server URL (copie do quadro abaixo). Escolha Continue. Não é preciso chave de API.
- 4
Mantenha o login detectado e escolha Add
O Claude verifica o servidor e já seleciona "Sign in now (Detected)" em Authentication e "Register automatically (Detected)" em OAuth client. Deixe os dois como estão e escolha Add.
- 5
Escolha Connect e entre com a sua conta do Spun
A página do conector do Spun diz "You're not connected to Spun yet". Escolha Connect. A tela do Spun abre na mesma aba. Entre com a conta que gerencia a sua organização.
- 6
Escolha a organização e o nível de acesso, depois Permitir acesso
Na tela de consentimento do Spun "Conectar um assistente de IA" ("Connect an AI assistant" se o seu Spun estiver em inglês), você escolhe qual organização o assistente pode ver e o "Nível de acesso": "Analista somente leitura", "Assistente, sem envios" (o padrão) ou "Assistente com envios". Depois escolha "Permitir acesso" (Allow access). Só gerentes da organização veem essa tela. A tela de consentimento em si nunca concede envio autônomo.
- 7
Confira as permissões das ferramentas e faça a primeira pergunta
De volta à página do conector do Spun no Claude, você vê Disconnect e Tool permissions, com Read-only tools e uma chave de permissão para cada ferramenta. O Claude mostra o logo do Spun sozinho. Abra um chat novo e pergunte sobre as suas conversas ou os seus contatos. Se mais tarde a sua equipe quiser que o assistente envie sozinho, um gerente da organização ativa isso no Spun, em Configurações → Assistente de IA (MCP) → Aplicativos de IA conectados (Settings → AI Assistant (MCP) → Connected AI apps em inglês); um novo consentimento desfaz essa liberação.
O Spun testou esse caminho em 2026-11-08 no claude.ai na web, no plano Ultra. O Claude muda os menus de vez em quando, e quais assinaturas e configurações de espaço de trabalho permitem conectores personalizados é decisão da Anthropic, que o Spun não controla. A página do Spun MCP mostra o caminho atual e a data da última verificação feita pelo Spun.
https://api.spun.com/api/mcp
Veja também: Spun MCP: tabela de compatibilidade e caminhos de configuração atuais
03
Claude Code: um comando, depois um login ou uma chave
O Claude Code se conecta por OAuth com retorno local: rode o comando abaixo, digite /mcp no Claude Code, escolha spun e Authenticate, e entre na sua conta do Spun pelo navegador. Desse jeito não é preciso chave de API.
Para uma instalação sem navegador (servidor, script), use uma chave de API. Crie a chave primeiro no Spun (o passo a passo está na página do Spun MCP: predefinições com um clique para analista somente leitura, assistente sem envios ou assistente com envios, com avisos por permissão e revogação com um clique) e acrescente --header "Authorization: Bearer wap_YOUR_KEY" ao mesmo comando; a chave vai num cabeçalho Bearer.
claude mcp add --transport http spun https://api.spun.com/api/mcp
Veja também: Spun MCP: chaves, permissões e como criar a sua primeira chave
04
Claude Desktop
Prefira o conector personalizado acima: você adiciona uma vez no claude.ai em Customize → Connectors, entra com o Spun e não tem chave nenhuma para gerenciar. A ponte mcp-remote no claude_desktop_config.json é a alternativa com chave de API para as instalações que precisam dela.
05
O que acontece quando o assistente quer enviar uma mensagem?
A IA redige. A sua equipe aprova. O servidor envia. Um envio proposto cai na fila "IA Envia" da caixa de entrada do Spun (Ferramentas Spun, Automatizar), com o conteúdo real, o destinatário, o canal e o motivo informado pelo assistente, e é a aprovação que executa o envio. O cartão de aprovação é gerado pelo servidor a partir do que realmente vai acontecer, nunca a partir da descrição que o assistente faz de si mesmo.
Essa é a postura padrão, chamada two_step, e é uma única configuração da organização que vale para todas as chaves. As horas silenciosas valem por cima: fora da janela de horário da sua organização, os envios ficam retidos ou são negados, você escolhe, e são liberados com novas verificações quando a janela abre.
Veja também: Posturas de envio, permissões e limites fixos em cada chave
06
Quanto custa?
A assinatura do Claude é paga à Anthropic. Do lado do Spun, toda conta começa com 7 dias de tudo, sem cartão. Se o Claude estiver conectado durante o teste e você cadastrar um cartão, sua conta continua no Free MCP por R$0: 100 chamadas de IA por mês, até 200 contatos diferentes por mês, cada envio aprovado por uma pessoa, 7 dias de histórico de mensagens e um único número. O cartão nunca é cobrado a menos que você escolha um plano pago, e pelo menos uma leitura de IA a cada 7 dias mantém o número conectado.
O Free MCP não inclui fluxos de trabalho agendados, automações nem REST API. Os planos pagos começam em R$249/mês, com membros ilimitados na equipe, e acrescentam tudo isso, histórico mais longo e mais leituras. As leituras de um aplicativo conectado nunca consomem o seu crédito de IA do Spun.
Veja também: O Free MCP ao lado dos planos pagos · Preços
07
Usa outra IA? ChatGPT, Gemini, Cursor e outros
O mesmo servidor funciona no ChatGPT e no aplicativo Gemini como conector, com a mesma tela de consentimento do Spun, e no Cursor, na API da Anthropic e em outros clientes MCP com uma chave. A página do Spun MCP mantém a tabela de compatibilidade dos aplicativos, incluindo os que o Spun verificou de ponta a ponta e os que o fornecedor documenta mas que ainda não testamos.
Veja também: Tabela de compatibilidade dos aplicativos · Como conectar o ChatGPT ao WhatsApp Business
FAQ
Perguntas frequentes
No claude.ai, adicione https://api.spun.com/api/mcp como conector personalizado, entre com a sua conta do Spun e escolha a organização e o nível de acesso na tela de consentimento. No Claude Code, rode claude mcp add --transport http spun https://api.spun.com/api/mcp, depois /mcp e Authenticate.
Perguntas relacionadas
- Por que o meu conector do ChatGPT com o WhatsApp não funciona? (em inglês)
- O ChatGPT consegue ler minhas mensagens do WhatsApp? (em inglês)
- O ChatGPT pode enviar mensagens no WhatsApp? (em inglês)
- O que é um servidor MCP do WhatsApp? (em inglês)
- O que o ChatGPT pode fazer com as suas conversas do WhatsApp? (em inglês)
Entregue ao Claude o seu negócio, não só uma sessão do WhatsApp
Um conector, uma tela de consentimento e cada envio retido para uma pessoa aprovar. Conecte o número de WhatsApp que você já usa e aponte o Claude para ele. 7 dias de tudo grátis, depois o Free MCP com um cartão cadastrado.
Mais guias de WhatsApp
WhatsApp Web para Empresas · Fui Bloqueado? · Números Virtuais · O Código de 6 Dígitos · Listas de Transmissão · Bloquear e Desbloquear · Enviando Links · QR Codes e Aparelhos Conectados · Tiques e Confirmação de Leitura · WhatsApp Banido · Por Que o WhatsApp É Banido · WhatsApp Business Banido · WhatsApp Temporariamente Banido · Bloqueado por Spam · Disparo em Massa · Marketing sem Ser Banido · Aquecimento de Chip · Redes, VPN e Banimento · Recuperar WhatsApp Banido · Número Bloqueado · Limites da Transmissão · Proxy para WhatsApp · Spun Box · O Spun pode fazer meu WhatsApp ser banido? · Conectar o ChatGPT ao WhatsApp Business