Como instalar o CapSolver MCP do Registro Oficial MCP

TL;DR

• O CapSolver MCP está listado no Registro MCP Oficial como io.github.capsolver-ai/capsolver-mcp. A versão mais recente ativa é 0.1.3, distribuída pelo PyPI e executada localmente via stdio.
• O caminho mais curto de instalação é uvx capsolver-mcp. uvx cria um ambiente isolado e executa o comando publicado sem exigir uma instalação global permanente.
• Toda configuração do cliente precisa de CAPSOLVER_API_KEY. Mantenha a chave real no ambiente do cliente ou em um repositório de segredos aprovado, nunca em um repositório público.
• Uma conexão funcional deve expor cinco ferramentas. Elas cobrem resolução baseada em token, detecção de página, resolução em nível de página, verificação de saldo e tipos de desafio suportados.
• Ferramentas baseadas em navegador exigem o extra opcional browser e o Chromium do Playwright. Ferramentas básicas de token não precisam dessa instalação adicional de navegador.
• Use o CapSolver apenas em fluxos que você possua ou tenha permissão para testar ou automatizar. A disponibilidade no registro não concede permissão para acessar sistemas privados ou restritos.

Instale o CapSolver MCP do Registro MCP Oficial

O Registro MCP Oficial fornece um registro canônico para clientes e desenvolvedores de MCP descobrirem o CapSolver MCP, seu pacote, transporte, variável de ambiente necessária, repositório e versão atual. O registro não hospeda o pacote Python; ele aponta os clientes para a versão verificada capsolver-mcp no PyPI.

Este tutorial percorre a descoberta, instalação, configuração e a primeira verificação de conexão. Ele usa o CapSolver apenas para fluxos de trabalho legais, autorizados de agentes de IA, QA, RPA e automação de navegadores.

O que a Entrada do Registro Oficial Fornece

A entrada do CapSolver MCP publica os metadados exatos que um cliente compatível precisa para construir uma configuração local via stdio.

Você pode inspecionar a entrada atual na interface de pesquisa do Registro MCP Oficial. O registro é um catálogo upstream: padroniza metadados de descoberta enquanto o pacote real permanece no PyPI. A documentação do lançamento do Registro MCP descreve esse modelo de catálogo e distribuição.

Pré-requisitos

O CapSolver MCP precisa do Python 3.10 ou superior, de um cliente MCP compatível e de uma chave de API do CapSolver.

Prepare o seguinte antes de editar uma configuração de cliente:

1. Instale o Python 3.10 ou superior.
2. Instale uv se quiser o fluxo recomendado uvx.
3. Crie uma conta no CapSolver e obtenha uma chave de API no painel.
4. Confirme que seu cliente MCP suporte servidores locais via stdio.
5. Decida se precisa apenas de ferramentas baseadas em token ou das ferramentas opcionais de navegador.

A documentação do serviço MCP do CapSolver explica o caminho de integração suportado, enquanto a visão geral do agente de IA do CapSolver ajuda você a escolher entre MCP, ferramentas de agente e o Core SDK.

Etapa 1: Encontre o Registro Correto

Procure por capsolver no Registro MCP Oficial e selecione esse nome exato:

io.github.capsolver-ai/capsolver-mcp

Confirme que a versão exibida é 0.1.3 ou superior e que o status é ativo. Evite pacotes com nomes semelhantes, a menos que você tenha revisado separadamente o editor, repositório, permissões e código-fonte.

Para uma verificação de nível de API, solicite a versão exata do servidor:

curl "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.capsolver-ai%2Fcapsolver-mcp/versions/0.1.3"

A barra no nome do registro é codificada como %2F. A resposta deve identificar capsolver-mcp como um pacote PyPI, uvx como a dica de execução e stdio como o transporte.

Etapa 2: Instale e Verifique a CLI

O caminho recomendado executa o CapSolver MCP em um ambiente isolado:

uvx capsolver-mcp --help

Se você preferir um ambiente virtual gerenciado, instale o pacote explicitamente:

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

