Como configurar as ferramentas MCP de solução de CAPTCHA no Qwen Code

TL;DR

• O Qwen Code pode se conectar ao serviço oficial CapSolver MCP como um processo local via stdio.
• Coloque o servidor em .qwen/settings.json do projeto, usando o executável Python do ambiente onde os pacotes estão instalados.
• Revise e aprove o servidor do projeto e, em seguida, execute qwen mcp list para verificar a conexão.
• Um servidor conectado disponibiliza ferramentas; isso não prova que uma requisição paga de CAPTCHA ou um envio via navegador tenha sido bem-sucedido.
• Use as ferramentas de token para parâmetros explícitos de CAPTCHA e as ferramentas de navegador para a página gerenciada por esse serviço. Servidores MCP separados não compartilham automaticamente uma aba do navegador.

O Qwen Code é um agente de programação open source que roda em um terminal. Desenvolvedores podem usá‑lo para trabalhar em código de aplicação e invocar ferramentas conectadas. Quando um fluxo de trabalho autorizado em navegador encontra um CAPTCHA, apenas o modelo de código não fornece uma solução. Um solucionador precisa dos dados relevantes do desafio e de um lugar claro para devolver o resultado.

O CapSolver expõe essas capacidades por meio de seu serviço MCP oficial. Este guia conecta esse serviço ao Qwen Code, verifica se o cliente consegue alcançá‑lo e explica como escolher a ferramenta adequada. O exemplo de conexão não exige que um modelo improvise código Python ou invente um payload de API.

O que a integração com o Qwen Code oferece

A integração dá ao Qwen Code acesso a um serviço separado que implementa ferramentas relacionadas a CAPTCHA. O Qwen Code continua sendo o cliente que descobre ferramentas e solicita ações; o serviço lida com as operações de solução documentadas.

O projeto oficial Qwen Code descreve o produto como um agente de programação em terminal. O MCP estende esse ambiente com capacidades fornecidas por servidores. Instalar um servidor de CAPTCHA não transforma toda tarefa de programação em tarefa de navegador, e a edição comum de código não precisa de um solucionador.

Um caso útil é um desenvolvedor verificando um fluxo de trabalho permitido em navegador cujo próximo passo está bloqueado por um CAPTCHA. O desenvolvedor pode inspecionar o desafio, selecionar uma operação compatível e manter o resultado associado àquela página. Isso é mais restrito do que pedir ao agente para tornar um site inteiro acessível.

Se o MCP é novo no seu fluxo de trabalho, a distinção entre cliente e chamada de API é importante: uma descrição de ferramenta anuncia uma operação, enquanto uma invocação real a executa. O status de conexão descreve disponibilidade, não a execução bem-sucedida de toda operação anunciada.

Prepare o cliente e o ambiente Python

Prepare o Qwen Code e um ambiente Python contendo o servidor oficial antes de editar a configuração do projeto.

A conexão descrita aqui usa Qwen Code 0.26.1 com capsolver-core 0.1.1 e capsolver-mcp 0.1.3. O pacote do Qwen Code requer Node.js 22 ou superior. Siga as instruções oficiais de instalação se o comando qwen ainda não estiver disponível.

Instale os pacotes do solucionador no ambiente Python que você pretende que o Qwen Code inicie:

python -m pip install capsolver-core==0.1.1 capsolver-mcp==0.1.3

O guia oficial de instalação MCP também descreve o extra de navegador e a instalação do Chromium. Essas dependências são exigidas para detecção baseada em navegador e resolução de página. Elas são separadas do estabelecimento da conexão via stdio.

Uma chave de API CapSolver válida e saldo suficiente na conta são pré‑requisitos para resolução paga. Acesso a modelo no Qwen Code é outro pré‑requisito separado para uso conversacional de ferramentas. A verificação de conexão abaixo testa apenas inicialização do servidor e conexão; ela não envia uma resolução paga nem executa uma tarefa dirigida por modelo.

Mantenha a chave de conta no ambiente usado para iniciar o Qwen Code. Não cole o valor real em uma configuração de projeto versionada ou em artigo, issue, captura de tela ou transcrição compartilhada.

Configure o servidor no projeto

Adicione uma entrada capsolver ao objeto mcpServers em .qwen/settings.json na raiz do projeto.

O Qwen Code documenta tanto a configuração de projeto quanto a substituição de variáveis de ambiente em sua referência de configuração MCP. Faça o merge da entrada com as configurações existentes em vez de substituir outros servidores ou preferências do projeto.

{
  "mcpServers": {
    "capsolver": {
      "command": "/absolute/path/to/venv/bin/python",
      "args": ["-m", "capsolver_mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "${CAPSOLVER_API_KEY}"
      },
      "trust": false
    }
  }
}

Substitua o caminho do executável pelo caminho real do Python dentro do ambiente instalado. Um caminho absoluto impede que um terminal, editor ou lançador de serviços encontre uma instalação diferente de Python por meio de seu próprio PATH. Preserve o caminho do ambiente virtual; resolver um symlink para o interpretador base pode selecionar um interpretador sem os pacotes instalados.

O placeholder é uma referência a variável de ambiente, não uma chave de API. A variável precisa existir no ambiente do processo quando o Qwen Code é iniciado. Uma chave definida em um terminal não se torna automaticamente disponível para um cliente iniciado em outro lugar.

Essa configuração usa stdio: o Qwen Code inicia o módulo Python como um processo local. Ele não precisa de endpoint HTTP público, porta exposta ou das credenciais MCP de CMS usadas por um fluxo de publicação de conteúdo.

Resgate Seu Código de Bônus CapSolver

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

Aprove e verifique a conexão real

