Antigravity CLI + Scrapeless: Adicionar um Servidor MCP Remoto

TL;DR:

• Antigravity CLI conecta-se ao Scrapeless como um servidor MCP remoto. Uma entrada com um serverUrl e um cabeçalho x-api-token, adicionado com agy mcp add ou escrito à mão, é toda a configuração.
• Escreva a chave em si no cabeçalho. Uma referência ${SCRAPELESS_API_KEY} é enviada como texto literal, e cada chamada de ferramenta falha então com um 401 dentro de uma execução que ainda reporta sucesso.
• agy mcp list mostra a configuração, não uma conexão ativa. Um servidor lê enabled se sua chave é válida ou não.
• Execuções sem cabeça precisam de uma regra de permissão. Ferramentas MCP começam no modo Ask, e agy -p não pode perguntar, então nega a chamada. mcp(scrapeless/scrape_markdown) em permissions.allow permite que essa ferramenta funcione.
• O nome do cabeçalho é x-api-token. Scrapeless responde a uma solicitação sem ele com 401 Unauthorized: Missing x-api-token header.
• Obtenha uma chave no plano gratuito do Scrapeless e conecte-a em poucos minutos.

Antigravity CLI, o comando agy, executa o agente Antigravity do Google a partir de um terminal, e é onde o Google agora envia pessoas que usaram o Gemini CLI com uma conta pessoal. O agente pode ler arquivos, executar comandos e pesquisar na web. O servidor MCP Scrapeless adiciona páginas renderizadas em um navegador em nuvem e retornadas como Markdown, uma sessão de navegador que o agente pode controlar passo a passo, rastreamentos em segundo plano e dados de resultados do Google.

Este guia adiciona o servidor hospedado ao Antigravity CLI e executa uma chamada de ferramenta a partir de um script. A configuração é curta. Três detalhes decidem se funciona: como a chave é escrita, qual linha de status confiar e a regra de permissão que uma execução sem cabeça precisa.

O Que o Scrapeless Adiciona ao Antigravity CLI

O servidor expõe 25 ferramentas, agrupadas por trabalho:

• scrape_markdown, scrape_html e scrape_screenshot retornam uma página renderizada como Markdown, HTML bruto ou uma imagem em uma chamada.
• Dezesseis ferramentas browser_*, de browser_create e browser_goto a browser_click, browser_type e browser_snapshot, controlam uma sessão de navegador em nuvem passo a passo.
• crawl_start, crawl_result e crawl_cancel executam um rastreamento em segundo plano e coletam depois.
• google_search e google_trends retornam resultados de pesquisa e dados de tendências, e ai_scraper captura respostas de assistentes de IA como ChatGPT, Gemini e Perplexity.

Antigravity CLI mantém uma cópia do esquema de cada ferramenta sob ~/.gemini/antigravity-cli/mcp/scrapeless/, um arquivo JSON por ferramenta, e ao testar o agente leu o esquema scrape_markdown antes de chamar a ferramenta.

Se você usar o aplicativo de desktop Antigravity em vez disso, nosso guia do Antigravity IDE cobre essa configuração.

Onde o Antigravity CLI Lê Servidores MCP

Documentação MCP do Google para Antigravity coloca a configuração em ~/.gemini/config/mcp_config.json, com um arquivo de espaço de trabalho em .agents/mcp_config.json como a alternativa local. Este guia usa o arquivo global, aquele que os testes abaixo leem. Um servidor remoto possui duas propriedades:

• serverUrl, a URL de um servidor Streamable HTTP ou SSE remoto.
• headers, cabeçalhos HTTP personalizados enviados para esse servidor.

Scrapeless é um endpoint HTTP Streamable em https://api.scrapeless.com/mcp, então nenhuma configuração de transporte é necessária.

Pré-requisitos

• Antigravity CLI, com uma conta do Google. Este guia usou agy 1.2.2 no Linux com uma conta pessoal do Google.
• Uma chave API do Scrapeless do painel Scrapeless.

Etapa 1: Adicione o Servidor

agy mcp add escreve a entrada para você. As flags vão antes do nome do servidor, e uma URL https é detectada como um servidor HTTP:

agy mcp add -H "x-api-token: YOUR_SCRAPELESS_API_KEY" scrapeless https://api.scrapeless.com/mcp

Ele responde:

Added MCP server "scrapeless" (http)

e escreve esta entrada em ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "scrapeless": {
      "disabled": false,
      "headers": {
        "x-api-token": "YOUR_SCRAPELESS_API_KEY"
      },
      "serverUrl": "https://api.scrapeless.com/mcp"
    }
  }
}

O comando coloca a chave no seu histórico de shell. Para evitar isso, escreva a mesma entrada no arquivo com um editor, e depois restrinja o arquivo ao seu usuário com chmod 600 ~/.gemini/config/mcp_config.json.

Configurando isso agora? O plano gratuito do Scrapeless cobre a conexão e suas primeiras chamadas de ferramenta.

Etapa 2: Coloque a Chave em Si no Cabeçalho

Vários clientes MCP expandem variáveis de ambiente dentro de um arquivo de configuração, e é tentador escrever "x-api-token": "${SCRAPELESS_API_KEY}" aqui também. Antigravity CLI não a expande. Com esse valor no arquivo e a variável exportada, uma execução que pediu scrape_markdown retornou isso como sua resposta:

Failed to fetch data. Error: [Scrapeless]: Request POST https://api.scrapeless.com/api/v1/unlocker/request failed with status 401

A execução em si ainda relatou "status": "SUCCESS". O Scrapeless recebeu o texto literal ${SCRAPELESS_API_KEY}, aceitou a conexão como faz para qualquer valor de cabeçalho e rejeitou a chamada da ferramenta. Escreva a chave em si no cabeçalho e proteja o arquivo em vez disso.

