MCP do NicoChat/Gemini CLI - Conectar o MCP

Gemini CLI - Conectar o MCP

Declare o servidor em settings.json com OAuth ligado e autentique pelo comando /mcp auth.

2026-09-08

No Gemini CLI, o servidor do NicoChat é declarado no arquivo settings.json com transporte HTTP e OAuth habilitado. Na primeira sessão, o comando /mcp auth abre o navegador para a autorização no NicoChat, e o token fica guardado localmente para as próximas.

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.
Gemini CLI instalado e autenticado (gemini abre no terminal).

Passo a passo

Edite o settings.json

Abra ~/.gemini/settings.json (configuração do usuário) ou .gemini/settings.json na raiz do projeto (só aquele projeto). Acrescente o bloco abaixo em mcpServers.

Abra o Gemini CLI

Rode gemini. Digite /mcp para listar os servidores: o NicoChat aparece pedindo autenticação.

Autentique

Digite /mcp auth nicochat. 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 conectado e a lista de ferramentas.

json

{
  "mcpServers": {
    "nicochat": {
      "httpUrl": "https://mcp.nicochat.com/mcp",
      "oauth": {
        "enabled": true
      }
    }
  }
}

Também é possível registrar pela linha de comando, sem editar o arquivo à mão:

bash

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

Nesse caso, confira se o bloco gerado ficou com oauth.enabled em true; sem isso o Gemini CLI não inicia a autorização.

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

Desconectar ou revogar

No cliente: remova o bloco nicochat do settings.json, ou rode gemini mcp remove nicochat. O token local fica em ~/.gemini/mcp-oauth-tokens.json e pode ser apagado.
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 oauth.enabled está em true e se a chave usada é httpUrl, não url. Depois rode /mcp auth nicochat.

O Gemini CLI mostra a URL de autorização no terminal. Abra a URL em outro dispositivo, autorize e cole de volta o código quando ele pedir.

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