Grok Bot y Scrapeless: Agregar un conector MCP personalizado

TL;DR:

• Scrapeless no está en el catálogo de complementos de Grok Bot, por lo que se presenta como un conector personalizado. Una búsqueda en el Marketplace no devuelve nada; un Bot registra un servidor MCP remoto personalizado cuando se le solicita.
• Un mensaje en inglés hace la configuración. Nombra el servidor, proporciona la URL https://api.scrapeless.com/mcp y dile al Bot que se autentique con un encabezado x-api-token.
• Grok Bot muestra una tarjeta de aprobación antes de que se guarde cualquier cosa. Verifica el nombre, el tipo HTTPS remoto, la URL del servidor y el encabezado, y luego guarda.
• El nombre del encabezado es x-api-token. Se rechaza un encabezado Bearer con 401 Unauthorized: Missing x-api-token header.
• Demuestra con una llamada a la herramienta, no con la insignia de estado. Scrapeless responde al apretón de manos para cualquier valor de clave, y los conectores de clave de API pueden mostrar una insignia cosmética de "Necesita autenticación" mientras funcionan.
• Obtén una clave en el plan gratuito de Scrapeless y conéctala en pocos minutos.

Grok Bot le da a cada Bot su propia computadora en la nube, un navegador y un conjunto de conectores. Lo que le falta es una manera directa de convertir una página renderizada en Markdown limpio, ejecutar un rastreo en segundo plano o extraer resultados de Google a través de una llamada a la herramienta. El servidor MCP de Scrapeless agrega esas como herramientas que cada Bot en tu cuenta puede llamar.

La conexión es un servidor MCP remoto personalizado, y en Grok Bot creas uno pidiéndole a un Bot en lugar de llenar una página de configuración. Esta guía cubre el mensaje que se debe enviar, qué verificar en la tarjeta de aprobación y cómo diferenciar un conector que funciona de uno que solo parece estar conectado.

Por qué Scrapeless no está en el Marketplace de Complementos

Grok Bot muestra conectores como complementos, y ese catálogo es de Cursor. la guía de Grok Bot de xAI para equipos dice que no hay una lista de conectores de Grok Bot por separado: los conectores aparecen como complementos en la aplicación, y Grok Bot hereda la política de conectores de Cursor del equipo. Scrapeless no está publicado en ese catálogo, por lo que buscarlo en el Marketplace devuelve resultados vacíos.

Cualquier cosa fuera del catálogo se agrega como un conector personalizado, y un Bot lo hace por ti. Le das la URL HTTPS del servidor remoto y los encabezados que necesita; registra el servidor con su herramienta Agregar MCP después de que confirmes. Un conector personalizado es de toda la cuenta, por lo que una vez que un Bot agrega Scrapeless, los otros Bots en la misma cuenta también pueden usarlo.

Lo que Scrapeless agrega a tus Bots

El servidor expone 25 herramientas, agrupadas por trabajo:

• scrape_markdown, scrape_html y scrape_screenshot devuelven una página renderizada como Markdown, HTML en bruto o una imagen en una sola llamada.
• Dieciséis herramientas browser_*, de browser_create y browser_goto a browser_click, browser_type y browser_snapshot, manejan 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 recogen 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.

Un Bot ya tiene su propio navegador. La diferencia es la salida: estas herramientas devuelven contenido de página que el modelo puede leer directamente, en lugar de una sesión que tiene que explorar.

Requisitos previos

• Grok Bot en un plan elegible. xAI enumera SuperGrok Plus, SuperGrok Heavy, Cursor Pro+, Cursor Ultra y Cursor Teams Standard o Premium. Esta guía utilizó la aplicación de escritorio de Grok Bot, versión 0.47.0, en Windows.
• Una clave API de Scrapeless del panel de control de Scrapeless.
• En un equipo de Cursor, una política de conectores que permita el servidor. Cuando la política bloquea uno, los miembros ven el complemento como Deshabilitado por el administrador del equipo.

Paso 1: Pregunta a un Bot que Agregue Scrapeless

Abre cualquier Bot y envía este mensaje, con tu clave en lugar del marcador de posición:

