MCP do NicoChat/Claude Code - Conectar o MCP

Claude Code - Conectar o MCP

Um comando no terminal registra o servidor; a autorização acontece no navegador na primeira sessão.

2026-09-08

No Claude Code, o servidor do NicoChat é adicionado com um único comando e autorizado pelo próprio terminal. Depois disso, qualquer sessão do Claude Code naquele escopo tem as ferramentas do NicoChat disponíveis, e você pode misturar operação da conta com trabalho em código: por exemplo, ler um fluxo do canal e gerar a documentação dele no seu repositório.

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.
Claude Code instalado e autenticado (claude abre no terminal).

Passo a passo

Registre o servidor

No terminal, rode o comando abaixo. O transporte é HTTP e o nome nicochat é como o servidor vai aparecer nas ferramentas.

Autorize

Abra o Claude Code e digite /mcp. Selecione nicochat e escolha autenticar: o navegador abre na página de autorização do NicoChat. Faça login, escolha permissões e validade e confirme.

Confirme

De volta ao terminal, /mcp mostra o servidor como conectado e lista as ferramentas disponíveis, que aparecem com o prefixo mcp__nicochat__.

bash

claude mcp add --transport http nicochat https://mcp.nicochat.com/mcp

Escopo da configuração

Por padrão o servidor fica no escopo local, válido só para o projeto atual. Para tê-lo em todos os projetos, adicione --scope user. Para compartilhar com a equipe pelo repositório, use --scope project: isso grava um arquivo .mcp.json na raiz, e cada pessoa faz a própria autorização.

bash

claude mcp add --transport http --scope user nicochat 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 Claude Code 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.

Aprovação de ferramentas

O Claude Code pede confirmação antes de cada ferramenta de escrita na primeira vez. Para operações de leitura repetitivas, você pode aprovar "sempre neste projeto" quando ele perguntar.

Desconectar ou revogar

No cliente: rode claude mcp remove nicochat. Se registrou em mais de um escopo, informe --scope.
No NicoChat: em Configurações da Conta, revogue a autorização. O efeito é imediato, mesmo que o servidor continue cadastrado no cliente.

Problemas comuns

Ele foi registrado antes em outro escopo. Rode claude mcp list para ver onde está, e claude mcp remove nicochat no escopo certo antes de adicionar de novo.

Feche e abra a sessão do Claude Code. Se persistir, remova e adicione o servidor: o token guardado localmente é descartado e a autorização é refeita.

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