Aprove o servidor revisado do projeto e então verifique a conexão a partir do mesmo diretório do projeto.

qwen mcp approve capsolver
qwen mcp list

Na versão de cliente testada, uma entrada de projeto não aprovada aparece como pendente de aprovação. Após a aprovação, o servidor pode se conectar. O sinal útil esperado é que a entrada capsolver esteja conectada; a linha também identifica o executável e o transporte.

Aprovação e trust servem a propósitos diferentes. Aprovar um servidor revisado permite que ele se conecte. Manter trust como false preserva o comportamento normal de confirmação de chamadas de ferramenta. Não altere essa configuração apenas para ocultar um problema de setup.

Se a conexão falhar, verifique primeiro o caminho do executável, depois confirme se o mesmo ambiente Python consegue importar os pacotes instalados. Verifique se a configuração está no projeto que você realmente abriu. A referência de configurações do Qwen explica as fontes de configuração; uma entrada duplicada em outro lugar pode dificultar a solução de problemas.

Uma conexão bem-sucedida sem chave de solução ainda não estabelece acesso à conta. Uma verificação de conexão e uma operação faturável exercitam partes diferentes do sistema.

Escolha a ferramenta que corresponde à etapa do CAPTCHA

Escolha uma ferramenta de acordo com as informações e o estado de navegador já disponíveis no seu fluxo de trabalho.

O serviço oficial expõe get_supported_captchas, get_balance, detect_captchas, solve_captcha e solve_on_page. Comece pela listagem de tipos suportados quando precisar confirmar os nomes de capacidades do serviço instalado. Verifique o saldo separadamente ao diagnosticar a prontidão da conta.

Use solve_captcha quando o fluxo de trabalho já tiver o tipo de CAPTCHA documentado e os parâmetros do site. Seu resultado ainda precisa ser consumido pela aplicação que o requisitou. Em tarefas baseadas em token, receber um token não envia, por si só, um formulário nem prova que o site aceitou a requisição.

Use ferramentas de navegador apenas com a configuração de navegador documentada. detect_captchas inspeciona uma URL de página. solve_on_page combina detecção, solução e preenchimento de volta dentro do fluxo de trabalho de navegador do serviço. Nenhum dos nomes promete acesso a uma aba que pertença a outro servidor MCP.

Para uma verificação conversacional inicial, peça ao Qwen Code para listar os tipos de CAPTCHA suportados pelo servidor configurado. Para uma tarefa de página autorizada, informe a página e a operação permitida de forma precisa, e revise a ferramenta e os argumentos selecionados antes da execução. Evite uma instrução aberta para continuar tentando até que um site permita acesso.

Mantenha a transferência para o navegador explícita

A transferência para o navegador deve preservar o contexto exigido pela tarefa. Apenas uma URL pode não reproduzir uma página que foi alcançada por meio de interações anteriores.

Se sua automação de navegador existente controla uma página ativa, decida se você precisa de um token para esse fluxo de trabalho ou de uma integração de SDK com essa página. Não presuma que adicionar dois servidores MCP une suas sessões, cookies, abas ou estado de JavaScript.

O guia de integração do Core SDK descreve a integração direta com navegador. Essa pode ser a rota apropriada quando a aplicação precisa manter um objeto de página existente. A explicação token-versus-cookie também ajuda a distinguir o artefato retornado por um solucionador do estado mais amplo de uma sessão de navegador.

Antes de considerar um fluxo de trabalho concluído, verifique o resultado na aplicação. O formulário esperado foi aceito? A página permitida avançou para o estado pretendido? Um servidor conectado, um widget detectado e uma requisição de aplicação aceita são marcos diferentes.

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

Conecte o serviço oficial, inspecione as ferramentas e comece com uma operação limitada que corresponda ao CAPTCHA no seu fluxo de trabalho. O CapSolver pode fornecer a etapa de solução documentada enquanto o Qwen Code permanece responsável por escolher e invocar ferramentas dentro da tarefa que você aprovou.

FAQ

P: O Qwen Code inclui um solucionador de CAPTCHA por padrão?

Não. Este guia adiciona o serviço oficial CapSolver MCP como um provedor de ferramentas separado. O modelo do Qwen Code e a conta do solucionador são componentes distintos.

P: Por que o servidor aparece como pendente de aprovação?

Uma entrada MCP de projeto pode exigir aprovação antes de o Qwen Code se conectar. Revise o comando e a configuração de ambiente e, em seguida, use o comando de aprovação suportado pela versão do cliente que você instalou.

P: Posso testar a conexão sem pagar por um CAPTCHA?

Sim. A conexão do servidor pode ser verificada separadamente da resolução paga. Um status conectado não verifica o saldo da conta, a execução de tarefa paga ou a aceitação de uma solução por um site.

P: O serviço usa minha outra aba de navegador MCP?

Não presuma que sim. Servidores separados têm fluxos de trabalho de navegador separados, a menos que uma integração documentada os conecte explicitamente. Escolha o modo de token ou integração direta via SDK quando você precisar preservar uma página existente.

P: Por que as ferramentas de navegador não estão disponíveis após a instalação?

Verifique o extra de navegador e os pré‑requisitos de Chromium no guia MCP oficial. Inspecione também quaisquer filtros de ferramenta no lado do cliente e se a entrada de servidor esperada está conectada.

P: Esta configuração consegue lidar com todo CAPTCHA em qualquer página?

Não. Use a lista atual de tipos suportados e as referências de tarefa, e limite operações a páginas e fluxos de trabalho que você está autorizado a automatizar. Uma ferramenta anunciada não é garantia de sucesso em uma página arbitrária.