Como conectar o VS Code + GitHub Copilot ao WhatsApp com o Aurora MCP (2026)

O VS Code é a IDE mais instalada do mundo, e o GitHub Copilot é o assistente de IA padrão em milhares de equipes de engenharia. Se sua configuração diária já combina os dois, com apenas cinco linhas de código... configurações.json Você também pode gerenciar o WhatsApp Business: ler a caixa de entrada, abrir oportunidades no CRM, enviar acompanhamentos e conectar webhooks — tudo sem sair do editor. Este guia mostra como configurar e executar o Aurora MCP no Copilot Chat em menos de 5 minutos.

Pré-requisitos

Antes de mexer nas configurações, confirme:

• VS Code Instalado (versão estável ou Insider, ambas funcionam; recomendada >= 1.95).
• Assinatura ativa do GitHub Copilot — Individual ($10 USD/mês) ou Empresarial ($19 USD/mês). O Copilot é pago separadamente do Aurora; não está incluído em nenhum plano do Aurora Inbox.
• A extensão oficial Chat do GitHub Copilot ativado no seu VS Code.
• Espaço de trabalho Aurora Inbox ativo (o teste grátis Pode ser usado para testar tudo).
• Número do WhatsApp Business conectado No Aurora (via OAuth com Meta ou registro manual).
• API da plataforma principal ak_live_* gerado no Portal do Desenvolvedor (próximo passo).

Passo 1: Gere sua chave Aurora

