Como resolver CAPTCHA com o MCP: Modelo de Contexto do Protocolo de Serviço CapSolver

O Protocolo de Contexto de Modelo (MCP) permite que clientes de IA descubram e chamem ferramentas externas sem código de integração. O pacote capsolver-mcp da CapSolver expõe a resolução de CAPTCHA como um serviço MCP padrão — uma vez conectado, qualquer cliente compatível com MCP (Claude Desktop, Claude Code, Cursor, Cline, Windsurf) ganha automaticamente cinco ferramentas de resolução. Este guia mostra como configurar e usar o serviço MCP da CapSolver para resolução de CAPTCHA no seu fluxo de trabalho de IA.

TL;DR

• capsolver-mcp expõe a resolução de CAPTCHA como ferramentas MCP padrão — nenhum código de adaptador por cliente é necessário
• Qualquer cliente compatível com MCP descobre as ferramentas automaticamente ao se conectar
• Cinco ferramentas disponíveis: solve_captcha, detect_captchas, solve_on_page, get_balance, get_supported_captchas
• Suporta transportes stdio, SSE e streamable-http
• Invocação por linguagem natural: basta pedir "resolva o reCAPTCHA nesta página" e o cliente chama a ferramenta

O que é o MCP e por que ele importa para a resolução de CAPTCHA

O Model Context Protocol é um padrão aberto que permite que aplicações de IA descubram e usem ferramentas externas através de uma interface unificada. Em vez de escrever código de integração personalizado para cada cliente de IA, você empacota uma capacidade como um serviço MCP uma vez, e todo cliente compatível pode usá-la imediatamente.

Para resolução de CAPTCHA, isso significa que você instala capsolver-mcp, configura com sua chave de API e todos os clientes MCP no seu fluxo de trabalho — Claude Desktop para pesquisa, Cursor para desenvolvimento, Cline para automação — ganham imediatamente a capacidade de resolver reCAPTCHAs, Cloudflare Turnstile e outros desafios de verificação. Nenhum código por cliente, nenhum adaptador específico de framework.

A especificação do MCP define como os clientes descobrem ferramentas, as chamam com parâmetros estruturados e recebem resultados. A implementação da CapSolver segue exatamente esta especificação, tornando-a compatível com o crescente ecossistema de clientes MCP.

O que você precisa antes de começar

# Instale o motor principal primeiro (mcp depende dele)
pip install git+https://github.com/capsolver-ai/capsolver-core.git

# Instale o serviço MCP
pip install git+https://github.com/capsolver-ai/capsolver-mcp.git

# Opcional: ferramentas para navegador (detectar/solver_on_page)
pip install "capsolver-mcp[browser] @ git+https://github.com/capsolver-ai/capsolver-mcp.git"
playwright install chromium

export CAPSOLVER_API_KEY="sua-chave-de-api-da-capsolver"

Etapa 1 — Iniciar o Serviço MCP

Linha de Comando

# stdio (padrão — para clientes MCP locais como Claude Desktop)
capsolver-mcp

# SSE (para acesso remoto/HTTP)
capsolver-mcp --transport sse --host 0.0.0.0 --port 8000

# HTTP streamable (especificação MCP 2025-03-26)
capsolver-mcp --transport streamable-http --host 0.0.0.0 --port 8000

Opções da linha de comando:

capsolver-mcp [OPÇÕES]
  --transport {stdio,sse,streamable-http}   Protocolo de transporte (padrão: stdio)
  --host HOST              Host para SSE/HTTP (padrão: 127.0.0.1)
  --port PORT              Porta para SSE/HTTP (padrão: 8000)
  --api-key KEY            Chave de API (faz fallback para a variável de ambiente CAPSOLVER_API_KEY)
  --name NAME              Nome do serviço (padrão: capsolver)

Etapa 2 — Configurar seu Cliente MCP

Claude Desktop / Claude Code

Adicione ao seu arquivo de configuração MCP:

{
  "mcpServers": {
    "capsolver": {
      "command": "capsolver-mcp",
      "env": {
        "CAPSOLVER_API_KEY": "SUA_CHAVE_DE_API"
      }
    }
  }
}

