MCP para agentes de IA

CapMonster Cloud MCP — Deixe agentes de IA resolverem CAPTCHA automaticamente.

Conecte o CapMonster Cloud a um agente de IA e automatize a resolução de CAPTCHA, desde a coleta de parâmetros até a verificação do resultado. O agente pode devolver a lógica funcional ao seu projeto.

Comece em poucos minutos com um prompt pronto para usar.

Execute um prompt pronto no seu agente de IA

Um prompt pronto instala e configura o CapMonster Cloud MCP. Abra-o no Claude Code ou no Codex, ou copie-o para outro cliente compatível com MCP.

Configuração do servidor MCP Claude (Terminal)

Inicie a configuração no Claude Code a partir do terminal.

Configuração do servidor MCP Claude (VS Code)

Inicie a configuração na extensão Claude Code para VS Code.

Configuração do servidor MCP Codex

Inicie a configuração no OpenAI Codex.

Outros clientes compatíveis com MCP

Escolha um prompt npm ou PyPI e cole-o no seu cliente de IA. O PyPI precisa de Python 3.11+ e uv. A automação do navegador ainda usa Node.js. Se a configuração automática não estiver disponível, use a configuração manual.

Um agente de IA pode limitar ou rejeitar o MCP por causa dos próprios termos ou regras. Isso não significa que o MCP esteja quebrado. Consulte o guia de configuração e o guia de solução de problemas, ou experimente outro cliente compatível e siga as regras desse cliente.

Como conectar o CapMonster Cloud MCP

Obtenha uma chave de API
Crie uma conta CapMonster Cloud e copie sua chave de API.
Escolha como conectar
Abra o prompt no Claude Code ou no Codex, ou copie-o para outro cliente MCP.
Envie o prompt ao agente
O agente pede a chave de API e armazena em CM_API_KEY.
Verifique a instalação
Peça ao agente para verificar a configuração ou execute o comando /mcp.
Descreva a tarefa
Informe a URL da página, a ação que dispara o CAPTCHA e quaisquer condições de acesso extras.

Prefere instalar o MCP manualmente?

Se a configuração automática não for adequada, inicie os pacotes você mesmo. A configuração ainda depende do cliente.

npm / TypeScript

npx -y capmonster-mcp

Python 3.11+

uvx capmonster-mcp

Navegador

npx -y capmonster-mcp-patchright

Como funciona o CapMonster Cloud MCP

Da página até uma integração pronta — em uma sessão MCP: o agente identifica o CAPTCHA, coleta parâmetros, chama o CapMonster Cloud, verifica o resultado e prepara o código.

Agente de IA
1 . Identifica o CAPTCHA
O agente de IA abre a página pelo Patchright, encontra o desafio e determina o tipo de CAPTCHA.
Começando: abro a página com patchright e verifico o saldo do CapMonster Cloud.
Usadas 2 ferramentas >
Saldo disponível, navegador iniciado. Abro a página com CAPTCHA.
Patchright: navegar até a página >
Preciso encontrar o sitekey e os parâmetros do reCAPTCHA na página.
CAPTCHA
2 . Obtém os parâmetros da tarefa
Analisa a página e extrai o tipo de CAPTCHA, sitekey, URL e outros dados do widget para o CapMonster Cloud.
Resultado
Tipo de CAPTCHA e parâmetros:
reCAPTCHA v2 (caixa, "Não sou um robô"), nível de proteção: high
data-sitekey = 6Lcg7CHUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd
websiteURL = https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high
Widget em iframe google.com/recaptcha/api2/anchor – reCAPTCHA v2 padrão (não Enterprise e não invisible)
CapMonster
3 . Cria a tarefa e obtém o resultado
Envia os parâmetros ao CapMonster Cloud, cria uma tarefa e aguarda a resposta. O agente recebe o token automaticamente.
Crio uma tarefa no CapMonster Cloud: RecaptchaV2Task, sem proxy — o site é de acesso público.
Capmonster: criar tarefa >
Tarefa criada (ID 643066485). Aguardando a solução por até 1 min.
Capmonster: aguardar resultado da tarefa >
Token recebido. Inserindo em g-recaptcha-response , chamando o callback e enviando o formulário.
Lógica funcional
4 . Verifica o resultado e prepara o código
Aplica o token na página, confirma que o desafio passou e salva um exemplo de código para o projeto.
Token inserido. Verificando o valor e clicando em «Enviar».
Patchright: executar código na página >
Valor definido corretamente. Enviando o formulário.
CAPTCHA aprovado: o servidor retornou "success": true . Fecho o navegador e preparo um exemplo de código.
</>solve_recaptcha_v2.pyUndo+125-0>

O agente trabalha com o CapMonster Cloud e o navegador

Dois servidores MCP cobrem um fluxo de trabalho. O capmonster fala com a API. O patchright fala com a página.

capmonster

Trabalhar com o CapMonster Cloud

Carrega a documentação
Sugere parâmetros de tarefa
Cria tarefas
Retorna o resultado
Verifica o saldo e o User-Agent

patchright

Trabalhar com a página no navegador

Interage com a página
Detecta o tipo de CAPTCHA
Obtém parâmetros dinâmicos
Aplica o resultado
Verifica se a lógica funciona