A CLI atual suporta os modos de execução stdio, sse e streamable-http. A entrada do Registro MCP Oficial usa stdio porque os clientes lançam o pacote local como um subprocesso. O pacote também pode iniciar um processo compatível com HTTP em sua própria infraestrutura, mas o CapSolver não publica atualmente um ponto de extremidade MCP remoto hospedado no registro.

O método uvx segue o modelo de execução isolada de ferramentas documentado na guia oficial de ferramentas uv.

Resgate seu código promocional do CapSolver

Aumente seu orçamento de automação instantaneamente!
Use o código promocional CAP26 ao recarregar sua conta do CapSolver para obter um bônus adicional de 5% em cada recarga — sem limites.
Resgate-o agora no seu Painel do CapSolver

Etapa 3: Configure um Cliente MCP Local

Um cliente local deve lançar uvx capsolver-mcp e passar CAPSOLVER_API_KEY para o subprocesso.

Use esse formato de configuração em clientes que aceitam um objeto mcpServers, incluindo o Claude Desktop e clientes com configuração de servidor local compatível:

{
  "mcpServers": {
    "capsolver": {
      "command": "uvx",
      "args": ["capsolver-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "SUA_CAPSOLVER_API_KEY"
      }
    }
  }
}

Substitua o espaço reservado localmente. Não comite uma chave real no Git, cole-a em relatos de problemas ou inclua-a em capturas de tela.

Se o aplicativo de desktop não encontrar uvx, use o caminho absoluto retornado pelo seguinte comando:

which uvx

No PowerShell do Windows, use:

Get-Command uvx

Após salvar a configuração, reinicie completamente o cliente MCP. Um fechamento de janela pode deixar o aplicativo rodando em segundo plano, então encerre o processo se o servidor não aparecer após editar a configuração.

Etapa 4: Verifique o Handshake MCP e as Ferramentas

Uma conexão bem-sucedida deve expor cinco ferramentas do CapSolver MCP ao cliente.

Comece com uma verificação sem navegador, como:

Use o servidor MCP do CapSolver para listar os tipos de CAPTCHA suportados.

Em seguida, verifique a autenticação da conta com:

Use o servidor MCP do CapSolver para verificar meu saldo da conta.

Essas verificações confirmam que o cliente pode lançar o processo stdio, descobrir suas ferramentas e passar a variável de ambiente. Uma solicitação real de resolução também precisa de parâmetros de destino autorizados e saldo suficiente na conta.

Etapa 5: Ative Ferramentas Baseadas em Navegador Quando Necessário

A detecção e interação baseadas em navegador exigem o extra opcional do pacote mais o Chromium do Playwright.

Para um ambiente dedicado, execute:

python -m pip install "capsolver-mcp[browser]==0.1.3"
playwright install chromium

Se o cliente MCP lançar uvx, inclua o extra de navegador no argumento do pacote:

{
  "mcpServers": {
    "capsolver-browser": {
      "command": "uvx",
      "args": ["--from", "capsolver-mcp[browser]==0.1.3", "capsolver-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "SUA_CAPSOLVER_API_KEY"
      }
    }
  }
}

O Playwright ainda precisa de uma binária Chromium compatível na mesma máquina. Para fluxos de produção, fixe as versões, teste as atualizações no ambiente de staging e mantenha a instalação do navegador separada das segredos da aplicação.

Problemas Comuns na Configuração

A maioria das falhas de conexão do CapSolver MCP vem do caminho de execução, versão do Python, credenciais ausentes ou dependências de navegador opcionais.

O cliente relata spawn uvx ENOENT

O aplicativo de desktop não consegue ver uvx no seu PATH. Use o caminho absoluto de uvx no campo command e reinicie o aplicativo completamente.

O servidor inicia, mas as ferramentas falham na autenticação

O valor de CAPSOLVER_API_KEY está ausente, malformado ou não chega ao processo filho. Confirme o nome da variável exatamente, substitua o espaço reservado e evite adicionar aspas extras dentro dos valores JSON.

detect_captchas ou solve_on_page não estão disponíveis