Se o cliente não encontrar capsolver-mcp no PATH (comum com venv/conda):

{
  "mcpServers": {
    "capsolver": {
      "command": "/caminho/absoluto/para/venv/bin/python",
      "args": ["-m", "capsolver_mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "SUA_CHAVE_DE_API"
      }
    }
  }
}

Cursor / VS Code

Mesmo bloco de configuração no mcp.json do seu projeto. Após recarregar, as cinco ferramentas da CapSolver aparecem automaticamente na lista de ferramentas.

Etapa 3 — Ferramentas Disponíveis

Uma vez conectado, o serviço expõe cinco ferramentas:

Etapa 4 — Usar Linguagem Natural para Resolver CAPTCHAs

Com o serviço MCP conectado, basta usar linguagem natural em seu cliente de IA:

Verificar saldo:

"Use o capsolver para verificar meu saldo da conta."

O cliente chama get_balance e retorna seu saldo.

Resolver em modo Token:

"Resolva este reCAPTCHA v2 para mim. A URL é https://exemplo.com/login e a chave do site é 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI."

O cliente chama solve_captcha com os parâmetros e retorna um token.

Resolver toda a página:

"Detectar e resolver todos os CAPTCHA em https://exemplo.com/pagina-protegida."

O cliente chama solve_on_page, que detecta, resolve e preenche todos os CAPTCHA na página.

Etapa 5 — Criação Programática do Servidor MCP

Para integrar o serviço MCP em sua própria aplicação:

from capsolver_mcp import create_server

# Crie e execute o servidor MCP programaticamente
server = create_server(
    api_key="SUA_CHAVE_DE_API_DA_CAPSOLVER",
    name="capsolver",
    transport="stdio"
)

Isso é útil quando você quer integrar a capacidade de resolver CAPTCHA em um serviço MCP maior que expõe múltiplos conjuntos de ferramentas.

Reclame Seu Código de Bônus: Use o código WEBS no Painel da CapSolver para obter um bônus extra de 5% em cada recarga.

A documentação do MCP da CapSolver fornece exemplos adicionais de configuração. Para entender o motor de resolução subjacente, consulte o guia da SDK da CapSolver. A extensão da CapSolver ajuda a identificar os parâmetros de CAPTCHA durante o desenvolvimento.

Conclusão

O serviço MCP da CapSolver (capsolver-mcp) fornece o caminho mais rápido para resolver CAPTCHA em qualquer cliente de IA compatível com MCP. Instale, configure sua chave de API e todos os clientes no seu fluxo de trabalho ganham capacidade de resolução com nenhum código de integração. A CapSolver trata da resolução com inteligência artificial em nuvem enquanto o serviço MCP gerencia a descoberta de ferramentas, passagem de parâmetros e entrega de resultados através do protocolo padrão.

Perguntas Frequentes

Quais clientes de IA suportam o serviço MCP da CapSolver?

Qualquer cliente compatível com MCP: Claude Desktop, Claude Code, Cursor, Windsurf, Cline, VS Code com plugin Claude e qualquer cliente personalizado que implemente a especificação MCP. O transporte stdio funciona com clientes locais; SSE e streamable-http funcionam com clientes remotos/redes.

Preciso de um navegador para resolver CAPTCHA via MCP?

Apenas para as ferramentas detect_captchas e solve_on_page. A ferramenta principal solve_captcha funciona no modo Token — nenhum navegador é necessário. Instale o extra [browser] apenas se precisar de detecção automática de página e preenchimento.

Múltiplos clientes podem compartilhar uma instância do serviço MCP?

Com transporte SSE ou streamable-http, sim. Inicie o serviço em uma porta de rede e múltiplos clientes podem se conectar simultaneamente. As chamadas de ferramentas de cada cliente são tratadas independentemente.

O que acontece se o serviço MCP perder a conexão?

Os clientes MCP lidam com reconexão automaticamente. Se o serviço reiniciar, o cliente redescobre as ferramentas na reconexão. Solicitações de resolução em andamento podem falhar e precisar de retry do lado do cliente.