Para conectar o Windsurf ao NicoChat via MCP, adicione o servidor https://mcp.nicochat.com/mcp ao arquivo ~/.codeium/windsurf/mcp_config.json e autorize via OAuth no navegador. Pronto: a Cascade do Windsurf passa a criar fluxos, agentes de IA e gatilhos de atendimento por conversa, sem você abrir o painel do NicoChat. Este tutorial mostra o setup completo e três casos de uso que fazem sentido justamente no Windsurf.
Este post faz parte da série “Construa com IA”. Se você ainda não sabe o que é MCP, comece pelo guia central. o que é o 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 Windsurf, a configuração fica em
~/.codeium/windsurf/mcp_config.json, dentro da chavemcpServers.- Depois de conectado, a Cascade cria fluxos, keywords, agentes de IA e gatilhos direto na plataforma.
- Três casos práticos deste tutorial: protótipo de chatbot em uma sessão, migração entre canais com templates e gatilhos de evento por conversa.
- Funciona no plano gratuito do Windsurf, desde que o modelo escolhido suporte chamadas de ferramenta.
O que o MCP do NicoChat destrava dentro do Windsurf
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 trabalha com MCP nas duas direções. Seus agentes e fluxos podem consumir servidores MCP externos. E a plataforma expõe o próprio servidor MCP oficial, para você criar e editar automações a partir de qualquer cliente compatível. Esse segundo lado é o que nenhum concorrente brasileiro oferece hoje.
Na prática, dentro do Windsurf, isso significa operar o NicoChat por linguagem natural. A Cascade lista canais, cria fluxos e subfluxos, configura keywords, edita agentes de IA, gerencia contatos e consulta analytics. O servidor inclui documentação de autoria embutida, que o assistente consulta antes de escrever um fluxo. Isso reduz o vaivém clássico de “IA inventou um campo que não existe”.
Como conectar o Windsurf ao NicoChat
O setup leva uns cinco minutos. Você precisa de uma conta NicoChat (o teste grátis serve) e do Windsurf instalado.
1. Edite o arquivo de configuração MCP
Abra o arquivo ~/.codeium/windsurf/mcp_config.json. Se ele não existir, crie. Você também chega nele pela interface: ícone de martelo na Cascade, depois “Configure” (ou “MCP Servers” nas configurações do Windsurf). O formato do arquivo está descrito na documentação oficial do Windsurf.
Adicione o servidor do NicoChat:
{
"mcpServers": {
"nicochat": {
"serverUrl": "https://mcp.nicochat.com/mcp"
}
}
}Se você já tem outros servidores no arquivo, acrescente apenas a entrada "nicochat" dentro de mcpServers.
2. Autorize via OAuth
Salve o arquivo e clique em “Refresh” na lista de servidores MCP da Cascade. O Windsurf abre o navegador com a tela de login do NicoChat. Entre com sua conta e autorize o acesso. Sem chave de API para copiar, sem token para colar: o OAuth cuida da sessão.
3. Teste a conexão
Na Cascade, mande um prompt simples:
Liste meus workspaces e canais do NicoChat.Se a resposta trouxer seus canais reais, está conectado. A partir daqui, todo prompt pode ler e escrever na plataforma. Vale a regra de sempre com agentes que executam ações: revise o que a IA propõe antes de aprovar chamadas de escrita.
Caso 1: protótipo de chatbot completo em uma sessão
Este é o caso que mais aproveita o modo agêntico do Windsurf. A Cascade encadeia várias chamadas de ferramenta sozinha. Então dá para pedir o pacote inteiro: fluxo, gatilho de keyword e teste, num prompt só.
Prompt pronto:
No canal de WhatsApp do meu workspace, crie um protótipo de chatbot de qualificação para uma clínica de estética:
1. Fluxo de boas-vindas que pergunta nome e procedimento de interesse, salvando em variáveis.
2. Condição: se o interesse for "avaliação", ofereça dois horários com botões. Senão, envie o link do catálogo.
3. Keyword "AGENDAR" como gatilho de entrada do fluxo.
4. Ao final, me mostre a estrutura criada e o que devo testar manualmente.
Consulte a referência de autoria do MCP antes de montar os blocos.A Cascade consulta a documentação embutida, cria o fluxo com blocos de pergunta e condição, registra a keyword e devolve o resumo. Em uma sessão você sai do zero para um protótipo testável no próprio WhatsApp. Ajustes finos de copy e layout você faz depois, no builder visual ou por novos prompts.
Caso 2: migrar automação entre canais com templates
Você montou uma automação boa no WhatsApp e quer a mesma lógica no Instagram ou no Telegram. O foco aqui é a migração única, bem revisada, com relatório de diferenças ao final. O caminho nativo do NicoChat são os templates de fluxo: a instalação de um template migra conteúdo entre canais de tipos diferentes. Pelo MCP, você orquestra isso por conversa, sem clicar de tela em tela. Para repetir a mesma operação em lote, em vários canais de uma vez, o post do Codex desta série é o caminho.
Prompt pronto:
Pegue o fluxo "Qualificação de leads" do meu canal de WhatsApp e transforme em template.
Depois instale esse template no meu canal de Instagram.
Liste o que não migrou de forma equivalente (botões, mídias, blocos específicos de canal) para eu revisar.O pedido da lista de diferenças é a parte importante. Cada canal tem recursos próprios, e uma migração cega quebra a experiência. Peça sempre o relatório do que precisa de adaptação manual. O Windsurf ajuda aqui porque mantém o contexto da conversa: você revisa item por item e manda corrigir na sequência.
Caso 3: gatilhos de evento sem abrir o painel
Gatilhos de evento são o tipo de configuração que a gente esquece onde fica no menu. O NicoChat suporta gatilhos como data/hora agendada, mudança de valor de variável, novo contato e chat finalizado. Pelo MCP, você descreve a regra e a Cascade cria o gatilho.
Dois prompts prontos:
No canal de WhatsApp, crie um gatilho de data/hora: todo dia 28 às 9h, dispare o subfluxo "Lembrete de renovação" para contatos com a tag "assinante".Crie um gatilho de mudança de variável: quando o campo "status_pedido" de um contato mudar para "enviado", dispare o fluxo que manda o código de rastreio.Antes de criar, peça para a Cascade listar os gatilhos existentes do canal. Assim você evita regras duplicadas disparando duas mensagens para o mesmo evento. Esse tipo de auditoria (“liste tudo que dispara automação neste canal”) é rápido por conversa e tedioso no clique a clique.
Perguntas frequentes
O plano gratuito do Windsurf funciona com o MCP do NicoChat?
Funciona. O suporte a MCP está disponível no Windsurf sem exigir plano pago. O ponto de atenção é o modelo: escolha um modelo que suporte chamadas de ferramenta (tool calling). Modelos mais capazes erram menos na autoria de fluxos com muitos blocos. Confira limites atuais na página de preços do Windsurf, pois planos mudam.
Qual a diferença entre usar Windsurf e Cursor com o NicoChat?
O servidor MCP é o mesmo, então as capacidades são idênticas. A diferença está no cliente: local do arquivo de configuração, comportamento do agente e política de aprovação de ferramentas. No Cursor, a configuração fica em .cursor/mcp.json. Já testamos os dois cenários no blog. tutorial completo do Cursor Quem prefere o Copilot também tem caminho. configurar no VS Code
Preciso saber programar para usar isso?
Para este tutorial, não. Você edita um arquivo JSON e escreve prompts em português. Programar ajuda em casos avançados, como blocos de requisição HTTP e funções JavaScript no fluxo. Se você não é dev, o builder visual do NicoChat resolve sem código nenhum. criar chatbot sem programar
Próximo passo
O MCP transforma o Windsurf em um copiloto de automação de atendimento. Você prototipa um chatbot em uma sessão, migra lógica entre canais com templates e configura gatilhos de evento sem caçar menus. E o fluxo criado por conversa é o mesmo fluxo do builder visual: seu time ajusta depois onde preferir.
Se você está começando em automação de atendimento, o guia completo de WhatsApp é a base de tudo isso. guia completo de automação no WhatsApp
Para testar hoje: crie sua conta no teste grátis de 7 dias do NicoChat, sem cartão, conecte o Windsurf com o bloco de configuração acima e rode o prompt do Caso 1. Em uma sessão você terá seu primeiro chatbot criado por conversa.