Add a custom remote MCP server.
Name: scrapeless
URL: https://api.scrapeless.com/mcp
Authentication: HTTP header "x-api-token" with the value YOUR_SCRAPELESS_API_KEY
Do not use an Authorization or Bearer header.

La última línea hace trabajo real. La mayoría de los conectores se autentican con OAuth o un token Bearer, y un Bot que asume Bearer construye un encabezado que Scrapeless rechaza. El punto final responde a tal solicitud con 401 Unauthorized: Missing x-api-token header.

Sabe dónde termina la clave cuando forma parte del mensaje. Se queda en la conversación de ese Bot, y compartir un Bot con tu equipo muestra a los compañeros de equipo su historial completo, incluidas las conversaciones pasadas. La página de ayuda de Grok Bot sobre secretos recomienda mantener las claves API fuera del chat. Para un Bot compartido, envía el mismo mensaje sin el valor y escribe la clave en la tarjeta de aprobación en el Paso 2 en su lugar; así es como se ingresó la clave cuando se probó esta configuración.

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

Paso 2: Verifica la Tarjeta de Aprobación y Guarda

Antes de que el Bot registre cualquier cosa, Grok Bot muestra una tarjeta de Agregar servidor MCP. Compara cada campo con lo que pediste:

Deja ID de cliente OAuth y Secreto del cliente vacíos, porque Scrapeless no utiliza OAuth. Si el valor del encabezado está en blanco, escribe la clave allí, luego elige Guardar. La tarjeta también ofrece Editar JSON, que contiene el mismo servidor como un objeto JSON claveado por su nombre, un servidor a la vez.

La clave guardada permanece con el conector. La documentación de xAI dice que los tokens OAuth permanecen en el backend del conector de Cursor y los Bots invocan herramientas sin recibirlos. La documentación de Cursor para sus agentes alojados añade que los valores de encabezado en los servidores MCP HTTP están cifrados en reposo, redactados después de guardar y nunca colocados en la máquina del agente; las llamadas a herramientas pasan por el backend de Cursor.

Paso 3: Realiza una llamada a una herramienta

Pide al Bot un trabajo pequeño y verificable:

Use the scrapeless MCP server's scrape_markdown tool to fetch https://example.com
and reply with the first heading of the returned page, quoted exactly.

Un conector funcional regresa con el encabezado de la página:

"# Example Domain"

Una llamada a la herramienta es la prueba que cuenta, porque el estado del conector no puede distinguir una buena clave de una mala. Scrapeless responde al apretón de manos MCP y enumera sus 25 herramientas para cualquier valor de clave. La diferencia solo se muestra cuando se ejecuta una herramienta: con una clave incorrecta, el texto del resultado comienza con Failed to fetch data.

La insignia de estado puede engañar en la otra dirección también. La insignia del plugin de Grok Bot cuenta solo un inicio de sesión OAuth como autenticado, por lo que un conector que usa una clave API puede mostrar Necesita autenticación mientras sus herramientas funcionan. El personal de Cursor confirmó que la insignia Necesita autenticación es cosmética para conectores como este. Presionar Autenticar no lo cambia; la llamada a la herramienta anterior es la verificación.

Soluciona los problemas comunes

La última fila vale la pena saberla antes de que suceda. Grok Bot descubre todos los conectores de una cuenta bajo un presupuesto de tiempo compartido, por lo que un solo servidor que nunca responde su apretón de manos puede hacer que cada conector regrese vacío. Scrapeless respondió su apretón de manos en menos de medio segundo durante las pruebas, por lo que no es el conector que se queda en silencio.

Comparte Scrapeless a través de un equipo de Cursor

Pedir a un Bot agrega el conector para una cuenta. Un equipo que desea el mismo conector para cada miembro puede publicarlo como un plugin en un mercado de equipos de Cursor, que los planes de Teams y Enterprise admiten. Los miembros luego lo encuentran en el catálogo de Plugins bajo plugins de equipo, y nadie copia una clave en un chat.

El mcp.json del plugin sostiene solo un marcador de posición:

