Configuração de agente de IA

Essentras no Gemini CLI

O Gemini CLI se conecta à Essentras pelo objeto mcpServers no settings.json. Use httpUrl para https://essentras.com/api/mcp, pois o Gemini CLI lê url como um endereço SSE. A Essentras não exige conta, chave de API nem OAuth. O Gemini busca veículos, cota um carrinho e executa verificadores, e então entrega um link de checkout para você abrir e pagar.

Início rápido

Adicione o servidor
Execute o comando abaixo. O escopo padrão é o projeto, e -s user o salva para todas as pastas.
Verifique
Execute gemini mcp list, ou digite /mcp em uma sessão para ver CONNECTED e as ferramentas.
Peça e confirme
O Gemini pergunta antes de cada chamada: Proceed once, Always allow this tool, Always allow this server ou Cancel.

Configuração do MCP

Grava em .gemini/settings.json para o projeto, ou em ~/.gemini/settings.json com -s user.

BASH

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

Ou edite o settings.json manualmente. httpUrl significa Streamable HTTP, url significa SSE.

JSON

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

Exemplos de prompts

Busque na Essentras veículos no Brasil por menos de $300.
Cote msn e yahoo-finance juntos e me mostre o link de checkout.
Uma avaliação que ameaça extorsão pode ser removida do Google?
Uma entrevista em um jornal local conta para a notoriedade na Wikipedia?
Qual é o caminho legal para remover meu endereço residencial dos resultados do Google?

O que ele pode fazer aqui

10 ferramentas somente leitura. Nenhuma processa pagamento.

search_outlets

Encontre veículos por país, tema, preço, autoridade ou política de links

get_outlet

Leia 1 veículo na íntegra

quote_placements

Cote uma cesta e receba o link de checkout

list_services

Liste todos os serviços além das publicações, com preços

quote_service

Cote 1 serviço e receba a página onde o comprador paga

check_review_removability

Esta avaliação do Google pode ser removida com base em uma regra específica do Google?

check_knowledge_panel_readiness

Esta pessoa ou marca está pronta para um Google Knowledge Panel?

check_wikipedia_notability

Cada fonte conta para a relevância na Wikipedia?

find_removal_route

Qual é o caminho legal para remover do Google um resultado sobre uma pessoa?

check_instagram_recovery_path

Qual é o caminho oficial de recuperação para uma conta do Instagram hackeada, desativada ou bloqueada?

Fluxos de trabalho comuns

Da busca por orçamento ao checkout

Informe um objetivo, um país e um teto de preço. O Gemini chama search_outlets, depois quote_placements, e exibe os itens, o eventual desconto por volume e o checkout_url. Abra o link, revise o carrinho e pague.

REST sem configuração

Se preferir não alterar as configurações, peça ao Gemini para executar curl em https://essentras.com/api/agent/v1. As chamadas REST não exigem configuração e retornam a mesma cotação e o mesmo checkout_url.

Analise um caso

Descreva uma avaliação ou um pedido de remoção. O Gemini aciona o verificador com opções fixas e informa o veredito e a regra que o embasa. O preço de qualquer serviço compatível vem depois da via gratuita.

Dicas para ter sucesso

As ferramentas aparecem como mcp_essentras_search_outlets e assim por diante. Evite sublinhados nos nomes de servidor.
Mantenha trust como false. Ele ignora todas as confirmações do servidor.
Use includeTools para expor apenas algumas ferramentas, como search_outlets e quote_placements.
Execute gemini --debug para uma saída detalhada e pressione F12 para abrir o console de depuração.

FAQ

Perguntas frequentes

Devo usar url ou httpUrl?▾

Use httpUrl. No Gemini CLI, httpUrl seleciona o transporte Streamable HTTP e url seleciona SSE. A Essentras opera com Streamable HTTP, então uma entrada com url não é compatível. A flag --transport http do gemini mcp add também seleciona Streamable HTTP, então qualquer uma funciona.

Migrei para o Antigravity CLI. A Essentras funciona nele?▾

O Antigravity CLI lê os servidores MCP de ~/.gemini/config/mcp_config.json, ou de .agents/mcp_config.json em um projeto, em mcpServers. A documentação informa que os campos legados url e httpUrl não são compatíveis. Use serverUrl com https://essentras.com/api/mcp e digite /mcp para abrir o gerenciador. A Essentras também não exige login nele.

O Gemini CLI pode pagar por uma publicação?▾

Não. O quote_placements retorna um checkout_url. Você o abre, revisa o carrinho e o total e autoriza o pagamento por conta própria. O cartão é cobrado quando o pedido é feito, e o valor é reembolsado se a publicação não sair ou se o prazo não for cumprido.

O Gemini CLI precisa de OAuth para a Essentras?▾

Não. O Gemini CLI inicia um fluxo OAuth quando um servidor responde 401 Unauthorized, e esse fluxo exige um navegador local. A Essentras é pública e não pede credenciais, então não há etapa no navegador nem token a armazenar.

Solução de problemas

A Essentras aparece como DISCONNECTED em /mcp

Confirme que você usou httpUrl, e não url, e que a URL é exatamente https://essentras.com/api/mcp. Execute gemini mcp list para ver os detalhes do erro.

Nenhum erro aparece na inicialização

Por padrão, o Gemini CLI não exibe erros de conexão MCP em segundo plano e mostra apenas 1 aviso. Execute /mcp list ou gemini mcp list.

Erro 429 ou rate_limited

A Essentras permite 120 requisições MCP por IP por minuto. Aguarde cerca de 60 segundos e tente novamente.

Referência

Documentação do Gemini CLI · Verificado em 2026-10-18
Endpoint MCP · https://essentras.com/api/mcp
API REST e OpenAPI
Briefing para agentes (agents.md)

Pronto para cotar mídia e serviços com Gemini CLI?

Pesquise mais de 3.800 veículos, cote uma cesta ou um serviço e entregue o checkout ao comprador. Sem necessidade de conta.

Ver publishers Ler agents.md