MCP do NicoChat/Windsurf - Conectar o MCP

Windsurf - Conectar o MCP

Declare o servidor em mcp_config.json e autorize pelo painel de MCP do Cascade.

2026-09-08

No Windsurf, servidores MCP são usados pelo Cascade. O NicoChat entra em mcp_config.json como servidor remoto por URL; depois de atualizar a lista, o Windsurf mostra o botão de login e abre o navegador para a autorização no NicoChat.

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.
Windsurf atualizado. Plano com Cascade habilitado.

Passo a passo

Abra as configurações de MCP

No Cascade, clique no ícone de MCPs (ou vá em Windsurf Settings › Cascade › MCP Servers) e escolha Add custom server. O Windsurf abre o arquivo ~/.codeium/windsurf/mcp_config.json.

Declare o servidor

Cole o bloco abaixo e salve.

Atualize a lista

De volta ao painel de MCP, clique em Refresh. O NicoChat aparece pedindo login.

Autorize

Clique em Login: o navegador abre na autorização do NicoChat. Faça login, escolha permissões e validade e confirme. O servidor passa a listar as ferramentas.

Use no Cascade

Peça algo ao NicoChat numa conversa do Cascade. Ele pede confirmação antes de cada ferramenta de escrita.

json

{
  "mcpServers": {
    "nicochat": {
      "serverUrl": "https://mcp.nicochat.com/mcp"
    }
  }
}

A tela de autorização

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 Cascade 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 Windsurf limita o total de ferramentas ativas entre todos os servidores. Se você tem outros servidores, desligue os que não estiver usando, ou conecte ao NicoChat só com as permissões de que precisa.

Desconectar ou revogar

No cliente: remova o bloco nicochat do mcp_config.json e clique em Refresh, ou desligue o servidor no painel de 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

Confira se o JSON está válido e se a chave usada é serverUrl. Clique em Refresh depois de corrigir.

Atualize o Windsurf. Em versões antigas, servidores remotos com OAuth não eram suportados.

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".