NicoChat no VS Code: automações de WhatsApp com o GitHub Copilot

Para conectar o NicoChat ao GitHub Copilot no VS Code, crie um arquivo .vscode/mcp.json apontando para https://mcp.nicochat.com/mcp e autentique via OAuth no navegador. A partir daí, o Copilot em modo agente opera a plataforma por conversa. Ele lista canais, cria fluxos, edita agentes de IA e consulta analytics sem você abrir o painel do NicoChat.

Este tutorial é para times de desenvolvimento que cuidam do produto e também do atendimento automatizado. Você vai configurar a conexão em minutos. Depois, vamos a três casos de uso que só fazem sentido dentro do editor.

guia completo do MCP do NicoChat

Resumo rápido

O NicoChat expõe um servidor MCP oficial em https://mcp.nicochat.com/mcp, com autenticação OAuth.

No VS Code, basta um mcp.json por projeto ou global. Não precisa instalar pacote nem rodar servidor local.

O Copilot em modo agente cria e edita fluxos, agentes de IA, tags e broadcasts por conversa.

Casos de uso para devs: automações versionadas junto do código, Copilot escrevendo js_function e blocos de API, e revisão de webhooks por conversa.

Funciona em qualquer plano do GitHub Copilot que tenha modo agente, incluindo o Copilot Free (com limites de uso).

O que é o MCP do NicoChat (em 30 segundos)

MCP (Model Context Protocol) é um protocolo aberto que conecta assistentes de IA a ferramentas externas. A especificação oficial está em modelcontextprotocol.io. O NicoChat oferece um servidor MCP oficial que expõe a plataforma inteira para qualquer cliente compatível. Isso inclui Claude, ChatGPT, Cursor, Codex e, claro, o GitHub Copilot no VS Code.

Na prática, o assistente ganha ferramentas para listar canais, autorar fluxos e subfluxos, gerenciar contatos e tags, disparar broadcasts e ler analytics. O servidor inclui até documentação de autoria embutida. Assim, o Copilot consulta a referência antes de montar um fluxo e escreve a estrutura correta.

Vale registrar o diferencial com precisão. Consumir servidores MCP externos nos bots é algo que outras plataformas também fazem. Já expor um servidor MCP oficial para criar e editar automações por assistente de IA é um lado que nenhum concorrente brasileiro oferece hoje.

Pré-requisitos

Antes de começar, confirme três coisas:

VS Code atualizado com a extensão GitHub Copilot e o Copilot Chat habilitado.
Modo agente disponível no Copilot Chat (é o modo “Agent” no seletor do chat).
Conta no NicoChat com acesso ao workspace que você quer operar. Ainda não tem? O teste grátis de 7 dias não pede cartão.

Não precisa de token manual, chave de API nem servidor local. A autenticação é OAuth: o VS Code abre o navegador e você faz login na sua conta NicoChat.

Configurando o mcp.json no VS Code

Opção 1: por projeto (recomendada para times)

Crie o arquivo .vscode/mcp.json na raiz do repositório com este conteúdo exato:

{
  "servers": {
    "nicochat": {
      "type": "http",
      "url": "https://mcp.nicochat.com/mcp"
    }
  }
}

O formato do arquivo e o suporte a MCP estão descritos na documentação oficial do VS Code. Salve o arquivo. O VS Code detecta o servidor e mostra um botão “Start” sobre a configuração. Ao iniciar, ele abre o navegador para o login OAuth do NicoChat. Autorize, volte ao editor e pronto: as ferramentas aparecem no Copilot Chat em modo agente.

A vantagem da configuração por projeto é simples: o mcp.json entra no Git. Todo dev que clonar o repositório recebe a mesma configuração. Cada um autentica com a própria conta, então as permissões continuam individuais.

Opção 2: global (para uso pessoal)

Prefere ter o NicoChat disponível em qualquer projeto? Abra a paleta de comandos (Ctrl+Shift+P) e rode MCP: Open User Configuration. Cole o mesmo bloco JSON no arquivo que abrir. A configuração global vale para todos os workspaces do seu VS Code.

Testando a conexão

Abra o Copilot Chat, selecione o modo Agent e envie um primeiro prompt:

Liste meus canais do NicoChat e resuma o que cada um faz.

Se o Copilot responder com seus canais reais, a conexão está funcionando. Agora vem a parte boa.

Caso de uso 1: automações versionadas junto do código do produto

Este é o cenário que justifica o VS Code em vez de outro cliente MCP. Seu time já mantém o produto em um repositório. O atendimento automatizado conversa com esse produto: consulta pedidos, dispara notificações, abre chamados. Faz sentido que a lógica do atendimento more no mesmo projeto.

Com o MCP no VS Code, o fluxo de trabalho vira este: o time documenta as automações em arquivos Markdown no repositório. Quando algo muda no produto, o dev pede ao Copilot para aplicar a mudança correspondente no NicoChat. A documentação e a plataforma evoluem juntas, no mesmo pull request.

Prompts prontos para esse cenário:

