Para conectar o Cursor ao NicoChat, adicione o servidor MCP oficial https://mcp.nicochat.com/mcp ao arquivo ~/.cursor/mcp.json e autorize via OAuth. A partir daí, o agente do Cursor cria fluxos, agentes de IA e broadcasts de WhatsApp e Instagram por prompt. Você não precisa abrir o painel da plataforma.
MCP (Model Context Protocol) é um protocolo aberto que conecta assistentes de IA a ferramentas externas. A especificação oficial está em modelcontextprotocol.io. O Cursor é um dos clientes MCP mais usados por devs. Neste tutorial, mostramos o setup completo e três casos de uso pensados para quem atende vários clientes: agências e devs freelancers.
Resumo rápido
- O NicoChat expõe um servidor MCP oficial em
https://mcp.nicochat.com/mcp, com login via OAuth.- No Cursor, a conexão é um bloco de 5 linhas no
~/.cursor/mcp.json.- O agente do Cursor passa a listar workspaces, criar fluxos, editar agentes de IA e consultar analytics por prompt.
- Para agências: gerencie automações de vários clientes, crie mini apps próprios (My Apps) e documente fluxos no repo de cada cliente.
- O servidor inclui documentação de autoria embutida (
reference_get), então o agente aprende a escrever fluxos corretos sozinho.
O que o MCP do NicoChat entrega dentro do Cursor
O servidor MCP oficial expõe a plataforma inteira como ferramentas para o agente. Isso inclui listar e criar canais, autorar fluxos e subfluxos, criar e editar agentes e functions de IA, gerenciar contatos, tags e campos, disparar broadcasts, consultar analytics, instalar mini apps e gerenciar templates e WhatsApp Flows.
Vale destacar o enquadramento correto do diferencial. O NicoChat trabalha com MCP nas duas direções. Primeiro: os agentes de IA da plataforma podem consumir servidores MCP externos, algo que outras ferramentas também fazem. Segundo: a plataforma expõe seu próprio servidor MCP oficial para criar e editar automações por assistente de IA. Esse segundo lado, hoje, nenhum concorrente brasileiro oferece.
Para quem vive no editor, a consequência prática é simples. O mesmo agente que escreve seu código também opera a stack de atendimento dos seus clientes. Contexto de projeto e automação ficam no mesmo lugar.
guia núcleo de automação no WhatsApp
Como conectar o Cursor ao NicoChat
O setup leva menos de dois minutos. Você edita um arquivo JSON e autoriza o acesso no navegador.
- Abra (ou crie) o arquivo
~/.cursor/mcp.json. No Windows, ele fica emC:\Users\SEU_USUARIO\.cursor\mcp.json. - Adicione o bloco do servidor NicoChat:
{
"mcpServers": {
"nicochat": {
"url": "https://mcp.nicochat.com/mcp"
}
}
}- Reinicie o Cursor ou recarregue a janela. O servidor
nicochataparece em Settings, na seção de MCP. - Na primeira chamada, o Cursor abre o navegador para o login OAuth. OAuth é o padrão de autorização que dispensa colar chaves de API no arquivo. Faça login com sua conta NicoChat e aprove o acesso.
- Teste no chat do agente: “Liste meus workspaces do NicoChat”. Se a lista voltar, a conexão está ativa.
Se o seu projeto exigir escopo por repositório, o Cursor também aceita o arquivo em .cursor/mcp.json na raiz do projeto. É útil quando cada cliente tem um repo próprio e você quer a conexão visível só ali.
mesmo setup em outros clientes
Caso 1: gerencie automações de vários clientes sem sair do editor
Este é o cenário que mais economiza tempo de agência. Cada cliente tem um workspace no NicoChat. Pelo MCP, o agente do Cursor navega entre todos eles por conversa: lista canais, puxa a estrutura de cada automação e aplica mudanças pontuais.
O fluxo de trabalho típico: você recebe um pedido do cliente por mensagem, cola o pedido no chat do Cursor e pede a alteração. O agente localiza o workspace, encontra o fluxo certo e edita. Sem trocar de aba, sem procurar login de painel.
Prompt pronto para triagem de carteira:
Liste todos os meus workspaces no NicoChat. Para cada um, traga os canais
conectados (WhatsApp, Instagram, web) e um resumo da estrutura de automação:
quantos fluxos, agentes de IA e gatilhos ativos. Monte uma tabela com
workspace, canais e pontos de atenção (canal sem automação, agente sem
função, palavra-chave sem resposta padrão).Prompt pronto para uma alteração pontual:
No workspace do cliente [NOME], canal de WhatsApp: crie um gatilho de
palavra-chave "orçamento" que inicia um fluxo de qualificação. O fluxo
pergunta nome, serviço desejado e prazo, salva as respostas em campos do
contato, aplica a tag "lead-orcamento" e move o chat para a coluna
"Qualificados" do Kanban. Antes de criar, consulte a referência de autoria
do servidor e me mostre o plano.Repare no final do segundo prompt. O servidor MCP inclui documentação de autoria embutida (a ferramenta reference_get). Pedir para o agente consultá-la antes de escrever reduz retrabalho, porque ele monta os blocos no formato que a plataforma espera.
Caso 2: crie mini apps próprios (My Apps) com ajuda do agente
My Apps é o construtor de mini apps do NicoChat: você define ações, autenticação, fontes de dados, variáveis e triggers, e o app fica disponível nos fluxos como qualquer integração nativa. É a base do white-label de integrações para agências.
Aqui o Cursor brilha, porque criar mini app é trabalho de dev. A API do cliente está documentada no repo que você já tem aberto. O agente lê a documentação local, desenha as ações e cria o mini app pelo MCP na sequência.
Prompt pronto:
Leia o arquivo docs/api-erp.md deste repo. Com base nos endpoints de
consulta de pedido e status de entrega, crie um mini app no My Apps do
NicoChat chamado "ERP [Cliente]". Defina: autenticação por API key no
header, uma ação "Consultar pedido" (input: número do pedido; output:
status, valor, previsão de entrega) e uma ação "Rastrear entrega". Depois
me mostre como usar essas ações em um fluxo de WhatsApp que responde
"onde está meu pedido".O resultado é uma integração exclusiva do seu cliente, criada a partir do código que você mantém. Para a agência, isso vira produto: cada mini app entregue é um ativo que diferencia seu serviço de quem só monta fluxo padrão.
como agências transformam automação em serviço recorrente
Caso 3: documente os fluxos do cliente direto no repo
Automação sem documentação vira caixa-preta. Quando o cliente pergunta “o que acontece quando alguém manda ‘promo’?”, a resposta não deveria depender da memória de quem montou o fluxo.
Pelo MCP, o agente do Cursor lê a estrutura real da automação (fluxos, subfluxos, gatilhos, agentes de IA, functions) e escreve a documentação em Markdown dentro do repo do cliente. A documentação nasce do estado atual da plataforma, não de anotações desatualizadas.
Prompt pronto:
Conecte no workspace do cliente [NOME] e mapeie o canal de WhatsApp:
todos os gatilhos de palavra-chave, os fluxos que cada um dispara, os
agentes de IA com seus papéis e as functions que eles chamam. Gere um
arquivo docs/automacao-whatsapp.md neste repo com: visão geral, diagrama
em Mermaid dos caminhos principais e uma tabela de gatilhos. Marque
pontos sem tratamento de erro.Rode esse prompt de novo após cada entrega e commite o resultado. O histórico do Git passa a registrar a evolução da automação junto com o código. Na virada de equipe ou na auditoria do cliente, tudo está versionado no mesmo lugar.
Perguntas frequentes
Preciso do Cursor Pro para usar o MCP do NicoChat?
A configuração de servidores MCP está disponível no Cursor sem exigência de plano específico. O que varia por plano é a cota de uso do agente de IA, que executa as chamadas. Confira os limites do seu plano na documentação oficial do Cursor. Do lado do NicoChat, o acesso vem da sua conta na plataforma, autenticada via OAuth.
Funciona com múltiplos workspaces e clientes?
Sim. O servidor MCP expõe todos os workspaces que a sua conta acessa. O agente lista, consulta e edita qualquer um deles por conversa. Boa prática de agência: nomeie os workspaces pelo cliente e peça sempre para o agente confirmar o workspace alvo antes de editar.
Posso versionar os fluxos no Git?
Os fluxos vivem na plataforma, não em arquivos no repo. O que você versiona é a documentação gerada a partir deles, como no caso 3 acima. Na prática, isso cobre o que o versionamento resolve: histórico de mudanças, revisão e transferência de conhecimento. Templates de fluxo também ajudam a replicar estruturas entre clientes.
perguntas sobre o protocolo em si
Próximo passo
O setup é um bloco de JSON e um login. A partir dele, o Cursor vira central de operação da sua carteira de clientes: triagem de workspaces, mini apps sob medida e documentação sempre atual, tudo por prompt.
Para testar, crie uma conta no NicoChat com o teste grátis de 7 dias, sem cartão. Conecte o MCP, rode o prompt de triagem do caso 1 no seu primeiro workspace e veja o agente trabalhar.