1. Entre no seu espaço de trabalho em app.aurorainbox.com.
2. Ir para Integrações → Portal do Desenvolvedor (URL direta: https://app.aurorainbox.com/integrations/developer-portal).
3. Clique em Gerar nova chaveDê-lhe um nome descritivo, por exemplo vscode-copilot-laptop-alex.
4. Copie a chave — ela começa com ak_live_…Ele só é exibido uma vez; se você o perder, terá que gerar outro.

A chave permanece restrita a um único locatário (um espaço de trabalho) com escopo aurora.api.plataformaQualquer ação realizada pelo Copilot é transferida usando a identidade do seu espaço de trabalho e registrada no log de auditoria do Aurora com essa identidade. ID da chave.

Passo 2: Edite o arquivo settings.json do VS Code.

O VS Code salva a configuração do MCP para o Copilot no configurações.json do usuário (não no espaço de trabalho, a menos que você queira exigir uma senha em um projeto específico).

Para abri-lo:

1. Imprensa Ctrl+Shift+P (Windows/Linux) ou Cmd+Shift+P (macOS) para abrir a paleta de comandos.
2. Escreve Preferências: Abrir Configurações do Usuário (JSON) e pressione Enter.

O VS Code abre o arquivo configurações.json do usuário. Cole o seguinte bloco dentro do JSON raiz (se você já tiver conteúdo, adicione-o como outra chave, separada por vírgula):

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

Substituir ak_live_SUBSTITUA_SUA_CHAVE usando a chave que você copiou do Portal do Desenvolvedor. Salve com Ctrl+S / Cmd+S.

Observações importantes:

• Ele configurações.json O JSON ainda precisa ser válido. Se o VS Code mostrar um sublinhado vermelho, abra a paleta e execute. JSON: Validar — Uma vírgula no final ou um colchete solto quebra toda a configuração do MCP.
• Não envie este arquivo para um repositório público. A chave é equivalente a uma senha.
• Se você trabalha com vários espaços de trabalho Aurora, registre vários servidores (aurora-prod, aurora-encenação) com chaves diferentes.

Passo 3: Recarregue a janela e verifique.

Para que o Copilot inicie o novo servidor MCP, recarregue a janela:

1. Ctrl+Shift+P / Cmd+Shift+P.
2. Escreve Desenvolvedor: Recarregar janela e pressione Enter.

Após recarregar:

1. Abra o painel de Bate-papo do copiloto (ícone de bate-papo na barra lateral ou Ctrl+Alt+I / Cmd+Ctrl+I).
2. Na parte superior do painel, você verá um ícone de MCP / Ferramentas (Semelhante a um plugue). Clique ali.
3. Deveria aparecer aurora na lista de servidores, com o status de conexão e as ferramentas listadas (pesquisar_chats, enviar_mensagem, criar_contato, etc.).

Se aparecer como fracassado Caso não apareça, verifique a seção de solução de problemas no final.

Para um teste rápido, digite o seguinte no chat do Copilot:

Liste os 5 primeiros contatos da minha conta Aurora Inbox.

Ligações do copiloto lista_contatos e retorna uma matriz com eu ia, inhame, telefone, e-mail, nome da empresaSe a resposta chegar, a configuração funciona.

Que ferramentas o Aurora MCP oferece?

O Aurora MCP abrange todas as 10 áreas funcionais do produto. Cada ferramenta espelha um endpoint REST da API Platform V1 na mesma proporção.

Categoria	Ferramentas representativas	Caso de uso
Bate-papos	pesquisar_chats, obter_bate-papo, criar_chat, atribuir_agentes_de_chat, definir_proprietário_do_chat	Triagem de bandejas, atribuição de agentes
Mensagens	enviar_mensagem (1 ms/s por locatário), notas internas com nota=verdadeiro	Respostas, acompanhamento e feedback para a equipe.
Chatbots	iniciar_chatbot, parar_chatbot, lista_chat_chatbots, lista_chatbots	Ative fluxos de trabalho em chats específicos.
Contatos	lista_contatos, obter_contato, criar_contato, atualizar_contato, upsert_contact, excluir_contato	CRM básico do editor
Empresas	lista_empresas, obter_empresa, criar_empresa, atualizar_empresa	Contas B2B
Oportunidades	criar_oportunidade, oportunidade_de_atualização, excluir_oportunidade, list_chat_oportunidades	Avançar com os negócios pelo funil de vendas
Canais	Liste e analise o status da API WhatsApp Cloud, WhatsApp Business, Messenger e Instagram.	Diagnóstico multicanal
Equipamentos/Usuários	Ferramentas para equipes e usuários para convidar, atribuir e consultar.	integração programática
Webhooks	criar_webhook, lista_webhooks, excluir_webhook (máx. 5 por inquilino)	Eventos de saída para sua infraestrutura
Diagnóstico	saúde, quem sou eu	Validar conectividade e permissões

O Tipo de canal que aceitam criar_chat e os respectivos pontos finais são: 0 = API do WhatsApp Cloud, 1=WhatsApp Business, 2=Mensageiro, 3=Instagram.

Três exemplos de mensagens no Copilot Chat

Enquanto você estiver programando a integração de um webhook

Estou desenvolvendo um endpoint que recebe webhooks do Aurora. Liste os webhooks que já configurei no meu tenant e informe a quais eventos eles estão inscritos. Em seguida, ajude-me a registrar um novo webhook em https://api.miapp.com/aurora-events para o evento "MessageReceived".

Ligações do copiloto lista_webhooks e então criar_webhookE como está no VS Code, ele sugerirá o manipulador no seu arquivo aberto. Agende a integração e execute-a no mesmo turno.

Triagem matinal sem abandonar o editor

Antes de voltarmos ao código de ontem, pesquise no Aurora todas as conversas não respondidas do WhatsApp das últimas 24 horas. Forneça um resumo de uma linha para cada uma e marque-as por prioridade (alta/média/baixa).

Correntes Copiloto pesquisar_chats(não respondido=verdadeiro) com obter_chat(id) por chat. Você recebe a lista priorizada no painel sem precisar abrir o navegador.

Novo líder entrando no Slack

Tenho um novo lead: Daniel Martínez, +52 55 1234 5678, daniel@empresa.mx, empresa "Logística MX". Crie-o no Aurora com upsert_contact, abra um chat no WhatsApp Cloud e crie uma oportunidade no funil "Vendas do 3º Trimestre" com um valor estimado de $80.000 MXN.

Correntes Copiloto upsert_contact → criar_chat(tipo_de_canal=0) → criar_oportunidade → atualizar_oportunidade(valorDoNegócio=80000)Toda a operação ocorre no Copilot Chat sem interagir com a interface do Aurora.

Combinando Copilot + Aurora MCP em fluxos diários

O VS Code é onde os desenvolvedores já passam oito horas. Ter o Aurora MCP carregado no Copilot Chat abre três possibilidades interessantes:

• Programação colaborativa em integrações reaisEnquanto você escreve o cliente que consome webhooks do Aurora, o Copilot pode realizar consultas. lista_webhooks, leia as cargas úteis reais de obter_bate-papo e propor analisadores sintáticos corretos para dados reais em vez de simulações.
• Gerencie o WhatsApp na mesma janela em que você escreve o código.Um desenvolvedor de suporte investiga um bug, encontra o chat do cliente afetado e envia a ele uma atualização com enviar_mensagem e retorna à diferença. Sem troca de contexto para o navegador.
• O Copilot Chat em modo agente permite operações com várias etapas.No modo Agente, o Copilot executa várias ferramentas sequencialmente com supervisão mínima: importe 200 leads de um arquivo CSV com upsert_contact, abre oportunidades para aqueles que se qualificam e envia uma mensagem de boas-vindas — tudo em uma única solicitação em linguagem natural, respeitando o limite de 1 mensagem por segundo.

Solução de problemas

A Copilot diz "você não tem uma assinatura ativa".

O VS Code permite a edição configurações.json Mesmo que sua assinatura do Copilot tenha expirado, o chat do Copilot não responderá. Renove sua assinatura em https://github.com/settings/copilotO servidor MCP ainda está lá, pronto para quando o Copilot retornar.

arquivo settings.json malformado

Se você colou o bloco e quebrou o JSON (vírgula final, chave de abertura extra), o VS Code exibe um sublinhado vermelho e o Copilot ignora o arquivo inteiro. Abra a paleta e execute JSON: Validar e corrige. A extensão Prettier ou formatação nativa (Shift+Alt+F) também ajudam a detectar o erro.

O servidor aurora Aparece no MCP, mas com um status fracassado

Quase sempre o problema está na senha: ou você não a copiou completamente, ou ela tem espaços no início. Gere uma nova senha no Portal do Desenvolvedor e cole-a com cuidado. Confirme se ela começa exatamente com ak_live_Verifique também se você não está atrás de um proxy corporativo que esteja bloqueando o acesso. developers.aurorainbox.com.

O ícone do MCP não aparece no Copilot Chat.

Verificar:

• O VS Code está atualizado (Ajuda → Verificar atualizações).
• A extensão GitHub Copilot Chat está habilitada (e não apenas instalada).
• Após a edição configurações.jsonVocê fez isso? Desenvolvedor: Recarregar janelaA alteração não se aplica ao hot-reload em muitas versões.

"Esta ferramenta não está disponível para o modelo selecionado"

Nem todos os modelos do Copilot suportam a chamada de ferramentas (MCP) com a mesma confiabilidade. Se você usar um modelo que não oferece suporte a esse recurso, o Copilot ignorará as ferramentas. No seletor de modelos do Copilot Chat, escolha um com MCP completo: GPT-5, Claude Sonnet ou Gemini Pro. O GPT-5 e o Claude Sonnet são os mais confiáveis para encadear várias chamadas de ferramentas.

Limite de taxa em enviar_mensagem

Aurora limita o envio a 1 mensagem por segundo por locatário para proteger a qualidade dos dados no Meta. Se sua solicitação requer 100 mensagens, o Copilot precisa distribuí-las uniformemente. Se esse limite for excedido, ocorrerá um erro. Limite de requisições excedido… tente novamente em 1 segundo E para.

Como o Aurora MCP faz isso

Ao contrário da conexão direta do endpoint da API WhatsApp Cloud ao Copilot, o Aurora MCP oferece:

• Autenticação simples: uma chave ak_live_* E reutiliza o mesmo sistema de API da plataforma que você já tinha. Sem OAuth de três etapas, sem tokens que expiram.
• Registro de auditoria nativoCada chamada é gravada no Aurora com o ID da chave que deu origem a isso — você sabe exatamente qual chave, de qual desenvolvedor, fez o quê.
• Limites de tarifa por inquilinoO Copilot não pode degradar a qualidade do número Meta enviando dados muito rapidamente, mesmo que você solicite.
• MulticanalA mesma ferramenta funciona para WhatsApp Cloud, WhatsApp Business, Messenger e Instagram — o agente escolhe o canal com tipoDeCanal.
• CRM por trásCada conversa já está vinculada a um contato e pode gerar oportunidades — não se trata apenas de "enviar uma mensagem" sem status.

Plano recomendado para começar: Aurora IA $179 USD/mês ($3.200 MXN) que inclui GPT-5, RAG nativo, agendamento integrado e servidor MCP. O plano CRM ($99 USD / $1.800 MXN) e IA Plus ($329 USD / $6.000 MXN) também inclui MCP.

Comece seu teste gratuito e conecte o VS Code + Copilot em 5 minutos.

Perguntas frequentes

Preciso pagar pelo GitHub Copilot separadamente?

Sim. O Copilot é um produto do GitHub e é pago separadamente: US$ 10/mês para o plano Individual ou US$ 19/mês para o plano Empresarial. Ele não está incluído em nenhum plano da Aurora. A Aurora fornece apenas o servidor MCP — cuja lógica ainda segue o modelo do Copilot. Se sua organização já possui o Copilot Business, aproveite essa assinatura.

Funciona nas versões Insider e Stable do VS Code?

Sim, ambos. O recurso MCP no Copilot está disponível na versão Estável desde 2025 e na versão Insider um pouco antes. A configuração (github.copilot.mcp.servers) é idêntico.

Quais modelos do Copilot são compatíveis com MCP?

O GPT-5, o Claude Sonnet (3.5/3.7/4, dependendo da versão) e o Gemini Pro suportam a chamada completa de ferramentas e, portanto, o MCP. Modelos menores podem ignorar ferramentas ou chamá-las incorretamente. Se você encadear várias ferramentas (por exemplo, criar contato + abrir chat + criar oportunidade), o GPT-5 e o Claude Sonnet oferecem os melhores resultados.

Essa configuração se aplica a todos os meus espaços de trabalho do VS Code?

Se você colar isso no configurações.json de UsuárioSim, funciona para qualquer projeto. Se você colar no configurações.json de um espaço de trabalho específico (.vscode/settings.json), aplica-se apenas a esse projeto. Recomendamos "Usuário" para uso pessoal e "Espaço de Trabalho" apenas quando você deseja uma chave diferente para cada projeto do cliente.

Funciona com o GitHub Enterprise ou com o Copilot Business?

Sim. A configuração é a mesma. No Copilot Business, confirme com o administrador se servidores MCP de terceiros são permitidos — algumas organizações usam políticas para restringir quais servidores MCP os desenvolvedores podem carregar.

Há conflitos se eu já tiver outros servidores MCP (Sentry, Linear, GitHub MCP)?

Não. github.copilot.mcp.servers É um objeto que aceita múltiplas entradas. Aurora reside sob a chave aurora e os outros servidores MCP em suas próprias chaves. O Copilot lista todas as ferramentas no painel MCP e escolhe qual delas chamar com base na solicitação. A única ressalva é que alguns modelos menores podem ficar confusos com muitas ferramentas simultâneas — se você observar um comportamento errático, mude para GPT-5 ou Claude Sonnet.

Você trabalha com outros agentes? Temos guias paralelos para Código Claude, Codex CLI, Área de trabalho Claude e CursorE se você quiser entender o protocolo completamente, continue lendo. O que é MCP e como a IA se conecta com o WhatsApp? ou explore 10 casos de uso reais.