Cómo instalar CapSolver MCP desde el Registro Oficial MCP

TL;DR

• CapSolver MCP está listado en el Registro MCP Oficial como 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.
• El camino de instalación más corto es uvx capsolver-mcp. uvx crea un entorno aislado y ejecuta el comando publicado sin requerir una instalación global permanente del paquete.
• Cada configuración de cliente necesita 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.
• Una conexión funcional debe exponer cinco herramientas. Cubren resolución basada en tokens, detección de páginas, resolución a nivel de página, verificación de saldo y tipos de desafíos admitidos.
• Las herramientas basadas en navegador requieren el extra opcional browser y Playwright Chromium. Las herramientas básicas de resolución de tokens no necesitan esa instalación adicional de navegador.
• Use CapSolver solo en flujos de trabajo que posea o esté autorizado a probar o automatizar. La disponibilidad del registro no otorga permiso para acceder a sistemas privados o restringidos.

Instalar CapSolver MCP desde el Registro MCP Oficial

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.

Lo que proporciona la entrada del Registro Oficial

La entrada de CapSolver MCP publica los metadatos exactos que necesita un cliente compatible para construir una configuración local de stdio.

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.

Requisitos previos

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:

1. Instale Python 3.10 o superior.
2. Instale uv si desea el flujo recomendado uvx.
3. Cree una cuenta en CapSolver y obtenga una clave de API desde el panel.
4. Confirme que su cliente MCP admita servidores locales de stdio.
5. Decida si solo necesita herramientas basadas en tokens o las herramientas adicionales de navegador.

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.

Paso 1: Encontrar el registro correcto del registro

Busque capsolver en el Registro MCP Oficial y seleccione este nombre exacto:

io.github.capsolver-ai/capsolver-mcp

Confirme 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.

Paso 2: Instalar y verificar la CLI

El camino recomendado ejecuta CapSolver MCP en un entorno aislado:

uvx capsolver-mcp --help

Si prefiere un entorno virtual gestionado, instale el paquete explícitamente:

python -m pip install "capsolver-mcp==0.1.3"
capsolver-mcp --help

La 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

Paso 3: Configurar un cliente MCP local

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 uvx

En PowerShell de Windows, use:

Get-Command uvx

Despué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.

Paso 4: Verificar el intercambio de mensajes MCP y las herramientas

Una conexión exitosa debe exponer cinco herramientas de CapSolver MCP al cliente.

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.

Paso 5: Habilitar herramientas basadas en navegador cuando sea necesario

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 chromium

Si 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.

Problemas comunes de configuració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.

El cliente informa de spawn uvx ENOENT

La 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 servidor se inicia pero las herramientas fallan en la autenticació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 disponibles

El paquete base no instala Playwright. Instale capsolver-mcp[browser], instale Chromium y reinicie el cliente para que lance el entorno actualizado.

El Registro muestra más de un resultado de CapSolver

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.

El cliente se conecta pero una solicitud de resolución falla

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.

Límites operativos y de uso responsable

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.

Conclusión

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 flujos de automatización confiables con CapSolver

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.

Preguntas Frecuentes

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.