Etapa 3: Verifique a Lista de Servidores

Liste o que o CLI irá carregar:

agy mcp list

NAME        TYPE  STATUS   COMMAND/URL
scrapeless  http  enabled  https://api.scrapeless.com/mcp

enabled significa que a entrada está presente e não está desligada. O comando retornou em uma fração de segundo e não comprovou a chave, portanto, a verificação que conta é a chamada da ferramenta na Etapa 5.

Etapa 4: Permita a Ferramenta Antes de uma Execução Headless

Antigravity pergunta antes de executar uma ferramenta MCP para a qual não tem uma regra. Referência de permissões do Antigravity lista as ferramentas MCP sob Perguntar por padrão e as combina com mcp(server/tool), mcp(server/*) ou mcp(*). Em uma sessão interativa, isso significa um prompt de aprovação. Uma execução em modo impressão não tem ninguém para perguntar, então nega a chamada e imprime:

jetski: no output produced — a tool required the "mcp" permission that headless mode cannot prompt for, so it was auto-denied. Add an allow-rule under permissions.allow in settings.json (e.g. mcp(<target>)). Alternatively, re-run with --dangerously-skip-permissions to auto-approve all tools.

Sua saída JSON lista a chamada sob denied_actions como CallMcpTool. Adicione uma regra para a única ferramenta que seu script precisa a ~/.gemini/antigravity-cli/settings.json, próximo a quaisquer regras já existentes:

{
  "permissions": {
    "allow": ["mcp(scrapeless/scrape_markdown)"]
  }
}

Prefira uma regra assim a --dangerously-skip-permissions, que aprova todas as ações de ferramenta, arquivo e comando para a execução. mcp(scrapeless/*) permite todas as 25 ferramentas Scrapeless. Um relatório aberto no repositório do CLI, Problema do Antigravity CLI 548, descreve o modo de impressão ignorando permissions.allow. Com agy 1.2.2, a regra acima foi carregada e aplicada: o log do CLI a listou na inicialização, e a chamada foi concluída.

Etapa 5: Execute uma Chamada de Ferramenta

Peça um trabalho pequeno e verificável em modo impressão:

agy -p "Call the scrapeless MCP server's scrape_markdown tool with url https://example.com and reply with the first Markdown heading, verbatim." --output-format json

A saída JSON carrega a resposta em response:

"status": "SUCCESS"
"response": "# Example Domain\n"

O registro de conversa do Antigravity mostra como o agente chegou lá: ele leu o esquema scrape_markdown em cache, e então chamou scrape_markdown em https://example.com. As execuções levaram pouco mais de dois minutos cada, e no passo cronometrado a chamada da ferramenta em si levou cerca de cinco segundos.

Leia o texto response, não status. Uma chave incorreta, um nome de cabeçalho incorreto ou uma variável não expandida ainda produz SUCCESS, e o texto começa com Failed to fetch data.

Corrija os Problemas Comuns

Para mais informações sobre o servidor em si, leia o anúncio do servidor MCP do Scrapeless. A documentação do Browser MCP contém a referência de configuração, a página da API de Raspagem cobre os atores por trás das ferramentas, e preços lista o custo de uma chamada.

Conclusão

Adicionar o Scrapeless ao Antigravity CLI exige uma entrada em ~/.gemini/config/mcp_config.json: serverUrl configurado para https://api.scrapeless.com/mcp e um cabeçalho x-api-token que contém a chave em si. agy mcp add -H escreve em uma linha, e uma execução com script precisa de uma regra de permissão por ferramenta.

Dois resultados parecem corretos, mas não são. enabled na lista de servidores não diz nada sobre a chave, e uma execução com uma chave ruim ou uma variável não expandida ainda relata sucesso. Leia a resposta da ferramenta, e a configuração é comprovada.

Pronto para dar ao agente do Antigravity uma visão ao vivo da web? Comece com o plano gratuito do Scrapeless e adicione o servidor.

FAQ

Q: Como adiciono um servidor MCP remoto com um cabeçalho de chave de API ao Antigravity CLI?

Execute agy mcp add -H "x-api-token: YOUR_KEY" scrapeless https://api.scrapeless.com/mcp, ou adicione uma entrada com serverUrl e um objeto headers a ~/.gemini/config/mcp_config.json. As bandeiras devem vir antes do nome do servidor.
Q: O Antigravity CLI expande variáveis de ambiente nos cabeçalhos MCP?

Não nesta configuração. Um valor de cabeçalho de ${SCRAPELESS_API_KEY} foi enviado como texto literal, e a chamada da ferramenta falhou com um 401 enquanto a execução reportou sucesso. Coloque a chave no arquivo e restrinja as permissões do arquivo.

Q: Por que o agy nega minha chamada à ferramenta MCP em modo de impressão?

As ferramentas MCP executam no modo Ask por padrão, e o modo de impressão não pode mostrar um prompt, então a chamada é negada automaticamente e listada sob denied_actions. Adicione mcp(server/tool) a permissions.allow em ~/.gemini/antigravity-cli/settings.json.

Q: O habilitado na lista mcp do agy significa que a conexão funciona?

Não. Isso significa que a entrada existe e não está desativada. Uma chamada de ferramenta que retorna o conteúdo da página é a verificação.

Q: Posso usar o Gemini CLI para isso em vez disso?

O Gemini CLI não atende mais contas pessoais do Google, que agora o Google direciona para o Antigravity. O Antigravity CLI lê servidores MCP de ~/.gemini/config/mcp_config.json.

Q: Quantas ferramentas o Scrapeless adiciona ao Antigravity CLI?

25: três ferramentas scrape_*, dezesseis ferramentas browser_*, três ferramentas crawl_*, além de google_search, google_trends e ai_scraper.