Leia docs/atendimento/fluxo-pedidos.md e compare com o fluxo
"Status de Pedido" no canal de WhatsApp do NicoChat. Liste as
diferenças e me pergunte antes de aplicar qualquer mudança.

Acabamos de renomear o endpoint /orders para /v2/orders neste repo.
Encontre todos os blocos de API nos fluxos do NicoChat que chamam
o endpoint antigo e liste onde estão.

Crie um subfluxo de rastreamento de entrega no canal de WhatsApp,
seguindo o padrão descrito em docs/atendimento/convencoes.md.

Repare no padrão dos prompts: contexto do repositório mais ação na plataforma. É a combinação que nenhum cliente de chat avulso entrega.

como estruturar fluxos de atendimento no WhatsApp

Caso de uso 2: Copilot escrevendo js_function e blocos de API

O NicoChat tem dois blocos de extensibilidade no builder de fluxos. O bloco api faz requisições HTTP para qualquer serviço externo. O bloco js_function roda JavaScript no servidor do NicoChat, dentro do próprio fluxo. São os pontos onde o atendimento encosta no seu backend.

Escrever esse código no painel funciona, mas o editor é o lugar natural do dev. Com o MCP conectado, o Copilot escreve o JavaScript com o contexto do seu projeto aberto. Ele conhece os contratos da sua API porque os arquivos estão ali, no workspace.

Prompts prontos:

No fluxo "Qualificação de Leads", crie um bloco js_function que
normalize o telefone do contato para o formato E.164 e salve o
resultado na variável telefone_formatado.

Nosso backend expõe POST /api/tickets, conforme src/routes/tickets.ts.
Crie um bloco de API no fluxo "Suporte" que abra um ticket com nome,
telefone e resumo da conversa. Trate erro com mensagem de fallback.

Revise o código do js_function "calcula-frete" no canal de WhatsApp.
Aponte problemas de tratamento de erro e proponha a versão corrigida
antes de salvar.

Uma dica de segurança: peça sempre a revisão antes de salvar, como no último prompt. O modo agente do Copilot pede confirmação para ações de escrita, e essa fricção é saudável em produção.

Caso de uso 3: revisar webhooks e integrações por conversa

Integrações quebram em silêncio. Um webhook muda de payload, uma credencial expira, um mini app fica órfão depois de uma migração. Auditar isso pelo painel é trabalho manual de clicar tela por tela.

Por conversa, a auditoria vira uma pergunta. O Copilot percorre canais, integrações instaladas e blocos de API, e devolve um relatório. Você lê o resumo no chat e decide o que corrigir.

Prompts prontos:

Liste todas as integrações instaladas nos meus canais do NicoChat.
Para cada uma, diga em quais fluxos ela é usada.

Percorra os fluxos do canal de WhatsApp e liste todos os blocos de
API com a URL chamada, o método e o fluxo onde estão. Formate como
tabela para eu colar no nosso runbook.

Compare os webhooks configurados no NicoChat com os handlers em
src/webhooks/ deste repositório. Aponte webhooks sem handler
correspondente e handlers sem webhook.

O terceiro prompt é o mais valioso para times corporativos. Ele cruza a configuração da plataforma com o código real do repositório. É o tipo de verificação que raramente acontece por preguiça, e que por conversa custa um minuto.

Perguntas frequentes

O Copilot Free funciona com MCP?

Sim. O suporte a MCP no VS Code está disponível para todos os planos do GitHub Copilot, incluindo o Free. A diferença está nos limites: o plano gratuito tem cota mensal reduzida de chat e de requisições premium. Para uso diário em time, os planos pagos fazem mais sentido. Confira os limites atuais na página oficial de planos do GitHub Copilot, pois eles mudam.

Devo usar mcp.json por projeto ou global?

Para times, por projeto. O arquivo .vscode/mcp.json versionado no Git padroniza a configuração para todo mundo que clonar o repositório. Para uso pessoal em vários projetos, a configuração global (via MCP: Open User Configuration) evita repetição. Os dois formatos aceitam o mesmo bloco JSON, então migrar de um para o outro é copiar e colar.

E a segurança? O que o Copilot pode fazer na minha conta?

A autenticação é OAuth: cada dev loga com a própria conta NicoChat, e o acesso respeita as permissões dela. Nenhum token fica no mcp.json, então versionar o arquivo não expõe credenciais. Além disso, o modo agente do VS Code pede sua confirmação antes de executar ferramentas de escrita. Duas práticas recomendadas: revise cada ação de escrita antes de aprovar e use um workspace de testes para experimentar prompts novos.

perguntas sobre janela de 24h e regras da Meta

Próximos passos

Com um arquivo de configuração simples, o VS Code vira um posto de comando do seu atendimento automatizado. O time mantém automações junto do código, o Copilot escreve os blocos técnicos e as auditorias viram perguntas de chat.

Se seu editor é outro, a série continua: já mostramos a mesma conexão no Cursor e no Codex, com os ajustes de cada cliente.

NicoChat no Cursor NicoChat no Codex

Ainda não tem conta para conectar? Crie a sua com o teste grátis de 7 dias, sem cartão, e rode o primeiro prompt deste tutorial hoje.