{
  "mcpServers": {
    "scrapeless": {
      "url": "https://api.scrapeless.com/mcp",
      "headers": {
        "x-api-token": "${SCRAPELESS_API_KEY}"
      }
    }
  }
}

Su .cursor-plugin/plugin.json declara ese marcador de posición como una variable, por lo que un administrador del equipo establece la clave real en el tablero de Cursor bajo Plugins → Configurar:

{
  "name": "scrapeless",
  "variables": {
    "type": "object",
    "properties": {
      "SCRAPELESS_API_KEY": {
        "type": "string",
        "title": "Scrapeless API key",
        "description": "Sent as the x-api-token header to https://api.scrapeless.com/mcp."
      }
    },
    "required": ["SCRAPELESS_API_KEY"]
  }
}

Un plan de Teams permite un mercado de equipo, por lo que un equipo que ya importó uno agrega el plugin de Scrapeless a ese repositorio en lugar de crear un segundo.
Para obtener más información sobre lo que expone el servidor, lee el anuncio del servidor Scrapeless MCP. La guía de configuración de Cursor cubre el mismo servidor en el editor de Cursor, la documentación de Browser MCP contiene la referencia de configuración, la página de API de Scraping cubre los actores detrás de las herramientas, y la tarifa enumera cuánto cuesta una llamada.

Conclusión

Agregar Scrapeless a Grok Bot requiere un mensaje y una aprobación. El Bot registra https://api.scrapeless.com/mcp como un servidor MCP remoto personalizado, la tarjeta de aprobación confirma el nombre, tipo, URL y encabezado x-api-token, y cada Bot en la cuenta puede luego llamar a las 25 herramientas.

Dos verificaciones mantienen la configuración honesta. Lee el resultado de una llamada a herramienta real en lugar de la insignia de estado, ya que una clave incorrecta y un conector de clave API funcional pueden parecer incompletos. Y decide dónde debería residir la clave antes de enviar el mensaje: en el chat para un Bot privado, o en la tarjeta de aprobación cuando los compañeros de equipo pueden leer la conversación.

¿Listo para darle a tus Bots una vista en vivo de la web? Comienza con el plan gratuito de Scrapeless y envía el mensaje del Paso 1.

FAQ

Q: ¿Puedo agregar un servidor MCP personalizado a Grok Bot?

Sí. Pide a un Bot que agregue un servidor MCP remoto personalizado y dale la URL HTTPS del servidor y cualquier encabezado que necesite. Grok Bot muestra una tarjeta de aprobación de Agregar Servidor MCP con el nombre, tipo, URL y encabezados, y guarda el conector cuando confirmas.

Q: ¿Por qué no aparece Scrapeless cuando busco en los Plugins de Grok Bot?

El catálogo de Plugins lista plugins publicados, y Scrapeless no es uno de ellos. Se conecta como un conector personalizado en su lugar, que no aparece en la búsqueda del Marketplace.

Q: ¿Qué encabezado necesita Scrapeless en Grok Bot?

x-api-token, con tu clave API de Scrapeless como valor. Un encabezado Authorization: Bearer es rechazado con 401 Unauthorized: Missing x-api-token header.

Q: ¿Por qué mi conector Scrapeless dice Necesita autenticación?

La insignia de Grok Bot cuenta solo las sesiones iniciadas con OAuth como autenticadas, y Scrapeless utiliza una clave API. El personal de Cursor describe la insignia como cosmética para conectores como este. Ejecuta una llamada a la herramienta para confirmar que el conector funciona.

Q: ¿Debería poner mi clave API en el mensaje del chat?

Funciona, pero la clave permanece en la conversación del Bot, y los compañeros de equipo ven ese historial en un Bot compartido. Para Bots compartidos, deja el valor fuera del mensaje y escribe la clave en la tarjeta de aprobación.

Q: ¿Todos mis Bots obtienen las herramientas de Scrapeless?

Sí. Los servidores MCP personalizados son de toda la cuenta, así que un conector que agrega un Bot está disponible para los otros Bots en la misma cuenta.

Q: ¿Cuántas herramientas agrega Scrapeless a Grok Bot?

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