O pacote base não instala o Playwright. Instale capsolver-mcp[browser], instale o Chromium e reinicie o cliente para que ele lance o ambiente atualizado.

O Registro mostra mais de um resultado do CapSolver

As APIs de pesquisa do Registro podem retornar várias versões publicadas do mesmo servidor. Selecione o registro onde isLatest é true, ou consulte o endpoint da versão exata em vez de tratar a contagem de resultados como verificação de unicidade.

O cliente se conecta, mas uma solicitação de resolução falha

Separe problemas de conexão de problemas de tarefa. Primeiro verifique a descoberta de ferramentas e get_balance; depois, verifique o tipo de tarefa, URL do site, chave do site, campos opcionais e saldo da conta contra a documentação do CapSolver.

Limites de Uso e Operacionais Responsáveis

O CapSolver MCP é uma interface de ferramenta local, não permissão para automatizar um alvo. Use-o apenas em sites e sistemas que você possua ou tenha permissão para testar ou automatizar. Siga os termos aplicáveis, requisitos de privacidade, limites de taxa e regras de retenção de dados.

O Registro Oficial confirma metadados e localização do pacote controlados pelo editor; ele não substitui sua própria revisão de segurança. Inspeção o repositório de código fonte do CapSolver MCP, fixe versões onde seu processo de mudança exige, proteja as chaves de API e teste atualizações antes da implantação em larga escala.

Para decisões de arquitetura além de um único cliente, veja como equipes de agentes de IA empresariais estruturam o tratamento de desafios autorizados e revise a definição de um ponto de extremidade de API ao projetar limites de serviço.

Conclusão

O Registro MCP Oficial agora fornece um registro canônico, pesquisável para o CapSolver MCP, enquanto o PyPI fornece o pacote Python executável. Uma configuração confiável segue uma sequência curta: confirme a identidade do registro, execute a CLI, adicione CAPSOLVER_API_KEY ao ambiente do cliente, reinicie o cliente e verifique a descoberta de ferramentas antes de tentar uma tarefa autorizada.

Use o CapSolver para adicionar ferramentas de resolução de CAPTCHA documentadas a fluxos de trabalho de agente de IA e automação de navegador.

Construa Workflows de Automação Confiáveis com o CapSolver

Crie uma conta, armazene sua chave de API com segurança e comece com um teste limitado em um site ou sistema que você tenha permissão para automatizar. A FAQ do CapSolver cobre perguntas comuns sobre produto e conta antes de mover a integração para produção.

Perguntas Frequentes

Q: O CapSolver MCP está disponível no Registro MCP Oficial?

Sim. O nome do registro é io.github.capsolver-ai/capsolver-mcp, e a versão 0.1.3 está atualmente ativa e marcada como a versão mais recente.

Q: A instalação a partir do Registro cria uma conexão remota hospedada?

Não. A entrada atual do registro descreve um pacote PyPI lançado localmente com uvx via stdio; ele não anuncia um ponto de extremidade MCP remoto hospedado pelo CapSolver.

Q: Preciso instalar o capsolver-mcp globalmente?

Não. uvx capsolver-mcp executa a ferramenta em um ambiente isolado, enquanto uma instalação explícita do pip install permanece disponível para equipes que gerenciam seus próprios ambientes virtuais.

Q: Por que meu cliente se conecta, mas não mostra as ferramentas de navegador?

As ferramentas de navegador exigem o extra capsolver-mcp[browser] e uma instalação do Chromium do Playwright. Reinicie o cliente após instalar ambos os componentes.

Q: Qual variável de ambiente o CapSolver MCP requer?

O CapSolver MCP requer CAPSOLVER_API_KEY. Passe-a pelo ambiente do cliente e mantenha o valor real fora do controle de versão e capturas de tela de suporte.

Q: Posso usar o CapSolver MCP em qualquer site?

Não. Use o CapSolver MCP apenas em sites e sistemas que você possua ou tenha permissão para testar ou automatizar, e siga os termos aplicáveis, regras de privacidade e requisitos legais.