Configurando Gemini CLI

com o Agente Trytton/Talk2Datta

Protocolo MCP Trytton/Talk2Datta Gemini Protheus IA Generativa

https://protheus.monitor.eco.br

1 / 15

📝 Pré-requisitos

O que você precisa para começar

  • 🟢
    Node.js Instalado (versão 18 ou superior)

    O Node.js é necessário para executar o Gemini CLI. Veremos a instalação nos próximos slides.

  • 📦
    Gemini CLI Instalado

    Ferramenta de linha de comando do Google para usar o Gemini.

  • 🔑
    Credenciais Talk2Datta Protheus

    Usuário e senha para autenticação no agente.

2 / 15

🔍 Verificar se o Node.js está Instalado

Primeiro, vamos verificar se você já tem o Node.js

PowerShell / Terminal

$ node --version


# ✅ Se instalado, você verá algo como:

v20.10.0


# ❌ Se NÃO instalado, você verá:

'node' não é reconhecido como um comando interno...

ou: command not found: node

💡 Se o Node.js NÃO está instalado, siga os próximos slides para instalar no seu sistema operacional.

3 / 15

💻 Instalar Node.js no Windows

Passo 1: Baixar o instalador

  • 1️⃣
    Acesse o site oficial do Node.js

    Abra seu navegador e vá para:

  • 2️⃣
    Clique no botão "LTS" (versão recomendada)

    O download do arquivo .msi começará automaticamente

    ✅ Resultado esperado: Arquivo "node-vXX.XX.X-x64.msi" baixado na pasta Downloads

💡 Dica: Sempre escolha a versão LTS (Long Term Support) para maior estabilidade

4 / 15

💻 Instalar Node.js no Windows

Passo 2: Executar o instalador

  • 3️⃣
    Clique duas vezes no arquivo baixado

    O instalador do Node.js será aberto

    ✅ Resultado esperado: Janela do "Node.js Setup Wizard" aparece

  • 4️⃣
    Clique em "Next" em todas as telas

    Aceite os termos e mantenha as opções padrão

    ✅ Marque a opção "Automatically install necessary tools" se perguntado

  • 5️⃣
    Clique em "Install" e depois "Finish"

    Aguarde a instalação completar

    ✅ Resultado esperado: Mensagem "Completed the Node.js Setup Wizard"

5 / 15

💻 Instalar Node.js no Windows

Passo 3: Verificar a instalação

PowerShell (Abra um NOVO terminal)

# Verificar versão do Node.js:

PS C:\Users\SeuUsuario> node --version

v20.10.0


# Verificar versão do npm (instalado junto):

PS C:\Users\SeuUsuario> npm --version

10.2.3

Sucesso! Se você vê os números de versão, o Node.js está instalado corretamente!

⚠️ Importante: Feche e abra novamente o terminal após a instalação

6 / 15

🐧 Instalar Node.js no Linux

Usando NodeSource (Ubuntu/Debian)

Terminal Linux

# Passo 1: Atualizar lista de pacotes

$ sudo apt update

Hit:1 http://archive.ubuntu.com/ubuntu focal InRelease

Reading package lists... Done


# Passo 2: Instalar curl (se não tiver)

$ sudo apt install -y curl

curl já é a versão mais recente (7.68.0-1ubuntu2)

💡 Você precisará digitar sua senha quando usar sudo

7 / 15

🐧 Instalar Node.js no Linux

Baixar e configurar o repositório NodeSource

Terminal Linux

# Passo 3: Baixar e executar script de configuração do Node.js 20

$ curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -


## Adding the NodeSource signing key...

## Creating apt sources list file...

## Run 'sudo apt-get install -y nodejs' to install Node.js 20.x

Resultado esperado: O script configura o repositório e mostra a mensagem de sucesso

8 / 15

🐧 Instalar Node.js no Linux

Instalar o Node.js e verificar

Terminal Linux

# Passo 4: Instalar o Node.js

$ sudo apt install -y nodejs

nodejs está instalado como a versão mais recente (20.10.0-1nodesource1)


# Passo 5: Verificar a instalação

$ node --version

v20.10.0


$ npm --version

10.2.3

Sucesso! Node.js e npm estão instalados e prontos para uso!

9 / 15

🚀 Instalar Gemini CLI

Agora vamos instalar o Gemini CLI usando npm

Terminal / PowerShell

# Instalar Gemini CLI globalmente:

$ npm install -g @google/gemini-cli


added 150 packages in 15s

✓ Instalação concluída!

Resultado esperado: O npm vai baixar e instalar o pacote. Aguarde até ver a mensagem de conclusão.

⚠️ No Linux, se der erro de permissão, use: sudo npm install -g @google/gemini-cli

10 / 15

🔐 Verificar e Fazer Login no Gemini

Confirme a instalação e autentique sua conta Google

Terminal / PowerShell

# Verificar se o Gemini CLI foi instalado:

$ gemini --version

@google/gemini-cli/0.1.x


# Fazer login com sua conta Google:

$ gemini

Opening browser for authentication...

✓ Successfully authenticated!

Resultado esperado: O navegador abre para você fazer login com sua conta Google

🔐 Autorize o acesso e o terminal mostrará a mensagem de sucesso

11 / 15

📁 Localizar Arquivo de Configuração

Encontre o arquivo settings.json do Gemini

📁 Explorador de Arquivos - Windows
📁 C:\Users\seu_usuario\
📁 .gemini\
📄 settings.json EDITAR ESTE

Caminho padrão:

%USERPROFILE%\.gemini\settings.json
12 / 15

✏ Adicionar Configuração Trytton/Talk2Datta

Insira o servidor no objeto mcpServers

📄 settings.json JSON
{
  "mcpServers": {
    "agente_trytton": {
      "httpUrl": "https://protheus.monitor.eco.br",
      "enabled": true
    }
  }
}
🔒

Conexão Segura
HTTPS

📡

Protocolo MCP HTTP
Streaming

13 / 15

🔍 Como Funciona

Entendendo a configuração

  • 🏷
    agente_trytton

    Nome local dado ao servidor para referência no Gemini.

  • 🌐
    httpUrl

    A URL HTTPS onde o Agente Trytton/Talk2Datta está hospedado.

  • enabled

    Use true ou false para ativar/desativar o agente rapidamente.

14 / 15

🚀 Validar Instalação

Reinicie o Gemini CLI e verifique as ferramentas

👤
List tools from agente_trytton
🤖

Here are the tools available from agente_trytton:

  • user_login: Autenticação no sistema
  • execute_sql: Executa queries SQL
  • list_connections: Lista conexões

Agente carregado com sucesso!

15 / 15

🔐 Autenticar no Servidor

Faça login para acessar suas conexões e dados

👤
Faça login no Agente Trytton com usuário: meu_usuario e senha: minha_senha
🤖

Autenticando no Agente Trytton/Talk2Datta...

Login realizado com sucesso!

Usuário: meu_usuario

Organização: Minha Empresa

Use ou clique nos botões para navegar