Como conectar o Claude Desktop ao WhatsApp com o Aurora MCP (2026)

Se você já usa o Claude Desktop para escrever, resumir ou pesquisar, também pode dar a ele acesso ao seu WhatsApp Business — sem programação, sem plugins complexos e sem precisar migrar suas conversas para fora do Aurora. Tudo o que você precisa fazer é colar um pequeno bloco de configuração, uma chave que você gera em 30 segundos e reiniciar o aplicativo. A partir daí, o Claude poderá ler conversas, rascunhar respostas, criar contatos no seu CRM e agendar acompanhamentos, tudo na mesma janela onde você o instrui a fazer tudo. Este guia mostra o passo a passo.

Pré-requisitos

Antes de começar, tenha à mão o seguinte:

• Área de trabalho Claude instalado (baixe gratuitamente de claude.ai/downloadDisponível para macOS e Windows.
• Uma conta Aurora Inbox Ative. Se você ainda não tiver um, abra o Teste grátis por 14 dias — inclui tudo o que é necessário para este guia.
• Seu número do WhatsApp Business foi conectado. dentro do Aurora (via OAuth com Meta ou registro manual).
• Uma API de plataforma fundamental ak_live_* gerado no Portal do Desenvolvedor (explicaremos como obtê-lo na próxima etapa).
• Um editor de texto simples Para editar o arquivo de configuração: o TextEdit no macOS ou o Bloco de Notas no Windows funcionam perfeitamente. Evite usar o Word, pois ele adiciona caracteres invisíveis que corrompem o JSON.

Você não precisa saber programar. Se copiar e colar for fácil para você, terminará em menos de 10 minutos.

Passo 1: Gere sua chave no Aurora

A chave é o que dá permissão ao Claude Desktop para se comunicar com o seu Aurora. Funciona como uma senha: trate-a com cuidado e não a copie em chats públicos nem a carregue em repositórios.

1. Abra seu espaço de trabalho em app.aurorainbox.com com a conta de administrador.
2. No menu lateral, acesse Integrações → Portal do Desenvolvedor (você também pode ir diretamente para https://app.aurorainbox.com/integrations/developer-portal).
3. Clique em Gerar nova chaveDê um nome que você possa reconhecer facilmente mais tarde, por exemplo. claude-desktop-mac-alex qualquer claude-desktop-laptop-trabalho.
4. Copie a chave inteira — ela começa com ak_live_ seguido por uma longa sequência de caracteres. Salve-a no seu gerenciador de senhas: ela só será exibida uma vez. Se você a perder, basta gerar outra e estará tudo certo.

Cada chave está associada a um único espaço de trabalho do Aurora. As ações realizadas pelo Claude Desktop são registradas no seu log de auditoria. ID da chave Essa chave indica exatamente o que aconteceu e quando.

Passo 2: Editar a configuração do Claude Desktop

O Claude Desktop salva seus servidores MCP em um arquivo de configuração JSON. Vamos abri-lo, adicionar o Aurora e salvar.

Encontre o arquivo

O caminho varia dependendo do seu sistema operacional:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

A maneira mais rápida de abri-lo:

• No macOSAbra o Finder e pressione Cmd + Shift + G e cole o caminho completo: ~/Biblioteca/Suporte a Aplicativos/Claude/Em seguida, abra claude_desktop_config.json com o TextEdit.
• No WindowsAbra o Explorador de Arquivos e cole. %APPDATA%\Claude\ Na barra de endereços, pressione Enter. Abra. claude_desktop_config.json Com o Bloco de Notas.

Se o arquivo não existir, crie-o você mesmo. Se ele existir, mas estiver vazio, não tem problema — nós o preencheremos.

Cole o trecho de Aurora

Substitua o conteúdo do arquivo por este (ou, se você já tiver outros servidores MCP configurados, adicione a entrada). aurora dentro do objeto Servidores mcp):

{ "mcpServers": { "aurora": { "url": "https://developers.aurorainbox.com/mcp", "headers": { "Authorization": "Bearer ak_live_REEMPLAZA_TU_CLAVE" } } } }

Substitui ak_live_SUBSTITUA_SUA_CHAVE usando a chave que você copiou na etapa anterior. Certifique-se de que a palavra Portador Fique ali, com o espaço antes da chave.

Salve o arquivo. Se o seu editor perguntar se você deseja manter a extensão. .json, responde que sim.

Dica: Se você copiou e colou e aparecem aspas estranhas (" em vez de "Substitua-as manualmente por aspas duplas retas. Essa é a causa dos erros #1 ao abrir o Claude Desktop.

Passo 3: Reinicie o Claude Desktop e verifique.

Este passo parece óbvio, mas é onde a maioria das pessoas fica presa. Fechar a janela não é suficiente. — O Claude Desktop geralmente continua rodando em segundo plano, e o arquivo de configuração só é lido novamente na inicialização.

Encerramento completo

• No macOS: Clique com o botão direito do mouse no ícone de Claude no Dock → SairOu, com o aplicativo ativo, menu Claude → Sair Claude (Cmd + Q).
• No Windows: Clique com o botão direito do mouse no ícone de Claude na bandeja do sistema (canto inferior direito, ao lado do relógio) → DesistirOu utilize o Gerenciador de Tarefas para encerrar o processo, caso ele não apareça.

Após fechar completamente, abra o Claude Desktop como qualquer outro aplicativo.

Teste se funciona

Inicie uma nova conversa e pergunte:

Que ferramentas você tem disponíveis?

Se o Aurora MCP carregou corretamente, Claude deve mencionar ferramentas como pesquisar_chats, enviar_mensagem, lista_contatos, criar_chatentre outros (cerca de 30 no total). Você verá um pequeno ícone de ferramentas na interface indicando que um servidor MCP está conectado.

Se tudo parecer bem, tente uma pergunta prática:

Liste os 5 primeiros contatos da minha conta Aurora Inbox.

Claude vai chamar a ferramenta. lista_contatosNa primeira vez, será solicitada uma confirmação (um procedimento padrão no fluxo de trabalho de segurança da Anthropic) e, em seguida, a lista será exibida em linguagem natural.

O que você pode esperar do Claude Desktop com Aurora MCP?

O Aurora MCP apresenta cerca de 30 ferramentas que abrangem as áreas funcionais do produto. Aqui está um resumo focado no que um operador real solicitaria do Claude Desktop em seu trabalho diário.

Categoria	O que Claude pode fazer?	Exemplo do dia a dia
Caixa de entrada	Procure por chats, abra-os, marque-os e atribua-os.	"Mostre-me as mensagens não respondidas de hoje"
Mensagens	Enviar mensagens (1 por segundo por conta) e notas internas.	"Envie uma mensagem amigável de acompanhamento para Maria"
Contatos	Listar, criar, atualizar, inserir/atualizar, excluir	"Crie um perfil para Pedro Ramírez com o número de telefone +52 81 1234 5678"
Oportunidades	Crie, mova e verifique negócios no funil.	"Abra uma oportunidade de $50.000 MXN com esta conta"
Chatbots	Ative e desative chatbots automatizados via chat.	"Pause o chatbot no chat do Daniel enquanto eu o atendo"
Canais	Funciona com WhatsApp Cloud (0), WhatsApp Business (1), Messenger (2), Instagram (3)	"Envie para ele pelo WhatsApp Cloud, não pelo Instagram"
Webhooks	Crie webhooks para receber eventos em outras ferramentas.	"Configure um webhook para o meu Zapier"
Diagnóstico	Verificar conectividade e permissões	Estou conectado corretamente ao Aurora?

Cada ferramenta espelha um endpoint da API Platform V1 no Aurora em uma proporção de 1:1. Para entender o funcionamento interno, continue lendo. O que é MCP e como a IA se conecta com o WhatsApp?.

Cinco dicas úteis para começar

1. Triagem matinal da bandeja

Por favor, revise as conversas não respondidas do WhatsApp em Aurora das últimas 24 horas. Forneça uma lista priorizada por urgência com um breve resumo de uma linha para cada uma.

Claude Desktop usa pesquisar_chats(não respondido=verdadeiro) e então obter_chat(id) Para cada um deles. Você obtém uma visualização priorizada em menos de um minuto, sem precisar abrir o Aurora.

2. Acompanhamento amigável para um cliente que parou de responder.

Em Aurora, encontre a conversa com Maria Gonzalez. Leia as mensagens mais recentes e escreva uma mensagem curta e amigável perguntando se ela ainda precisa de ajuda com o orçamento. Antes de enviar, mostre-a para mim para aprovação.

Claude pesquisa no chat, lê o contexto, redige uma mensagem e aguarda sua aprovação antes de executá-la. enviar_mensagemVocê é responsável pelo tom.

3. Encontrar alguém pelo número de telefone

Procure em Aurora o contato cujo número de telefone termina em 5678. Informe o nome, a empresa e a última mensagem que trocamos.

Claude usa lista_contatos com filtros e depois obter_bate-papo Para a última mensagem. Útil quando alguém lhe pergunta "quem é este número?" em uma reunião.

4. Agende uma ligação com um potencial cliente.

Crie uma nova oportunidade no funil de vendas "Q3 Sales" para o contato Carlos Pérez com um valor estimado de $80.000 MXN. Em seguida, envie uma mensagem pelo WhatsApp convidando-o para uma chamada na quinta-feira, às 11h (horário do México).

Correntes de Claude criar_oportunidade com quantidade e então enviar_mensagemUma única solicitação termina com uma oportunidade em aberto e o cliente é notificado.

5. Relatório rápido para sua reunião

Quantas novas conversas entraram no Aurora ontem? Agrupe-as por canal (WhatsApp Cloud, WhatsApp Business, Instagram, Messenger) e me dê o total.

Claude verifica os chats com filtros de data, conta por canal e elabora um mini-relatório. Perfeito para uma reunião matinal rápida.

Solução de problemas

"O JSON está malformado" ou o Claude Desktop não será iniciado.

O erro mais comum. Confira:

• aspas duplas retas ("), sem aspas curvas (" "O Word e alguns editores os convertem automaticamente.
• Em vez de vírgulas: após cada par chave-valor, menos o último em cada bloco.
• Teclas balanceadas: todos { deve ter o seu } correspondente.

Dica: Cole todo o seu JSON em https://jsonlint.com — indica exatamente qual linha está com problema.

O caminho do arquivo não existe.

Se a pasta Claude Se não aparecer, abra o Claude Desktop pelo menos uma vez. O aplicativo cria a pasta na primeira inicialização. Depois disso, você pode editar o arquivo e reiniciar.

Você editou o arquivo, mas Claude não vê Aurora.

Quase sempre isso acontece porque você não reiniciou o computador completamente. Verifique se o Claude Desktop não está mais sendo executado em segundo plano (Dock no macOS, bandeja do sistema no Windows) antes de reabri-lo.

"Erro de autenticação" ou "401 Não autorizado"

A chave não foi colada completamente ou contém espaços no início ou no fim. Volte ao Portal do Desenvolvedor e copie a chave completa (ak_live_ e tudo o que vem a seguir (sem quebras de linha) e cole de volta no JSON.

A senha expirou ou não funciona mais.

As chaves não expiram automaticamente, mas um administrador pode revogá-las no Portal do Desenvolvedor. Gere uma nova, substitua a antiga no JSON, salve e reinicie.

As ferramentas não estão aparecendo, embora tudo pareça normal.

Feche completamente o Claude Desktop. Aguarde 10 segundos. Reabra-o. Se o problema persistir, abra um terminal e execute:

curl https://developers.aurorainbox.com/.well-known/mcp.json

Você deverá ver um arquivo JSON com a descrição do servidor. Caso contrário, entre em contato com o suporte.

Como o Aurora MCP faz isso

Conectar um agente de IA diretamente à API WhatsApp Cloud da Meta exige ser um BSP autorizado, lidar com webhooks de entrada, controlar limites de taxa e construir seu próprio CRM nos bastidores. O Aurora faz tudo isso para você e oferece ao Claude Desktop uma interface limpa.

• Autenticação simples: uma chave ak_live_* Ele reutiliza o sistema de API da plataforma pelo qual você já paga. Não há OAuth de três etapas nem tokens que expiram.
• Registro de auditoria nativo: Cada chamada está associada a ID da chave Foi isso que deu origem a tudo, então você sabe o que Claude fez e quando.
• Limites de taxa por espaço de trabalho: enviar_mensagem O limite é de 1 mensagem por segundo por conta para proteger a qualidade dos dados com a Meta. Claude respeita isso automaticamente.
• Multicanal: A mesma chave funciona para WhatsApp Cloud, WhatsApp Business, Messenger e Instagram — Claude escolhe o canal com o parâmetro tipoDeCanal.
• CRM por trás de: Cada conversa já está vinculada a um contato e pode gerar oportunidades. Não se trata apenas de "enviar uma mensagem", mas sim de "gerenciar seu negócio de dentro do Claude".

Plano recomendado para começar: Aurora IA $179 USD/mês ($3.200 MXN) que inclui GPT-5, RAG nativo, agendamento integrado e o servidor MCP irrestrito.

Comece seu teste gratuito de 14 dias e conecte o Claude Desktop em menos de 10 minutos.

Perguntas frequentes

O Aurora MCP é gratuito?

O servidor MCP está incluído em todos os planos pagos do Aurora Inbox: Aurora CRM $99 USD/mês ($1.800 MXN), Aurora IA $179 USD ($3.200 MXN) e Aurora IA Plus $329 USD ($6.000 MXN). O período de teste de 14 dias também o inclui sem restrições.

Minha conversa com Claude está sendo enviada para Aurora?

Não. O Claude Desktop continua a processar suas mensagens usando os modelos da Anthropic (Claude Sonnet ou Opus) em sua infraestrutura. A única coisa que é enviada para o Aurora são os dados. invocações de ferramentas específicas (por exemplo, "pesquisar neste chat" ou "enviar esta mensagem"). O restante da sua conversa com Claude não envolve Aurora.

Posso conectar várias contas Aurora ao mesmo ambiente de trabalho Claude?

Sim. No arquivo de configuração, você pode adicionar vários servidores com nomes diferentes:

{ "mcpServers": { "aurora-prod": { "url": "https://developers.aurorainbox.com/mcp", "headers": { "Authorization": "Bearer ak_live_PRODUCCION" } }, "aurora-staging": { "url": "https://developers.aurorainbox.com/mcp", "headers": { "Authorization": "Bearer ak_live_STAGING" } } } }

Cada um aparece como um servidor MCP independente e Claude escolhe o correto de acordo com o contexto da solicitação.

Posso usar a mesma chave no meu Mac e no meu Windows ao mesmo tempo?

Sim. Uma chave. ak_live_* Funciona em qualquer máquina e todas as chamadas são registradas no mesmo log de auditoria. Mesmo assim, Recomenda-se gerar uma chave por dispositivo. (claude-desktop-mac-alex, claude-desktop-windows-alexAssim, você pode revogar uma sem afetar a outra se perder um laptop ou trocar de equipamento.

O que acontece se eu editar o arquivo JSON incorretamente?

O Claude Desktop simplesmente não carrega o servidor MCP com defeito e exibe um aviso ao abrir o aplicativo. Sua conta Aurora não está em risco. Corrija o arquivo JSON, reinicie o computador e tudo estará resolvido. Se desejar reverter ao estado anterior, exclua o arquivo. claude_desktop_config.json E o Claude Desktop volta a funcionar como se você nunca tivesse mexido em nada.

Outros agentes usam a mesma chave?

Sim. O Aurora MCP é compatível com a versão do protocolo MCP. 2025-03-26 sobre transporte streamable-httpque é um padrão aberto. A mesma chave funciona em Código Claude, Codex CLI, Cursor e VS Code com CopilotCada cliente tem seu próprio arquivo de configuração, mas o Aurora, por outro lado, é o mesmo. Para ideias sobre o que construir, confira o 10 casos de uso para agentes no WhatsApp com Aurora MCP.