Cenários de exemplo

Como um agente de IA ajuda no trabalho real com CAPTCHA.

Entender um novo CAPTCHA

Mostre a página ao agente — ele ajuda a identificar o tipo de CAPTCHA e os parâmetros necessários.

Verificar uma integração

O agente envia a tarefa, obtém o resultado e verifica na própria página.

Adicionar a resolução a um projeto

Após uma verificação bem-sucedida, o agente ajuda a transformar a lógica funcional em código.

Encontrar a causa de um erro

Ele verifica parâmetros, User-Agent, cookies, headers e outros dados de sessão.

Quais CAPTCHAs os agentes de IA resolvem com o CapMonster Cloud MCP

O CapMonster Cloud oferece suporte a muitos sistemas populares de proteção e verificação.

Trabalhar com MCP e sem ele

Os mesmos passos — encontrar parâmetros, escolher uma tarefa, aguardar o resultado e preparar a integração — passam pelas ferramentas MCP em vez do trabalho manual.

Sem MCP

O que o desenvolvedor faz manualmente

Encontrar parâmetros
Estuda o DevTools, as requisições e o código da página.
Escolher o tipo de tarefa
Aprende os tipos de CAPTCHA e estuda a documentação.
Aguardar o resultado
Implementa o polling do resultado e o tratamento da resposta.
Integrar ao projeto
Monta código funcional para o site e o ambiente.

Via MCP

O que o agente de IA faz com o CapMonster Cloud MCP

Obter parâmetros
Obtém os parâmetros necessários pelo MCP do navegador e pelo DevTools.
Escolher o tipo de tarefa
Escolhe o tipo de tarefa na lista get_supported_tasks.
Obter o resultado
get_task_result_wait aguarda automaticamente a resposta final.
Preparar a integração
Após uma verificação bem-sucedida, prepara o código para o seu projeto.

Vantagens do CapMonster Cloud MCP

Configuração rápida, menos trabalho manual e automação de CAPTCHA nos seus projetos e clientes de IA.

Menos trabalho manual

Não é preciso buscar parâmetros separadamente, conferir cada passo na documentação nem escrever polling de resultado só para a primeira verificação.

Menos código para integração

Automatize a integração da API: o agente chama as ferramentas CapMonster Cloud, obtém a lista de tarefas suportadas, cria uma tarefa e aguarda o resultado.

Trabalhe no cliente que você já conhece

Use o MCP em clientes de IA compatíveis sem uma integração separada para cada interface.

Uma única chave de API

O agente só precisa de CM_API_KEY para acessar o CapMonster Cloud. Quando o trabalho no navegador for necessário, ele se conecta por um servidor MCP separado.

Preços do CapMonster Cloud

Proxy incluído no preço: economize no CapMonster Cloud*

CAPTCHA	Preço (USD)	Sucesso
reCAPTCHA v2 99%	$ 0.04* 1000 imagens $ 0.60 1000 tokens	99%
reCAPTCHA v3 99%	$ 0.90 1000 tokens	99%
reCAPTCHA v2 Enterprise 97%	$ 0.04* 1000 imagens $ 1.00 1000 tokens	97%
reCAPTCHA v3 Enterprise 98%	$ 1.50 1000 tokens	98%
Cloudflare Turnstile 99%	$ 1.30 1000 tokens	99%
Cloudflare Bot Challenge 99%	$ 1.30 1000 tokens	99%
Amazon Waf 99%	$ 1.40 1000 tokens	99%
Tencent CAPTCHA 99%	$ 1.60 1000 tokens	99%
GeeTest 98%	$ 1.20 1000 tokens	98%
Yidun 95%	$ 1.00 1000 tokens	95%
Text CAPTCHA 99%	$ 0.30 1000 tokens	99%

Perguntas frequentes sobre o CapMonster Cloud MCP

O que é o CapMonster Cloud MCP e para que ele serve?

O CapMonster Cloud MCP conecta um agente de IA à resolução de CAPTCHA. O servidor capmonster trabalha com a API CapMonster Cloud: documentação, parâmetros de tarefa, criação de tarefa e resultado. O servidor patchright trabalha com o navegador: abre a página, lê parâmetros dinâmicos, aplica a solução e verifica se a página a aceitou.

Como instalar e conectar o CapMonster Cloud MCP?

Escolha um prompt pronto para Claude Code, Codex, npm ou PyPI e envie-o ao agente. O agente pede sua chave de API e armazena em CM_API_KEY. Você também pode iniciar os pacotes você mesmo com npx ou uvx.

Em que as versões do CapMonster Cloud MCP diferem?

npm / TypeScript roda com npx -y capmonster-mcp. PyPI roda com uvx capmonster-mcp e precisa de Python 3.11+ e uv. Ambos expõem as mesmas ferramentas de resolução. A automação do navegador usa o pacote npm capmonster-mcp-patchright e ainda precisa de Node.js.

Preciso usar os dois servidores MCP?

Os dois servidores são recomendados para um fluxo completo no navegador. O capmonster resolve a tarefa. O patchright abre a página, coleta parâmetros e verifica o resultado. Você pode usar o capmonster sozinho quando os parâmetros da página já forem conhecidos.

Saiba mais – na documentação oficial do CapMonster Cloud.