Adicione o servidor em mcp.json, clique em conectar e autorize no navegador.
2026-09-08
No Cursor, o servidor do NicoChat entra em mcp.json como servidor remoto por URL. O Cursor detecta que o servidor exige OAuth, mostra um botão de login e abre o navegador para a autorização no NicoChat. Depois disso, o agente do chat usa as ferramentas do NicoChat como qualquer outra.
Antes de começar
URL do servidor: https://mcp.nicochat.com/mcp. É a única informação que o cliente pede; não existe chave de API para copiar.
Conta NicoChat com workspace em plano pago ou de teste, e você como proprietário ou administrador dela.
Cursor atualizado. Suporte a OAuth em servidores remotos existe desde as versões de 2025; versões antigas só aceitam servidores locais.
Passo a passo
1
Abra as configurações de MCP
Vá em Cursor Settings › Tools & MCP e clique em Add Custom MCP. O Cursor abre o arquivo mcp.json do usuário.
2
Declare o servidor
Cole o bloco abaixo. Para valer só em um repositório, coloque o mesmo conteúdo em .cursor/mcp.json na raiz do projeto.
3
Conecte
Salve o arquivo. Na lista de servidores, o NicoChat aparece com aviso de login. Clique em Connect (ou Needs login): o navegador abre na autorização do NicoChat.
4
Autorize
Faça login, escolha permissões e validade e confirme. De volta ao Cursor, o servidor fica verde e lista as ferramentas.
5
Use no chat
No chat em modo Agent, peça algo ao NicoChat. O Cursor pede confirmação antes de cada ferramenta, a menos que você ative a execução automática.
Seja qual for o cliente, a autorização acontece no navegador, na página do NicoChat. Você faz login, escolhe as permissões (leitura e análise é sempre concedida; configuração, contatos, integrações e campanhas são opcionais) e a validade da conexão: 1, 7, 30 ou 90 dias, ou sem expiração. As ferramentas que o assistente enxerga dependem do que você marcou aqui — para ampliar depois, basta reconectar.
Comece só com leitura
Na primeira conexão, conceda apenas leitura e análise e peça um diagnóstico dos seus canais. Quando estiver confortável com o que o assistente faz, reconecte concedendo configuração ou contatos.
Primeiros pedidos para testar
Com a conexão feita, peça ao Cursor em linguagem natural. Alguns exemplos que usam só leitura:
"Liste minhas workspaces e os canais de cada uma."
"Quantos contatos entraram no canal de WhatsApp nos últimos 7 dias e qual o tempo médio de primeira resposta?"
"Resuma a estrutura do canal X: fluxos, gatilhos, agentes de IA e quadros kanban."
"Quais palavras-chave estão configuradas no canal X e para onde cada uma leva?"
Se você concedeu configuração, o assistente também cria fluxos, gatilhos, tags e agentes de IA. Tudo que ele cria em fluxo fica como rascunho até você publicar no NicoChat.
Limite de ferramentas
O Cursor limita quantas ferramentas ficam ativas ao mesmo tempo. O NicoChat expõe muitas; se você tem outros servidores, desligue os que não estiver usando em Tools & MCP, ou conecte ao NicoChat só com as permissões de que precisa.
Desconectar ou revogar
No cliente: remova o bloco nicochat do mcp.json, ou desligue o servidor em Tools & MCP.
No NicoChat: em Configurações da Conta, revogue a autorização. O efeito é imediato, mesmo que o servidor continue cadastrado no cliente.
Problemas comuns
Atualize o Cursor. Se ainda assim o navegador não abrir, remova o bloco, salve, cole de novo e salve: o Cursor refaz a descoberta do servidor.
Confira se o chat está em modo Agent, não Ask. E veja se o servidor está ligado na lista de Tools & MCP.
Copie o link que o cliente mostra e abra manualmente. Se ele não mostrar link nenhum, remova o servidor e adicione de novo: o registro do cliente no NicoChat é refeito no primeiro acesso.
É o esperado quando só a permissão de leitura foi concedida. Desconecte e conecte novamente marcando as permissões de escrita que precisa.
O servidor só opera em workspaces em plano pago ou de teste em que você é proprietário ou administrador. Confira o plano e o seu papel na workspace no painel do NicoChat.
A validade escolhida na autorização venceu. Reconecte e, se preferir, escolha "sem expiração".
