MCP e agentes IDE
Chame Piloterr no Gemini CLI com httpUrl
O Gemini CLI guarda servidores MCP no settings.json em mcpServers. Use httpUrl (não url) para mcp.piloterr.com, mais headers para x-api-key, ou execute gemini mcp add --transport http.
- A chave no settings.json é httpUrl, um erro clássico se você colar o JSON do Cursor
- Opcional: gemini mcp add --transport http e -H para a chave de API
- A CLI do Google mais a lista completa de ferramentas hospedadas Piloterr
- Combina bem quando o agente já usa modelos Gemini e o hábito de busca do Google
Visão geral
httpUrl
settings.json
CLI
gemini mcp add
190+
ferramentas da biblioteca
HTTP
streamable
Por que conectar Gemini CLI
httpUrl não é url
O Cursor e muitos snippets MCP usam url. O Gemini CLI espera httpUrl. Colar sem cuidado e o servidor nunca conecta.
Dois caminhos de instalação
Edite ~/.gemini/settings.json ou execute gemini mcp add --transport http com -H x-api-key.
O Gemini ainda precisa de bypass em alvos difíceis
A busca do próprio Gemini não é um bypass de WAF. Aponte a CLI para a Piloterr quando a página estiver atrás de checagens de bot.
Health vs handshake
Use /health no navegador para ver a contagem de ferramentas. Use a CLI na raiz MCP. Não espere um app HTML na URL com barra.
Padrões Gemini CLI + Piloterr
Fluxos da CLI do Google, não uma cópia OpenAI ou Anthropic.
SERP e depois fetch profundo
Deixe o Gemini planejar as queries e force as ferramentas Google ou de crawl da Piloterr nas páginas que bloqueiam IPs de datacenter.
Maps e dados locais
Una o raciocínio do Gemini com endpoints locais ou de negócios da Piloterr quando você precisa de campos estruturados, não de um print.
settings.json nos dotfiles
Faça commit de um trecho sem a chave no repositório de dotfiles. A chave real fica só no arquivo local.
Disciplina da flag de transporte
Sempre --transport http para o servidor hospedado. stdio é só para um subconjunto local personalizado.
Gemini CLI vs Gemini na web
| Abordagem | Solução própria | Piloterr |
|---|---|---|
| gemini.google.com | Sem servidor MCP HTTP | httpUrl no settings.json |
| Colar o JSON do Cursor | A chave url está errada aqui | Renomeie para httpUrl |
| Fetch nativo do Google | Bloqueio brando em muitas lojas | Biblioteca + ferramentas unlock |
| MCP Python personalizado | Você sobe um processo | Hospedado, 190+ ferramentas |
Conecte o Gemini CLI
Passo 1
Crie uma chave de API
No painel do Piloterr. Você vai colocá-la em headers ou -H.
Crie uma chave de APIPasso 2
Adicione httpUrl no settings.json
Em mcpServers.piloterr defina httpUrl como https://mcp.piloterr.com/ e headers.x-api-key.
Passo 3
Ou use gemini mcp add
gemini mcp add --transport http com a mesma URL e -H "x-api-key: YOUR_KEY".
Passo 4
Recarregue e teste
Reinicie o Gemini CLI. Peça para rastrear uma URL ou listar as ferramentas MCP. Use /health se a contagem for zero.
Receitas de fluxo de trabalho
Briefing de notícias com a ferramenta Google News
O Gemini esboça as seções; a Piloterr preenche artigos e localidades que você de fato pediu.
Enriquecimento de localizador de lojas
O Gemini planeja os países; os endpoints finder da biblioteca devolvem lojas estruturadas.
SERP de compras e depois JSON de produto
Ferramenta de busca primeiro, ferramenta de produto em seguida, sem Chrome headless no seu notebook.
Crawl de docs para um gem do Gemini
Você rascunha as instruções do gem; o Gemini CLI puxa a central de ajuda ao vivo pelo crawler.
Gemini CLI vs outros clientes MCP
Cenário
Seu agente padrão é o Gemini CLI
Recomendação: Esta página, httpUrl
Cenário
Você usa Cursor no dia a dia
Recomendação: Cursor .mcp.json
Cenário
Você usa Claude Code
Recomendação: claude mcp add
Cenário
Você quer um agente desktop com memória
Recomendação: Hermes Agent
Config do Gemini CLI
httpUrl é obrigatório. Um campo url copiado do Cursor não vincula.
{
"mcpServers": {
"piloterr": {
"httpUrl": "https://mcp.piloterr.com/",
"headers": {
"x-api-key": "your-x-api-key"
}
}
}
}Veja também
MCP
Claude Code
Cursor
Hermes AgentPreços transparentes por crédito
Pague apenas por requisições bem-sucedidas. Comece com +500 créditos, depois escale com planos a partir de $49/mês.
Premium
$49/mês
18,000 créditos
Premium+
$99/mês
40,000 créditos
Startup
$249/mês
110,000 créditos
Pronto para começar?
Sua API de web scraping está a um clique. Comece com +500 créditos, sem infraestrutura para configurar, sem proxies para gerenciar e sem cartão de crédito necessário.
- +500 créditos
- Sem cartão de crédito
- Todos os endpoints incluídos