NicoChatNicoChatDocumentaçãoBuscar na documentação…
Entrar
MCP do NicoChat/VS Code - Conectar o MCP

VS Code - Conectar o MCP

Registre o servidor em mcp.json com tipo http e use pelo Copilot Chat em modo agente.

2026-09-08

No VS Code, servidores MCP são usados pelo GitHub Copilot Chat em modo agente. O NicoChat entra em mcp.json como servidor do tipo http; ao iniciar, o VS Code detecta o OAuth e pede para autorizar no navegador.

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.
  • VS Code atualizado com a extensão GitHub Copilot Chat e uma assinatura do Copilot.
  • Em organizações, o administrador do GitHub precisa ter a política de servidores MCP habilitada.

Passo a passo

1
Adicione o servidor
Abra a paleta de comandos e rode MCP: Add Server. Escolha HTTP (HTTP or Server-Sent Events), cole a URL do servidor e dê o nome nicochat.
2
Escolha o escopo
O VS Code pergunta se o servidor vale para o usuário (todos os projetos) ou para a workspace atual. Na workspace, ele grava em .vscode/mcp.json, arquivo que pode ir para o repositório.
3
Inicie e autorize
No arquivo mcp.json aberto, clique em Start acima do servidor. O VS Code mostra que o servidor pede autenticação e abre o navegador na autorização do NicoChat. Faça login, escolha permissões e validade e confirme.
4
Use no Copilot Chat
Abra o Copilot Chat, mude para o modo Agent e confira, no ícone de ferramentas, que o servidor nicochat está marcado.

Se preferir escrever o arquivo à mão, o conteúdo de .vscode/mcp.json é este. Note que a chave é servers e o campo type é obrigatório:

json
{
  "servers": {
    "nicochat": {
      "type": "http",
      "url": "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 Copilot 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 128 ferramentas
O VS Code aceita no máximo 128 ferramentas ativas por pedido. O NicoChat expõe mais que isso quando todas as permissões estão concedidas. Conecte só com as permissões de que precisa, ou desmarque grupos de ferramentas no ícone de ferramentas do chat.

Desconectar ou revogar

  • No cliente: rode MCP: List Servers, escolha nicochat e Uninstall, ou apague o bloco do mcp.json.
  • No NicoChat: em Configurações da Conta, revogue a autorização. O efeito é imediato, mesmo que o servidor continue cadastrado no cliente.

Problemas comuns

Todo servidor em mcp.json precisa de "type": "http" ou "type": "stdio". Sem o campo, o VS Code recusa o bloco.
Rode MCP: List Servers › nicochat › Restart. Se persistir, use a conta em Accounts (canto inferior esquerdo) para remover a autorização guardada e refaça.
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".