🎉NUEVOCapSolver para agentes de IA-Integraciones de MCP, herramientas de agente y SDK
Aloísio Vítor
Image Processing Expert
Publicado Sep 18, 2026
Actualizado Sep 18, 2026 · min de lectura
io.github.capsolver-ai/capsolver-mcp. La última versión activa es 0.1.3, distribuida a través de PyPI y lanzada localmente a través de stdio.uvx capsolver-mcp. uvx crea un entorno aislado y ejecuta el comando publicado sin requerir una instalación global permanente del paquete.CAPSOLVER_API_KEY. Mantenga la clave real en el entorno del cliente o en un almacén de secretos aprobado, nunca en un repositorio público.browser y Playwright Chromium. Las herramientas básicas de resolución de tokens no necesitan esa instalación adicional de navegador.El Registro MCP Oficial brinda a los clientes y desarrolladores de MCP un registro canónico para descubrir CapSolver MCP, su paquete, transporte, variable de entorno requerida, repositorio y versión actual. El registro no aloja el paquete de Python; apunta a la versión verificada capsolver-mcp en PyPI.
Este tutorial recorre el descubrimiento, instalación, configuración y la primera verificación de conexión. Utiliza CapSolver solo para flujos de trabajo legales, autorizados de agentes de IA, QA, RPA y automatización de navegadores.
La entrada de CapSolver MCP publica los metadatos exactos que necesita un cliente compatible para construir una configuración local de stdio.
| Campo del registro | Valor actual |
|---|---|
| Nombre del registro | io.github.capsolver-ai/capsolver-mcp |
| Versión más reciente | 0.1.3 |
| Registro del paquete | PyPI |
| Identificador del paquete | capsolver-mcp |
| Pista de ejecución | uvx |
| Transporte | stdio |
| Variable requerida | CAPSOLVER_API_KEY |
| Estado | activo |
Puede inspeccionar la entrada actual en la interfaz de búsqueda del Registro MCP Oficial. El registro es un catálogo de nivel superior: estandariza los metadatos de descubrimiento mientras el paquete real permanece en PyPI. La documentación del lanzamiento del Registro MCP describe este modelo de catálogo y distribución.
CapSolver MCP requiere Python 3.10 o superior, un cliente MCP compatible y una clave de API de CapSolver.
Prepare lo siguiente antes de editar una configuración de cliente:
uv si desea el flujo recomendado uvx.La documentación del servicio MCP de CapSolver explica el camino de integración admitido, mientras que la visión general de agentes de IA de CapSolver le ayuda a elegir entre MCP, herramientas de agente y el SDK Core.
Busque capsolver en el Registro MCP Oficial y seleccione este nombre exacto:
io.github.capsolver-ai/capsolver-mcpConfirme que la versión mostrada sea 0.1.3 o superior y que el estado sea activo. Evite paquetes de comunidad con nombres similares a menos que haya revisado por separado a su publicador, repositorio, permisos y código fuente.
Para una verificación a nivel de API, solicite la versión exacta del servidor:
curl "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.capsolver-ai%2Fcapsolver-mcp/versions/0.1.3"La barra diagonal en el nombre del registro se codifica como %2F. La respuesta debe identificar a capsolver-mcp como un paquete de PyPI, uvx como la pista de ejecución y stdio como el transporte.
El camino recomendado ejecuta CapSolver MCP en un entorno aislado:
uvx capsolver-mcp --helpSi prefiere un entorno virtual gestionado, instale el paquete explícitamente:
python -m pip install "capsolver-mcp==0.1.3"
capsolver-mcp --helpLa CLI actual admite modos de ejecución stdio, sse y streamable-http. La entrada del Registro MCP Oficial utiliza stdio porque los clientes lanzan el paquete local como un proceso secundario. El paquete también puede iniciar un proceso compatible con HTTP en su propia infraestructura, pero CapSolver no publica actualmente un punto final remoto hospedado en el registro.
El enfoque uvx sigue el modelo de ejecución aislada de herramientas documentado en la guía oficial de herramientas de uv.
Canjear su código de bonificación de CapSolver
Aumente su presupuesto de automatización instantáneamente!
Use el código de bonificación CAP26 al recargar su cuenta de CapSolver para obtener un 5% adicional en cada recarga — sin límites.
Canjéalo ahora en su Panel de CapSolver
Un cliente local debe lanzar uvx capsolver-mcp y pasar CAPSOLVER_API_KEY al proceso secundario.
Use esta forma de configuración en clientes que acepten un objeto mcpServers, incluyendo Claude Desktop y clientes con configuración de servidor local compatible:
{
"mcpServers": {
"capsolver": {
"command": "uvx",
"args": ["capsolver-mcp"],
"env": {
"CAPSOLVER_API_KEY": "SU_CLAVE_DE_API_DE_CAPSOLVER"
}
}
}
}Reemplace el marcador de posición localmente. No confirme una clave de API real en Git, péguela en informes de problemas o inclúyala en capturas de pantalla.
Si la aplicación de escritorio no puede encontrar uvx, use la ruta absoluta devuelta por el siguiente comando:
which uvxEn PowerShell de Windows, use:
Get-Command uvxDespués de guardar la configuración, reinicie completamente el cliente MCP. Un cierre de ventana puede dejar la aplicación en ejecución en segundo plano, por lo que cierre el proceso si el servidor no aparece después de editar la configuración.
Una conexión exitosa debe exponer cinco herramientas de CapSolver MCP al cliente.
| Herramienta | Propósito | Dependencia adicional de navegador |
|---|---|---|
solve_captcha |
Enviar y recuperar una solución usando parámetros de desafío explícitos | No |
detect_captchas |
Inspeccionar una página autorizada en busca de tipos de desafíos admitidos | Sí |
solve_on_page |
Detectar, resolver y completar desafíos admitidos en un flujo de trabajo de navegador autorizado | Sí |
get_balance |
Verificar el saldo de la cuenta y los paquetes | No |
get_supported_captchas |
Listar tipos de desafíos y manejadores admitidos | No |
Comience con una verificación sin navegador, como:
Use el servidor MCP de CapSolver para listar los tipos de CAPTCHA admitidos.Luego verifique la autenticación de la cuenta con:
Use el servidor MCP de CapSolver para verificar mi saldo de cuenta.Estas verificaciones confirman que el cliente puede lanzar el proceso de stdio, descubrir sus herramientas y pasar la variable de entorno. Una solicitud real de resolución necesita además parámetros autorizados del objetivo y un saldo de cuenta suficiente.
La detección y la interacción en página basadas en navegador requieren el paquete adicional opcional más Chromium de Playwright.
Para un entorno dedicado, ejecute:
python -m pip install "capsolver-mcp[browser]==0.1.3"
playwright install chromiumSi el cliente MCP lanza uvx, incluya el extra de navegador en el argumento del paquete:
{
"mcpServers": {
"capsolver-browser": {
"command": "uvx",
"args": ["--from", "capsolver-mcp[browser]==0.1.3", "capsolver-mcp"],
"env": {
"CAPSOLVER_API_KEY": "SU_CLAVE_DE_API_DE_CAPSOLVER"
}
}
}
}Playwright aún necesita una binaria de Chromium compatible en la misma máquina. Para flujos de producción, fije versiones, pruebe actualizaciones en entornos de prueba y mantenga la instalación de navegador separada de secretos de aplicación.
La mayoría de los fallos de conexión de CapSolver MCP provienen de la ruta de ejecución, la versión de Python, credenciales faltantes o dependencias de navegador opcionales.
spawn uvx ENOENTLa aplicación de escritorio no puede ver uvx en su ruta de proceso. Use la ruta absoluta de uvx en el campo command, luego reinicie completamente la aplicación.
El valor de CAPSOLVER_API_KEY está faltante, malformado o no llega al proceso secundario. Confirme el nombre exacto de la variable, reemplace el marcador de posición y evite agregar comillas adicionales dentro de los valores JSON.
detect_captchas o solve_on_page no están disponiblesEl paquete base no instala Playwright. Instale capsolver-mcp[browser], instale Chromium y reinicie el cliente para que lance el entorno actualizado.
Las APIs de búsqueda del Registro pueden devolver múltiples versiones publicadas del mismo servidor. Seleccione el registro donde isLatest sea true, o consulte el punto final de versión exacta en lugar de tratar el recuento de resultados como una verificación de unicidad.
Separe los problemas de conexión de los problemas de tarea. Primero verifique el descubrimiento de herramientas y get_balance; luego verifique el tipo de tarea, URL del sitio web, clave del sitio, campos opcionales y saldo de cuenta contra la documentación de CapSolver.
CapSolver MCP es una interfaz de herramienta local, no un permiso para automatizar un objetivo. Úselo solo en sitios web y sistemas que posea o esté autorizado a probar o automatizar. Siga los términos aplicables, requisitos de privacidad, límites de frecuencia y reglas de retención de datos.
El Registro Oficial confirma metadatos controlados por el publicador y ubicación del paquete; no reemplaza su propia revisión de seguridad. Inspeccione el repositorio de código fuente de CapSolver MCP, fije versiones donde su proceso de cambio lo requiera, proteja las claves de API y pruebe actualizaciones antes de su implementación general.
Para decisiones de arquitectura más allá de un solo cliente, vea cómo los equipos de agentes de IA empresariales estructuran el manejo de desafíos autorizados y revise la definición de un punto final de API al diseñar límites de servicio.
El Registro MCP Oficial ahora proporciona un registro canónico y buscable para CapSolver MCP, mientras que PyPI suministra el paquete de Python ejecutable. Una configuración confiable sigue una secuencia corta: confirme la identidad del registro, ejecute la CLI, agregue CAPSOLVER_API_KEY al entorno del cliente, reinicie el cliente y verifique el descubrimiento de herramientas antes de intentar una tarea autorizada.
Use CapSolver para agregar herramientas de resolución de CAPTCHA documentadas a flujos de trabajo de agentes de IA y automatización de navegadores compatibles.
Cree una cuenta, almacene su clave de API de forma segura y comience con una prueba limitada en un sitio web o sistema autorizado para automatizar. La Preguntas Frecuentes de CapSolver cubre preguntas comunes sobre el producto y la cuenta antes de mover la integración a producción.
P: ¿Está disponible CapSolver MCP en el Registro MCP Oficial?
Sí. El nombre del registro es io.github.capsolver-ai/capsolver-mcp, y la versión 0.1.3 está actualmente activa y marcada como la última versión.
P: ¿Instalar desde el Registro crea una conexión remota hospedada?
No. La entrada del registro actual describe un paquete de PyPI lanzado localmente con uvx a través de stdio; no anuncia un punto final MCP remoto hospedado por CapSolver.
P: ¿Necesito instalar capsolver-mcp de forma global?
No. uvx capsolver-mcp ejecuta la herramienta en un entorno aislado, mientras que una instalación explícita de pip install sigue disponible para equipos que gestionen sus propios entornos virtuales.
P: ¿Por qué mi cliente se conecta pero no muestra las herramientas de navegador?
Las herramientas de navegador requieren el extra capsolver-mcp[browser] y una instalación de Chromium de Playwright. Reinicie el cliente después de instalar ambos componentes.
P: ¿Qué variable de entorno requiere CapSolver MCP?
CapSolver MCP requiere CAPSOLVER_API_KEY. Pásela a través del entorno del cliente y mantenga el valor real fuera del control de código fuente y capturas de pantalla de soporte.
P: ¿Puedo usar CapSolver MCP en cualquier sitio web?
No. Úselo solo en sitios web y sistemas que posea o esté autorizado a probar o automatizar, y siga los términos aplicables, reglas de privacidad y requisitos legales.
Aloísio Vítor
Image Processing Expert
Interpreting the visual signals behind web workflows.
SOBRE EL AUTOR
Agrega herramientas de CAPTCHA a Pydantic AI utilizando el adaptador oficial de CapSolver, prueba la ejecución de la herramienta localmente y maneja entradas con tipo y resultados estructurados del solucionador.
Compara las interfaces MCP y CLI para agentes de IA en descubrimiento de herramientas, costo de contexto, seguridad, depuración, manejo de fallos y arquitectura híbrida.
