Claude.ai + Scrapeless: Agregar un Conector MCP Personalizado
Senior Web Scraping Engineer
TL;DR:
- Scrapeless se conecta a claude.ai como un conector personalizado. Agrega
https://api.scrapeless.com/mcpen el cuadro de diálogo Agregar conector personalizado y pasa tu clave API como un encabezado de solicitud. - Cambia la autenticación a Sin inicio de sesión. Claude preselecciona la opción que detecta, y para Scrapeless eso fue Iniciar sesión ahora, un inicio de sesión OAuth que el servidor no ofrece.
- Agrega un encabezado de solicitud:
x-api-token, con la clave en bruto como valor. Claude envía el valor exactamente como lo escribas, por lo que nada va delante de la clave. - Los encabezados de solicitud son una beta. Anthropic los ofrece a un conjunto limitado de organizaciones, y en los planes Team y Enterprise un Propietario agrega el conector.
- Un conector que enumera 25 herramientas aún no ha demostrado la clave. Scrapeless enumera sus herramientas para cualquier valor de clave, así que confirma con una llamada a una herramienta en un chat.
- Obtén una clave en el plan gratuito de Scrapeless y conéctala en unos minutos.
Claude en la web tiene su propia búsqueda web. El servidor MCP de Scrapeless añade un tipo diferente de acceso: páginas renderizadas en un navegador real y devueltas como Markdown, un navegador en la nube que Claude puede controlar clic a clic, rastreos en segundo plano y datos de resultados de Google. Una vez conectado, Claude llama a esas herramientas en medio de una conversación.
Esta guía añade el servidor alojado a través del cuadro de diálogo Agregar conector personalizado de claude.ai. El cuadro de diálogo es un solo formulario, y dos de sus configuraciones necesitan atención para Scrapeless: la opción de inicio de sesión que Claude detecta, y el encabezado que lleva la clave.
Cómo un Conector Personalizado Llega a Scrapeless
Un conector personalizado es un servidor MCP remoto que Claude llama desde la nube de Anthropic en lugar de desde tu computadora. La guía de Anthropic para conectores personalizados dice que esto se aplica a cada cliente de Claude, incluido claude.ai, por lo que el servidor debe ser accesible a través de internet público. Scrapeless se ejecuta en un punto final HTTPS público, por lo que no hay nada que alojar y nada que permitir.
La autenticación decide el resto de la configuración. Muchos conectores inician sesión a cada persona a través de OAuth. Scrapeless no tiene flujo OAuth y lee una clave API del encabezado x-api-token en cada solicitud. La documentación de Claude para conectores MCP remotos cubre ese caso con encabezados de solicitud: una credencial fija ingresada una vez cuando se agrega el conector y enviada en cada solicitud.
Qué Añade Scrapeless a Claude
El servidor expone 25 herramientas, agrupadas por trabajo:
scrape_markdown,scrape_htmlyscrape_screenshotdevuelven una página renderizada como Markdown, HTML en bruto o una imagen en una sola llamada.- Dieciséis herramientas
browser_*, desdebrowser_createybrowser_gotohastabrowser_click,browser_typeybrowser_snapshot, conducen una sesión de navegador en la nube paso a paso. crawl_start,crawl_resultycrawl_cancelejecutan un rastreo en segundo plano y lo recopilan más tarde.google_searchygoogle_trendsdevuelven resultados de búsqueda y datos de tendencias, yai_scrapercaptura respuestas de asistentes de IA como ChatGPT, Gemini y Perplexity.
En la configuración del conector, Claude las enumera bajo nombres legibles como "Raspador de IA" y "Clic en el Navegador", cada uno con su propio permiso.
Requisitos Previos
- Un plan de Claude con conectores personalizados. Anthropic enumera Gratuito, Pro, Máximo, Equipo y Empresarial, y limita el plan Gratuito a un conector personalizado.
- La sección Encabezados de solicitud en el cuadro de diálogo Agregar conector personalizado. La autenticación de encabezados de solicitud está en beta para un conjunto limitado de organizaciones; si falta la sección, tu organización aún no tiene acceso.
- En los planes de Equipo y Empresarial, un Propietario o Propietario Principal para agregar el conector.
- Una clave API de Scrapeless del panel de control de Scrapeless.
Paso 1: Abrir Agregar Conector Personalizado
Dónde se abre el cuadro de diálogo depende del plan:
| Plan | Dónde agregar el conector |
|---|---|
| Gratuito, Pro, Máximo | Personalizar > Conectores, luego + > Agregar conector personalizado |
| Equipo, Empresarial | Un Propietario abre Configuraciones de la organización > Conectores, hace clic en Agregar, pasa el ratón sobre Personalizado y selecciona Web |
Completa el primer paso:
| Campo | Valor |
|---|---|
| Nombre | Scrapeless |
| URL del servidor MCP | https://api.scrapeless.com/mcp |
Mantén la clave fuera de la URL. Scrapeless la lee solo del encabezado x-api-token, y la guía de autenticación de Anthropic para conectores aconseja no usar credenciales en las URL de los conectores, porque las URL se registran en los registros del servidor, proxies e historial de navegación.
¿Configurando esto ahora? El plan gratuito de Scrapeless cubre la conexión y tus primeras llamadas de herramienta.
Paso 2: Cambia la Opción Detectada a No Iniciar Sesión
Después de que continúes, Claude verifica la URL y preselecciona la autenticación que detecta, marcada como Detectada. Para https://api.scrapeless.com/mcp, la opción detectada fue Iniciar sesión ahora. Elige No iniciar sesión en su lugar.
Las dos opciones de inicio de sesión ejecutan un flujo de OAuth, y Scrapeless no ofrece una. Su respuesta 401 no lleva encabezado WWW-Authenticate, y sus rutas de descubrimiento de OAuth devuelven 404. No iniciar sesión es la opción que la documentación de Anthropic nombra para servidores que usan una clave API, emparejada con la clave bajo Encabezados de solicitud. Una vez que se selecciona, los campos del cliente OAuth desaparecen del diálogo.
Paso 3: Agrega el Encabezado x-api-token
Abre Encabezados de solicitud y agrega una fila:
| Configuración | Valor |
|---|---|
| Nombre del encabezado | x-api-token |
| Valor | Tu clave API de Scrapeless, sin nada delante |
| Requerido | Activado |
Luego haz clic en Agregar.
Elige el nombre de la lista, o selecciona Encabezado personalizado y escríbelo. Anthropic aprueba cada nombre de encabezado personalizado antes de que Claude lo envíe a un servidor externo, y el diálogo rechaza un nombre que no sea aprobado. x-api-token se guardó sin un error cuando se probó esta configuración.
El valor no necesita un prefijo. Claude lo envía exactamente como se ingresó y no agrega ningún esquema de autenticación, que es lo que Scrapeless espera: el servidor lee todo el valor del encabezado como la clave. Un valor como Bearer <key> o token <key> aún pasa por el apretón de manos y la lista de herramientas, luego falla en cada llamada de herramienta.
Requerido hace que un valor faltante falle la conexión en lugar de enviar solicitudes sin el encabezado. Claude almacena el valor de forma segura y no lo vuelve a mostrar. Las configuraciones de autenticación no se pueden editar más tarde, por lo que una clave o nombre de encabezado incorrectos significa eliminar el conector y agregarlo nuevamente.
Paso 4: Verifica las Herramientas y Sus Permisos
Abre Personalizar > Conectores y selecciona Scrapeless. La página del conector lista todas las 25 herramientas bajo Permisos de herramientas, y cada herramienta puede configurarse como Siempre permitir, Necesita aprobación o Bloqueado. En las pruebas, cada herramienta de Scrapeless comenzó como Necesita aprobación, por lo que Claude pregunta antes de cada llamada.
Bloquea lo que un trabajo no necesita. Un chat que solo lee páginas puede mantener scrape_markdown y google_search disponibles y bloquear las herramientas browser_*, que inician una sesión de navegador en vivo. El artículo de Anthropic sobre el uso de conectores describe los mismos tres niveles de permiso para cada conector.
Paso 5: Realiza Una Llamada de Herramienta en un Chat
Los conectores se activan por conversación. En un nuevo chat, haz clic en +, abre Conectores y activa Scrapeless. Luego pide un trabajo pequeño y verificable:
text
Use the Scrapeless scrape_markdown tool to fetch https://example.comPermite la llamada si Claude pide aprobación. Claude muestra un paso de Raspar markdown para https://example.com, luego devuelve la página como Markdown, comenzando con:
text
# Example Domain
This domain is for use in documentation examples without needing permission. Avoid use in operations.Esta llamada es la prueba que cuenta. Scrapeless responde al apretón de manos MCP y lista sus 25 herramientas para cualquier valor de clave, por lo que un conector conectado con una lista completa de herramientas muestra solo que el encabezado llegó. Con una clave incorrecta, el resultado de la herramienta comienza con Failed to fetch data.
Soluciona los Problemas Comunes
| Lo que ves | Causa | Solución |
|---|---|---|
| No hay sección de Encabezados de solicitud en el diálogo | La beta de encabezados de solicitud no está habilitada para tu organización | Consulta con un propietario de Equipo o Empresa, o con el soporte de Claude |
| La conexión inicia un inicio de sesión que falla | Iniciar sesión ahora o Iniciar sesión cuando sea necesario permanecieron seleccionados | Elimina el conector y agrégalo nuevamente con No iniciar sesión |
| El guardado es rechazado debido al nombre del encabezado | El nombre escrito no es un nombre de encabezado aprobado | Verifica la ortografía x-api-token, o solicita al soporte de Claude que lo apruebe |
| El conector no logra conectarse | La clave se puso bajo otro nombre de encabezado, como authorization, o un valor Requerido está vacío |
Agrega el conector nuevamente con x-api-token y la clave |
Los resultados de la herramienta comienzan con Failed to fetch data |
La clave es incorrecta o ha sido revocada, o tiene un prefijo | Agrega el conector nuevamente con la clave válida y limpia |
| Los miembros no pueden encontrar el conector | En planes de Equipo y Empresa, solo los Propietarios añaden conectores personalizados | Un Propietario lo agrega; los miembros se conectan desde Personalizar > Conectores |
Una Clave para Toda la Organización
Un encabezado de solicitud es una credencial almacenada en el conector. La documentación de Claude describe los encabezados de solicitud como adecuados para servicios donde todos en una organización comparten una credencial, y en los planes de Equipo y Empresa el Propietario lo ingresa una vez para cada miembro. Todas las llamadas de Scrapeless de los miembros se ejecutan entonces con esa única clave y su plan.
Usa una clave creada exclusivamente para Claude, de modo que se pueda rotar sin afectar otras integraciones. Rotarla significa quitar el conector y volver a agregarlo con la nueva clave, y los miembros se reconectan después. Establece los permisos de la herramienta teniendo en cuenta a todo el equipo.
Para obtener más información sobre lo que expone el servidor, lee el anuncio del servidor Scrapeless MCP. La documentación de Browser MCP contiene la referencia de configuración, la página de la API de Scraping cubre a los actores detrás de las herramientas, y los precios enumeran cuánto cuesta una llamada.
Conclusión
Scrapeless entra en claude.ai como un conector personalizado con tres configuraciones que importan: la URL https://api.scrapeless.com/mcp, Sin inicio de sesión en lugar de la opción de inicio de sesión detectada, y un encabezado de solicitud x-api-token que contiene la clave básica. Activa el conector en un chat, y Claude puede llamar a todas las 25 herramientas.
Lee la lista de herramientas como una señal de que el encabezado llegó, no de que la clave funciona. Una llamada scrape_markdown que devuelve una página real asegura la clave, y los permisos de la herramienta deciden cuánto puede hacer Claude sin preguntar.
¿Listo para darle a Claude un navegador en la nube y contenido de página limpio? Comienza con el plan gratuito de Scrapeless y añade el conector.
FAQ
Q: ¿Puedo añadir un conector personalizado con una clave API en claude.ai?
Sí, donde la beta de encabezados de solicitud está disponible. Elige Sin inicio de sesión en el cuadro de diálogo Agregar conector personalizado y agrega la clave bajo Encabezados de solicitud. Claude almacena el valor y lo envía en cada solicitud al servidor.
Q: ¿Qué opción de autenticación debo elegir para Scrapeless en claude.ai?
Sin inicio de sesión. Claude puede marcar Iniciar sesión ahora como Detectado, pero Scrapeless no tiene inicio de sesión OAuth y se autentica con el encabezado x-api-token en su lugar.
Q: ¿Qué encabezado necesita Scrapeless en Claude?
x-api-token, con la clave API como todo el valor. Claude no añade ningún prefijo, así que ingresa solo la clave.
Q: ¿Por qué no veo los encabezados de solicitud en el cuadro de diálogo Agregar conector personalizado?
La autenticación de encabezados de solicitud está en beta y disponible para un conjunto limitado de organizaciones. Sin esa sección, un servidor de clave API como Scrapeless no puede ser añadido a través del cuadro de diálogo aún.
Q: ¿Puedo cambiar la clave de Scrapeless después de añadir el conector?
No en su lugar. La configuración de autenticación, incluidos los encabezados de solicitud, no se puede cambiar después de que un conector es añadido. Elimina el conector y agrégalo nuevamente con la nueva clave; los miembros se reconectan después.
Q: ¿Por qué el conector muestra 25 herramientas cuando mi clave es incorrecta?
Scrapeless lista sus herramientas para cualquier valor de clave. La clave se verifica cuando se ejecuta una herramienta, y una clave incorrecta devuelve texto que comienza con Failed to fetch data.
Q: ¿Puedo poner la clave API de Scrapeless en la URL del conector?
No. Scrapeless acepta la clave solo en el encabezado x-api-token, y Anthropic desaconseja las credenciales en las URL de los conectores.
Q: ¿Cuántas herramientas añade Scrapeless a Claude?
25: tres herramientas scrape_*, dieciséis herramientas browser_*, tres herramientas crawl_*, además de google_search, google_trends y ai_scraper.
En Scrapeless, solo accedemos a datos disponibles públicamente y cumplimos estrictamente con las leyes, regulaciones y políticas de privacidad del sitio web aplicables. El contenido de este blog es sólo para fines de demostración y no implica ninguna actividad ilegal o infractora. No ofrecemos garantías y renunciamos a toda responsabilidad por el uso de la información de este blog o enlaces de terceros. Antes de realizar cualquier actividad de scraping, consulte a su asesor legal y revise los términos de servicio del sitio web de destino u obtenga los permisos necesarios.
