Cómo conectar el Captor MCP a los Agentes del Navegador rtrvr

TL;DR

• rtrvr puede llamar a una herramienta externa de CAPTCHA a través de MCP. Su sistema de herramientas acepta servidores HTTP o SSE transmisibles y expone las herramientas importadas con nombres calificados.
• Use la herramienta modo token para trabajos de navegador vinculados a sesión. Devuelve un token sin abrir un segundo navegador, dejando a rtrvr responsable de la pestaña original y del paso de envío específico de la aplicación.
• No confunda dos herramientas llamadas solve_captcha. rtrvr documenta una acción de navegador integrada con ese nombre, mientras que el servidor MCP externo importa una herramienta calificada separada como capsolver.solve_captcha.
• Un token devuelto no es prueba de que la tarea del navegador tuvo éxito. Verifique la misma pestaña, la respuesta de la aplicación deseada, los límites de reintentos y el estado final del flujo de trabajo.

Introducción: Conectar una herramienta de desafío tipado a rtrvr

rtrvr combina una extensión de Chrome, navegadores en la nube, una API, MCP, una CLI y un SDK para trabajos de navegador impulsados por agentes. Su capa de llamada a herramientas también puede conectar servidores MCP externos e invocar sus herramientas desde chats o subrutinas JavaScript reutilizables. CapSolver se adapta a esta arquitectura como un servicio de manejo de desafíos separado para sitios web y entornos de prueba que posee o está autorizado a automatizar.

Este guía muestra la integración estrecha que los dos interfaces documentados realmente soportan. rtrvr mantiene el control de la pestaña de navegador activa. CapSolver MCP suministra una herramienta modo token tipada. Una pequeña subrutina de rtrvr valida la solicitud, llama a la herramienta MCP calificada y devuelve un resultado estructurado al flujo de trabajo. La actualización final de la página sigue siendo un paso específico de la aplicación porque un token de CAPTCHA está vinculado al contexto del desafío y no es un resultado genérico de clic.

El guía no asume una colaboración oficial nativa entre los productos. Tampoco afirma que el servidor MCP de CapSolver pueda adjuntarse al objeto de navegador interno de rtrvr. En cambio, utiliza el contrato de herramienta externa publicado por rtrvr y el esquema de herramienta MCP publicado por CapSolver.

Lo que soporta la integración de rtrvr y CapSolver

La documentación de Llamada a herramientas de rtrvr dice que los usuarios pueden conectar un servidor MCP por URL, habilitar herramientas importadas, llamarlas directamente con @toolname y componerlas dentro de una herramienta personalizada con rtrvr.callTool(name, params). Las herramientas MCP importadas se guardan con un prefijo de servidor, lo cual es importante cuando dos sistemas publican el mismo nombre de herramienta.

La documentación de Servicio MCP de CapSolver expone cinco herramientas:

Para una pestaña de rtrvr iniciada sesión, solve_captcha es el punto de partida práctico. Las herramientas de CapSolver MCP basadas en navegador inician su propia sesión Playwright. No reciben la pestaña actual, cookies, almacenamiento local o estado en página de rtrvr. Eso hace que solve_on_page sea útil para una verificación independiente y autorizada de página, pero no para una continuación transparente de una sesión de rtrvr existente.

También hay que manejar una colisión de nombres deliberadamente. rtrvr documenta solve_captcha como una de sus herramientas pageAction integradas. CapSolver MCP publica una herramienta con el mismo nombre corto. Después de conectar el servidor externo, inspeccione la lista de herramientas y llame a su nombre completo importado, normalmente capsolver.solve_captcha. No deje que un planificador adivine cuál pretendía.

Arquitectura y límites de responsabilidad

Mantenga la integración en cuatro capas:

Esta separación previene tres errores comunes. Primero, el modelo no inventa campos de tarea. Segundo, una respuesta de token no se registra como una acción de negocio completada. Tercero, un rechazo de acceso, muro de inicio de sesión, solicitud de MFA o desafío no compatible no se envía repetidamente al solucionador.

Use este patrón solo en sistemas que posea o tenga permiso para probar o automatizar. Mantenga los flujos sensibles como pagos, verificación de identidad, creación de cuenta, acceso a datos privados y otros detrás de aprobación humana explícita y las reglas de servicio aplicables.

