
Conectar no Gemini
Gemini CLI conectado por MCP. No app do Gemini, o suporte varia por conta.
Qual MCP você vai conectar? Os comandos abaixo mudam conforme a escolha.
- 1
Gemini CLI: adicione o servidor
O caminho confirmado é o Gemini CLI. Gere a chave (próximo passo) e cadastre o servidor por comando, trocando SUA_CHAVE pela chave gerada:
gemini mcp add --transport http --header "Authorization: Bearer SUA_CHAVE" NewAlgorithm-TOTVS https://totvs.mcp.newalgorithm.io/mcp - 2
Gere sua chave de API
Entre em app.newalgorithm.io com sua conta, abra Chaves e apps e gere uma chave. Ela aparece uma única vez: copie e guarde em local seguro.
Formato da chavena_live_xxxxxxxxxxxxxxxxx - 3
Ou escreva a configuração direto
O arquivo do usuário fica em ~/.gemini/settings.json. Para Streamable HTTP, o campo é httpUrl — url é reservado a servidores SSE:
~/.gemini/settings.json{ "mcpServers": { "NewAlgorithm-TOTVS": { "httpUrl": "https://totvs.mcp.newalgorithm.io/mcp", "headers": { "Authorization": "Bearer SUA_CHAVE" } } } } - 4
Sem chave: login OAuth
Se você cadastrar o servidor sem o cabeçalho, o CLI detecta que o NewAlgorithm pede login e inicia o fluxo OAuth no navegador. Dentro da sessão, autentique com:
/mcp auth NewAlgorithm-TOTVSEsperado: O OAuth precisa de um navegador local; em ambiente sem interface, use a API Key.
- 5
Confirme
Dentro da sessão do CLI, liste os servidores e as ferramentas carregadas:
/mcpEsperado: NewAlgorithm-TOTVS — Connected na_prepare, na_search, na_route, na_specialists, na_version
- 6
E no app do Gemini?
O suporte a apps MCP personalizados no app do Gemini depende do tipo de conta e da região. O Specialist Fiscal também está publicado como Gem, um caminho separado do MCP, aberto pela página do Specialist.
Nunca grave a chave real em arquivos versionados. Prefira o settings.json do usuário, fora do repositório.
Detalhes de autenticação e ferramentas na Documentação.