Gemini CLI e MCP Remoto: Executando Operações de Formulário pelo Terminal

O Gemini CLI se torna mais interessante quando pode alcançar os sistemas onde o trabalho realmente acontece.

Geração de código e pesquisa são úteis. Mas se o CLI também pode chamar um servidor MCP remoto, ele pode criar um formulário de rascunho, inspecionar envios, configurar o manuseio de respostas ou revisar um fluxo de trabalho sem sair do terminal.

Este post usa o FORMLOVA como o exemplo de servidor de formulário MCP remoto. O objetivo é estreito: conectar o Gemini CLI a um servidor MCP HTTP remoto, autenticar com OAuth, criar um formulário de rascunho e manter as operações de escrita limitadas.

O guia completo do FORMLOVA cobre o fluxo de produto mais amplo. Este post foca no caminho de configuração do Gemini CLI.

Referência:

• Documentação do Gemini CLI: Servidores MCP com Gemini CLI

A URL do MCP Remoto

A URL do servidor MCP do FORMLOVA é:

https://formlova.com/api/mcp

Para o Gemini CLI, este é um servidor MCP HTTP remoto.

As documentações oficiais do Gemini CLI descrevem a forma de transporte HTTP assim:

gemini mcp add --transport http <nome> <url>

Então, a versão do FORMLOVA é:

gemini mcp add --transport http formlova https://formlova.com/api/mcp

Isso adiciona um servidor chamado formlova.

Escopo do Projeto ou Escopo do Usuário

Antes de adicioná-lo, decida onde você quer que a configuração resida.

Para uma configuração específica do projeto:

gemini mcp add --transport http formlova https://formlova.com/api/mcp

Para uma configuração em nível de usuário:

gemini mcp add -s user --transport http formlova https://formlova.com/api/mcp

Eu prefiro o escopo do projeto para um primeiro teste porque limita o raio de impacto. Mova para o escopo do usuário quando você souber que deseja que a ferramenta esteja disponível em vários projetos.

A Forma do settings.json

Se você gerenciar a configuração diretamente, use mcpServers.

Para um servidor HTTP remoto, a chave é httpUrl:

{
  "mcpServers": {
    "formlova": {
      "httpUrl": "https://formlova.com/api/mcp"
    }
  }
}

Não use command; isso é para servidores stdio que rodam como processos locais.

Não use url para este servidor; url é para endpoints SSE.

Para streaming HTTP remoto, use httpUrl.

Autenticação OAuth

O FORMLOVA precisa saber qual usuário está operando os formulários, então o servidor MCP usa OAuth.

O Gemini CLI suporta OAuth para servidores MCP remotos sobre transportes SSE ou HTTP. Para servidores que suportam descoberta, o CLI pode detectar a necessidade de OAuth, descobrir endpoints, abrir um navegador para autenticação, armazenar tokens e tentar a conexão novamente.

No Gemini CLI, execute:

/mcp auth formlova

Se você quiser listar servidores que precisam de autenticação:

/mcp auth

O fluxo de autenticação requer um navegador local e um callback localhost. Se você estiver dentro de um contêiner sem cabeça ou sessão SSH remota sem acesso ao navegador, faça a primeira passagem de autenticação localmente antes de depurar mais a fundo.

Confirme o Servidor

Após a autenticação, execute:

/mcp

Você deve ver o servidor formlova e suas ferramentas.

Não se preocupe em aprender todas as ferramentas na primeira execução. Um sistema de formulários pode expor ferramentas para criação de rascunhos, verificações de pré-visualização, gerenciamento de respostas, e-mails, lembretes, análises e fluxos de trabalho. Para a primeira sessão, mantenha pequeno.

Crie um Formulário de Rascunho

Use um prompt que mantenha explicitamente a operação não publicada:

Use o FORMLOVA para criar um formulário de registro de rascunho para um encontro interno de engenharia.
Peça nome, e-mail, equipe, tipo de presença, restrições alimentares e uma pergunta para o palestrante.
Mantenha-o não publicado e retorne a URL de pré-visualização.

Esse prompt testa três coisas:

O Gemini CLI pode descobrir a ferramenta MCP
OAuth está funcionando
O servidor remoto pode criar um rascunho e retornar uma pré-visualização

Não publica imediatamente nada.

Um Prompt Mais Realista

Para um fluxo de trabalho real, dê ao modelo mais do que uma lista de campos.

Exemplo:

Use o FORMLOVA para criar um formulário de contato de rascunho para uma startup de ferramentas para desenvolvedores.

Campos obrigatórios:
- nome
- e-mail de trabalho
- empresa
- tipo de consulta
- mensagem

Campos opcionais:
- tamanho da empresa
- ferramenta de fluxo de trabalho atual
- prazo esperado

Requisitos operacionais:
- consultas de preços devem ser fáceis de encontrar
- vendas óbvias devem ser fáceis de excluir
- o e-mail de confirmação deve mencionar que as respostas geralmente levam de 1 a 2 dias úteis
- o formulário deve ser confortável em dispositivos móveis

Mantenha o formulário não publicado.
Retorne a URL de pré-visualização.
Então revise o rascunho em busca de fricções móveis e lacunas no gerenciamento de respostas.

Este é um teste melhor porque verifica se o Gemini CLI pode coordenar uma operação de produto real, não apenas gerar uma resposta em formato de formulário.

O prompt contém: