Antigravity CLI + Scrapeless: Agregar un servidor MCP remoto

TL;DR:

• Antigravity CLI se conecta a Scrapeless como un servidor MCP remoto. Una entrada con un serverUrl y un encabezado x-api-token, agregado con agy mcp add o escrito a mano, es toda la configuración.
• Escribe la clave en el encabezado. Una referencia ${SCRAPELESS_API_KEY} se envía como texto literal, y cada llamada a la herramienta falla con un 401 dentro de una ejecución que aún informa éxito.
• agy mcp list muestra configuración, no una conexión funcionando. Un servidor lee enabled ya sea que su clave sea válida o no.
• Ejecuciones sin cabeza necesitan una regla de permiso. Las herramientas MCP comienzan en modo Preguntar, y agy -p no puede preguntar, por lo que niega la llamada. mcp(scrapeless/scrape_markdown) en permissions.allow permite que esa herramienta se ejecute.
• El nombre del encabezado es x-api-token. Scrapeless responde a una solicitud sin él con 401 Unauthorized: Missing x-api-token header.
• Obtén una clave en el plan gratuito de Scrapeless y conéctala en unos minutos.

Antigravity CLI, el comando agy, ejecuta el agente de Antigravity de Google desde una terminal, y es donde Google ahora envía a las personas que usaron Gemini CLI con una cuenta personal. El agente puede leer archivos, ejecutar comandos y buscar en la web. El servidor MCP de Scrapeless añade páginas renderizadas en un navegador en la nube y devueltas como Markdown, una sesión de navegador que el agente puede controlar paso a paso, rastreos en segundo plano y datos de resultados de Google.

Esta guía añade el servidor alojado a Antigravity CLI y ejecuta una llamada a la herramienta desde un script. La configuración es corta. Tres detalles deciden si funciona: cómo se escribe la clave, qué línea de estado confiar y la regla de permiso que necesita una ejecución sin cabeza.

Lo que Scrapeless Añade a Antigravity CLI

El servidor expone 25 herramientas, agrupadas por trabajo:

• scrape_markdown, scrape_html y scrape_screenshot devuelven una página renderizada como Markdown, HTML sin procesar o una imagen en una sola llamada.
• Dieciséis herramientas browser_*, desde browser_create y browser_goto hasta browser_click, browser_type y browser_snapshot, controlan una sesión de navegador en la nube paso a paso.
• crawl_start, crawl_result y crawl_cancel ejecutan un rastreo en segundo plano y lo recopilan más tarde.
• google_search y google_trends devuelven resultados de búsqueda y datos de tendencias, y ai_scraper captura respuestas de asistentes de IA como ChatGPT, Gemini y Perplexity.

Antigravity CLI mantiene una copia de cada esquema de herramienta bajo ~/.gemini/antigravity-cli/mcp/scrapeless/, un archivo JSON por herramienta, y al probar, el agente leyó el esquema scrape_markdown antes de llamar a la herramienta.

Si en su lugar usas la aplicación de escritorio Antigravity, nuestra guía de Antigravity IDE cubre esa configuración.

Dónde Lees Servidores MCP desde Antigravity CLI

Documentación de MCP de Google para Antigravity coloca la configuración en ~/.gemini/config/mcp_config.json, con un archivo de espacio de trabajo en .agents/mcp_config.json como la alternativa local. Esta guía utiliza el archivo global, el que las pruebas a continuación leen. Un servidor remoto toma dos propiedades:

• serverUrl, la URL de un servidor Streamable HTTP o SSE remoto.
• headers, encabezados HTTP personalizados enviados a ese servidor.

Scrapeless es un punto final HTTP Streamable en https://api.scrapeless.com/mcp, por lo que no se necesita configuración de transporte.

Prerrequisitos

• Antigravity CLI, con sesión iniciada con una cuenta de Google. Esta guía utilizó agy 1.2.2 en Linux con una cuenta personal de Google.
• Una clave de API de Scrapeless desde el panel de control de Scrapeless.

Paso 1: Añadir el Servidor

agy mcp add escribe la entrada para ti. Las banderas van antes del nombre del servidor, y una URL https se detecta como un servidor HTTP:

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

Responde:

Added MCP server "scrapeless" (http)

y escribe esta entrada en ~/.gemini/config/mcp_config.json:

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

El comando coloca la clave en tu historial de shell. Para evitar eso, escribe la misma entrada en el archivo con un editor, luego restringe el archivo a tu usuario con chmod 600 ~/.gemini/config/mcp_config.json.

¿Configurando esto ahora? El plan gratuito de Scrapeless cubre la conexión y tus primeras llamadas a la herramienta.

Paso 2: Pon la Clave en el Encabezado

Varios clientes MCP expanden variables de entorno dentro de un archivo de configuración, y es tentador escribir "x-api-token": "${SCRAPELESS_API_KEY}" aquí también. Antigravity CLI no lo expande. Con ese valor en el archivo y la variable exportada, una ejecución que pidió scrape_markdown devolvió esto como su respuesta:

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

La ejecución en sí misma aún informó "status": "SUCCESS". Scrapeless recibió el texto literal ${SCRAPELESS_API_KEY}, aceptó la conexión como lo hace para cualquier valor de encabezado y rechazó la llamada a la herramienta. Escribe la clave en el encabezado y protege el archivo en su lugar.

Paso 3: Verifica la Lista del Servidor

Lista lo que el CLI cargará:

agy mcp list

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

enabled significa que la entrada está presente y no está desactivada. El comando devolvió en una fracción de segundo y no probó la clave, por lo que la verificación que cuenta es la llamada a la herramienta en el Paso 5.

Paso 4: Permitir la Herramienta Antes de una Ejecución Sin Cabeza

Antigravity pregunta antes de ejecutar una herramienta MCP para la cual no tiene regla. Referencia de permisos de Antigravity lista las herramientas MCP bajo Preguntar por defecto y las empareja con mcp(server/tool), mcp(server/*) o mcp(*). En una sesión interactiva, eso significa un aviso de aprobación. Una ejecución en modo de impresión no tiene a quién preguntar, así que deniega la llamada 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.

Su salida JSON lista la llamada bajo denied_actions como CallMcpTool. Agrega una regla para la única herramienta que tu script necesita a ~/.gemini/antigravity-cli/settings.json, junto a cualquier regla que ya exista:

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

Prefiere una regla como esta a --dangerously-skip-permissions, que aprueba cada herramienta, archivo y acción de comando para la ejecución. mcp(scrapeless/*) permite todas las 25 herramientas de Scrapeless. Un informe abierto en el repositorio del CLI, Problema 548 de Antigravity CLI, describe el modo de impresión ignorando permissions.allow. Con agy 1.2.2, la regla anterior fue cargada y aplicada: el registro del CLI la listó al inicio, y la llamada se realizó.

Paso 5: Ejecutar Una Llamada a la Herramienta

Pide un trabajo pequeño y verificable en modo de impresión:

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

La salida JSON lleva la respuesta en response:

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

El registro de conversación de Antigravity muestra cómo llegó allí el agente: leyó el esquema scrape_markdown en caché, luego llamó a scrape_markdown en https://example.com. Las ejecuciones tomaron poco más de dos minutos cada una, y en el único paso cronometrado, la llamada a la herramienta tomó aproximadamente cinco segundos.

Lee el texto response, no status. Una clave incorrecta, un nombre de encabezado incorrecto o una variable no expandida aún producen SUCCESS, y el texto comienza con Failed to fetch data.

Solucionar los Problemas Comunes

Para más sobre el servidor en sí, lee el anuncio del servidor MCP de Scrapeless. La documentación de Browser MCP contiene la referencia de configuración, la página de la API de Scraping cubre los actores detrás de las herramientas y la tarificación lista lo que cuesta una llamada.

Conclusión

Agregar Scrapeless al CLI de Antigravity requiere una entrada en ~/.gemini/config/mcp_config.json: serverUrl configurado en https://api.scrapeless.com/mcp y un encabezado x-api-token que contenga la clave en sí misma. agy mcp add -H lo escribe en una línea, y una ejecución programada necesita una regla de permiso por herramienta.

Dos resultados parecen bien y no lo son. enabled en la lista del servidor no dice nada sobre la clave, y una ejecución con una clave incorrecta o una variable no expandida aún informa éxito. Lee la respuesta de la herramienta y la configuración está probada.

¿Listo para darle al agente de Antigravity una vista en vivo de la web? Comienza con el plan gratuito de Scrapeless y agrega el servidor.

Preguntas Frecuentes

P: ¿Cómo agrego un servidor MCP remoto con un encabezado de clave API al CLI de Antigravity?

Ejecuta agy mcp add -H "x-api-token: YOUR_KEY" scrapeless https://api.scrapeless.com/mcp, o agrega una entrada con serverUrl y un objeto headers a ~/.gemini/config/mcp_config.json. Las banderas deben venir antes del nombre del servidor.
P: ¿Amplía Antigravity CLI las variables de entorno en los encabezados MCP?

No en esta configuración. Un valor de encabezado de ${SCRAPELESS_API_KEY} se envió como texto literal, y la llamada a la herramienta falló con un 401 mientras que la ejecución informó éxito. Coloca la clave en el archivo y restringe los permisos del archivo.

P: ¿Por qué agy niega mi llamada a la herramienta MCP en modo de impresión?

Las herramientas MCP se ejecutan en modo Ask por defecto, y el modo de impresión no puede mostrar un aviso, por lo que la llamada se niega automáticamente y se lista bajo denied_actions. Agrega mcp(server/tool) a permissions.allow en ~/.gemini/antigravity-cli/settings.json.

P: ¿Significa habilitado en agy mcp list que la conexión funciona?

No. Significa que la entrada existe y no está deshabilitada. Una llamada a la herramienta que devuelve contenido de la página es la verificación.

P: ¿Puedo usar Gemini CLI para esto en su lugar?

Gemini CLI ya no sirve cuentas personales de Google, a las que Google ahora dirige a Antigravity. Antigravity CLI lee los servidores MCP de ~/.gemini/config/mcp_config.json.

P: ¿Cuántas herramientas agrega Scrapeless a Antigravity CLI?

25: tres herramientas scrape_*, dieciséis herramientas browser_*, tres herramientas crawl_*, además de google_search, google_trends y ai_scraper.