Paso 1: Iniciar CapSolver MCP sobre HTTP transmisible

rtrvr se conecta a servidores MCP externos por URL, mientras que CapSolver MCP predeterminadamente usa stdio. Inicie el mismo servidor con HTTP transmisible para que la extensión rtrvr lo alcance.

python -m venv .venv
source .venv/bin/activate
pip install capsolver-core
pip install capsolver-mcp

export CAPSOLVER_API_KEY="SU_CLAVE_API_DE_CAPSOLVER"
capsolver-mcp --transport streamable-http --host 127.0.0.1 --port 8000

El SDK Python oficial de MCP usa /mcp como ruta predeterminada de HTTP transmisible, por lo tanto el punto final local es:

http://127.0.0.1:8000/mcp

Vincular a 127.0.0.1 mantiene el servicio local. La opción --api-key o la variable de entorno CAPSOLVER_API_KEY autentica el servidor a CapSolver; no es una capa de autenticación de cliente para quien pueda alcanzar el puerto MCP. No vincule este comando directamente a una interfaz pública. Si un entorno rtrvr remoto debe alcanzarlo, despléguelo detrás de HTTPS autenticado, restrinja la red permitida, proteja la clave API en un almacén de secretos y revise los ajustes de origen y transporte del servidor MCP.

Las herramientas modo token no requieren Playwright. Instale el extra del navegador solo cuando tenga un uso autorizado separado para detect_captchas o solve_on_page:

pip install "capsolver-mcp[browser]"
playwright install chromium

Paso 2: Conectar y verificar el servidor MCP en rtrvr

Abra la sección Herramientas de rtrvr, agregue la URL local del MCP y habilite solo las herramientas que necesita el flujo de trabajo. rtrvr documenta soporte para servidores MCP de HTTP transmisible, SSE y protegidos por OAuth. Para esta configuración local, use la URL de HTTP transmisible del paso anterior.

Comience con dos llamadas no basadas en navegador:

@capsolver.get_supported_captchas
@capsolver.get_balance

El prefijo exacto se asigna por rtrvr cuando el servidor se conecta. Si difiere, use el nombre mostrado en el panel de Herramientas. Una subrutina personalizada también puede llamar a await rtrvr.listTools() e inspeccionar cada nombre de herramienta disponible, descripción, esquema de parámetros y origen.

Estas verificaciones responden preguntas diferentes. get_supported_captchas demuestra que rtrvr descubrió la herramienta externa. get_balance demuestra que el proceso MCP recibió una credencial de cuenta funcional. Ninguna verificación demuestra que un desafío real pueda completarse, pero ambas separan fallas de configuración de fallas de tarea antes de que gaste tiempo depurando un flujo de navegador.

No coloque una clave de API real en un prompt de rtrvr, grabación de página, captura de pantalla o repositorio. Manténgala en el entorno del proceso MCP. Si el proceso registra argumentos de herramienta, redacte tokens, claves, URLs que contengan parámetros de consulta sensibles y cualquier identificador específico de destino antes de retener los registros.

Redime tu código promocional de CapSolver

Aumenta tu presupuesto de automatización instantáneamente!
Usa el código promocional CAP26 al recargar tu cuenta de CapSolver para obtener un 5% adicional en cada recarga — sin límites.
Redímelo ahora en tu Panel de CapSolver

Paso 3: Agregar una subrutina determinista de rtrvr

Las herramientas JavaScript personalizadas de rtrvr pueden llamar a herramientas MCP conectadas a través de rtrvr.callTool. La siguiente subrutina hace cuatro cosas antes de devolver un token: valida la URL, permite los tipos de desafío compatibles, descubre la herramienta externa calificada y normaliza los estados de falla.

const allowedTypes = new Set(["reCaptchaV2", "reCaptchaV3", "cloudflare"]);

function fail(state, message, details = {}) {
  return { ok: false, state, message, ...details };
}

if (!allowedTypes.has(captchaType)) {
  return fail("unsupported_challenge", `Tipo no soportado: ${captchaType}`);
}

const parsed = new URL(websiteUrl);
if (parsed.protocol !== "https:") {
  return fail("policy_block", "Solo se permiten objetivos HTTPS aprobados");
}

const tools = await rtrvr.listTools();
const solver = tools.find((tool) =>
  tool.source === "mcp" &&
  (tool.name === "capsolver.solve_captcha" || tool.name.endsWith(".solve_captcha"))
);

