← Todas as conexões

Conectar no Gemini

Gemini CLI conectado por MCP. No app do Gemini, o suporte varia por conta.

Antes de começar, crie a sua conta gratuita.Criar conta

Qual MCP você vai conectar? Os comandos abaixo mudam conforme a escolha.

  1. 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. 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 chave
    na_live_xxxxxxxxxxxxxxxxx
  3. 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. 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-TOTVS

    Esperado: O OAuth precisa de um navegador local; em ambiente sem interface, use a API Key.

  5. 5

    Confirme

    Dentro da sessão do CLI, liste os servidores e as ferramentas carregadas:

    /mcp

    Esperado: NewAlgorithm-TOTVS — Connected na_prepare, na_search, na_route, na_specialists, na_version

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