if (!solver) {
  return fail("configuration_error", "CapSolver MCP solve_captcha no se encontró");
}

const result = await rtrvr.callTool(solver.name, {
  captcha_type: captchaType,
  website_url: websiteUrl,
  website_key: websiteKey,
  version: version || null,
  page_action: pageAction || null,
  min_score: minScore || null,
  invisible: invisible ?? null,
  enterprise: enterprise ?? null,
  cdata: cdata || null,
  timeout: 90,
  polling_interval: 5,
});

if (!result?.success || !result?.solution?.token) {
  return fail("solve_failed", result?.error || "No se devolvió un token", {
    errorCode: result?.error_code || null,
    httpStatus: result?.http_status || null,
  });
}

return {
  ok: true,
  state: "token_ready",
  captchaType: result.solution.captcha_type,
  token: result.solution.token,
  expiresAt: result.solution.expire_time || null,
};

Defina captchaType, websiteUrl, websiteKey y los campos opcionales como parámetros de herramienta en rtrvr. El ejemplo intencionalmente no extrae una clave de sitio de páginas arbitrarias ni inyecta un token en una aplicación desconocida. Para una aplicación de prueba que controle, agregue un adaptador separado que lea los parámetros exactos del desafío desde su contrato de aplicación y envíe el resultado a través de la forma o punto final del servidor compatible.

La prueba local incluida cubre la lógica de ramificación de orquestación con un entorno de herramienta rtrvr simulado. Un handshake en vivo aún requiere una cuenta de rtrvr, un dispositivo de navegador activo o contexto en la nube, una clave API de CapSolver y una página de prueba autorizada.

Paso 4: Mantener el token vinculado al estado original del navegador

Las soluciones de CAPTCHA son sensibles al contexto. El tipo de desafío, clave de sitio pública, URL de página, nombre de acción, estado de sesión y a veces datos de proxy o agente de usuario pueden afectar si la aplicación de destino acepta un resultado. Por lo tanto, el flujo de trabajo del navegador debe preservar la pestaña original y enviar el token devuelto de la manera esperada por la aplicación.

Use un estado de flujo tipado en lugar de un bucle de reintentos genérico:

1. page_ready: la página deseada cargó y su identidad se verificó.
2. challenge_detected: un desafío compatible está presente y los parámetros provienen de evidencia de página confiable.
3. solve_requested: se creó una llamada MCP acotada para esa instancia de desafío.
4. token_ready: el servicio devolvió un token, pero aún no se afirma un éxito de aplicación.
5. submitted: el adaptador específico de la aplicación envió el token en la misma sesión autorizada.
6. accepted: la ruta, respuesta de API o estado de página deseado confirman el éxito.
7. review o stopped: el estado es ambiguo, no compatible, sensible o excedió el presupuesto.

No llame a solve_on_page como atajo para este flujo vinculado a sesión. La implementación actual de CapSolver MCP abre una página Chromium headless separada para esa herramienta, realiza la detección y llenado allí, y cierra el navegador después. Eso es una operación válida independiente, pero es una sesión diferente de la extensión o navegador en la nube de rtrvr. Úselo solo cuando una sesión separada sea aceptable y esté explícitamente autorizada.

Paso 5: Verificar el resultado de la aplicación

Una respuesta exitosa de MCP significa que la herramienta devolvió un objeto de solución. No significa que un inicio de sesión, envío de formulario, trabajo de extracción o tarea de navegador se completara. La verificación debe ocurrir en rtrvr en la pestaña original.

Use al menos tres verificaciones:

• Continuidad de pestaña: el ID de pestaña, host y paso de flujo deseado aún coinciden con la solicitud que produjo el desafío.
• Aceptación de la aplicación: una ruta documentada, estado del DOM o respuesta del servidor confirma que la aplicación aceptó el resultado.
• Resultado comercial: la tarea autorizada deseada se completó sin cambiar silenciosamente páginas, cuentas o registros.

Si la página muestra el mismo desafío nuevamente, deténgase después del presupuesto de intentos configurado. Los bucles repetidos de desafío pueden indicar un token caducado, parámetros incompatibles, inconsistencia de proxy o agente de usuario, variación de desafío no compatible o una decisión de política de acceso más amplia. Más llamadas no prueban progreso.

Registre estados y códigos de error, no secretos. Un evento útil contiene un ID de correlación, marca de tiempo, nombre de herramienta, tipo de desafío, host objetivo, número de intento, transición de estado, latencia y resultado final de la aplicación. No retenga el token de solución o clave API en registros ordinarios.

Solución de problemas de la integración MCP de rtrvr

Lista de verificación de producción

Antes de pasar de una página de prueba, confirme todos los siguientes puntos:

• el objetivo y el flujo de trabajo del navegador están autorizados;
• se selecciona la herramienta CapSolver por su nombre MCP calificado;
• los parámetros de desafío provienen de evidencia de tiempo de ejecución confiable, no de suposiciones del modelo;
• las claves de API permanecen en un entorno o almacén de secretos;
• el punto final del MCP está en localhost o protegido por HTTPS autenticado y controles de red;
• el manejo de tokens se separa de la presentación específica de la aplicación;
• los reintentos están limitados por instancia de desafío y por flujo de trabajo;
• los registros omiten claves de API, tokens de solución, URLs sensibles y datos de página privados;
• rtrvr verifica el estado final en la pestaña original;
• las acciones sensibles de cuenta, pago, identidad y datos privados requieren revisión explícita;
• los estados no compatibles o ambiguos se detienen de forma segura.

Esta lista de verificación es más importante que agregar otro prompt de planificador. La mayoría de los fallos de integración ocurren en el límite entre el estado del navegador, las entradas de la herramienta, la salida del servicio y la aceptación de la aplicación. Estos son contratos de tiempo de ejecución, no problemas de razonamiento de modelos de lenguaje.

Conclusión

rtrvr proporciona la superficie de herramienta externa necesaria para llamar al MCP de CapSolver, pero la integración confiable es más estrecha que simplemente habilitar una herramienta. Inicie el MCP de CapSolver a través de HTTP Streamable, conecte el punto final en rtrvr, verifique la detección con herramientas no basadas en navegador y llame al solucionador externo por su nombre calificado. Para sesiones activas de rtrvr, use el modo de token y mantenga la presentación de la página y la verificación del resultado dentro del flujo de trabajo original del navegador. Trate las herramientas de navegador separadas como sesiones separadas, conserve la evidencia tipada y deténgase en estados no compatibles o ambiguos. En flujos de trabajo de agente de navegador autorizados, CapSolver proporciona la herramienta de desafío documentada mientras que rtrvr sigue siendo responsable del contexto del navegador y del éxito de la aplicación final.

Agregar manejo de CAPTCHA a un flujo de trabajo autorizado de rtrvr

Revise las cinco herramientas publicadas en la documentación del MCP de CapSolver, luego conecte un punto final local o adecuadamente protegido desde el panel de Herramientas de rtrvr. Use el Panel de control de CapSolver para probar un flujo de trabajo aprobado antes de expandir la integración.

Preguntas frecuentes

P: ¿rtrvr tiene una integración nativa de CapSolver?

La documentación revisada no afirma una colaboración nativa ni un proveedor integrado de CapSolver. La integración en esta guía utiliza la conexión general de herramientas MCP de rtrvr y el servidor MCP público de CapSolver.

P: ¿Por qué no llamar al nombre corto solve_captcha?

rtrvr documenta una acción de navegador integrada con ese nombre, y el MCP de CapSolver publica el mismo nombre corto. Use el nombre importado calificado mostrado en el panel de Herramientas, como capsolver.solve_captcha, para evitar ambigüedades.

P: ¿Puede el MCP de CapSolver usar la pestaña del navegador ya abierta en rtrvr?

No a través de las herramientas MCP documentadas. El modo de token necesita parámetros de desafío explícitos y devuelve un token, mientras que las herramientas en modo de navegador inician un navegador Playwright separado.

P: ¿Debo exponer el puerto MCP local a Internet?

No. Manténgalo en localhost para uso local. Una implementación compartida necesita HTTPS autenticado, restricciones de red, gestión de secretos, controles de origen y una revisión de seguridad explícita.

P: ¿Cómo sé que la tarea del navegador tuvo éxito?

Verifique el resultado en la pestaña original de rtrvr usando la ruta esperada, el estado del DOM, la respuesta de la API y el resultado comercial. Un token devuelto en sí mismo no es evidencia de éxito.