# Servidor MCP de web scraping com OAuth | QuantumProxies.io

Servidor MCP de web scraping para Claude, Cursor e qualquer cliente MCP. Entre com OAuth 2.1, sem colar chave de API, e use 29 ferramentas de scraping e crawl.

## Servidor MCP para web scraping e agentes de IA

O servidor MCP da QuantumProxies.io dá ao Claude, ao Cursor e a qualquer cliente MCP 29 ferramentas para fazer scraping, pesquisar, mapear e rastrear a web em tempo real através de proxies residenciais. Adicione https://api.quantumproxies.io/mcp a um cliente com início de sessão OAuth, entre na sua conta e clique em Allow access. Nenhuma chave de API para copiar.

- Início de sessão OAuth 2.1
- Gratuito, paga apenas o uso da API
- 29 ferramentas
- Qualquer cliente MCP

## Ligue com OAuth em quatro passos

Para clientes MCP com início de sessão OAuth, o fluxo de autorização definido na especificação MCP.

1. **Adicione o URL do servidor**: Cole https://api.quantumproxies.io/mcp no seu cliente, por exemplo como conector personalizado no Claude.
2. **Inicie sessão**: O cliente abre a página de início de sessão da QuantumProxies.io. Entre na sua conta ou crie uma conta gratuita.
3. **Autorize o acesso**: Uma página de consentimento pede a sua confirmação. Clique em Allow access e o cliente fica ligado.
4. **Peça ao seu agente**: As 29 ferramentas ficam disponíveis de imediato. O uso é cobrado ao saldo da sua conta, como com qualquer chave de API.

Cada ligação recebe a sua própria chave de API, com o nome MCP · \<client name>, na página de chaves de API do seu painel. Apague essa chave e o cliente é desligado.

## OAuth ou chave de API?

Ambos usam o mesmo endpoint e as mesmas 29 ferramentas.

### Início de sessão OAuth

Para apps de chat e clientes de desktop. Nada para copiar nem guardar: o cliente mantém tokens de curta duração e cada ligação aparece como uma chave própria, que pode apagar.

### Chave de API

Para scripts, CI e agentes headless, e para o pacote npx local. Envie uma chave qp_live_ como Authorization: Bearer ou X-Api-Key para o endpoint alojado, ou defina QUANTUMPROXIES_API_KEY para o servidor local.

## Skills para agentes de IA

Cinco ficheiros SKILL.md ensinam o Claude Code, o Claude.ai, o Codex, o Cursor, o Gemini CLI e qualquer agente que leia o formato aberto Agent Skills a usar o QuantumProxies.io corretamente. Instale-os uma vez; o agente carrega o certo quando a tarefa o exige.

Instalação com um comando: `npx skills add https://quantumproxies.io`. Funciona com a CLI skills em mais de 70 agentes. O Claude Code também carrega uma pasta de skill copiada para ~/.claude/skills; Codex, Cursor e Gemini CLI leem ~/.agents/skills.

- [`use-data-api`](https://quantumproxies.io/.well-known/agent-skills/use-data-api/SKILL.md): Chamar a Data API REST: autenticação, envelope de resposta, jobs assíncronos, referências
- [`use-mcp-server`](https://quantumproxies.io/.well-known/agent-skills/use-mcp-server/SKILL.md): Ligar qualquer cliente MCP: endpoint OAuth alojado ou pacote npm local, presets de ferramentas
- [`scrape-to-markdown`](https://quantumproxies.io/.well-known/agent-skills/scrape-to-markdown/SKILL.md): De um URL a Markdown limpo ou campos estruturados; batch, map e crawl para muitas páginas
- [`generate-proxies`](https://quantumproxies.io/.well-known/agent-skills/generate-proxies/SKILL.md): Strings de proxy a partir dos seus planos: geo-targeting, sessões sticky, whitelists de IP
- [`find-business-leads`](https://quantumproxies.io/.well-known/agent-skills/find-business-leads/SKILL.md): Listas de empresas e datasets: Collectors, AI Places Finder, construtor de datasets

[Índice de descoberta (/.well-known/agent-skills/)](https://quantumproxies.io/.well-known/agent-skills/index.json) · [Código-fonte e plugin para Claude Code no GitHub](https://github.com/quantumproxies/quantumproxies-skills)

O endpoint alojado segue a parte de autorização da especificação MCP: é um recurso protegido OAuth 2.1, e um pedido sem credenciais recebe uma resposta 401 que indica ao cliente onde iniciar sessão. As chaves continuam a funcionar no mesmo URL, por isso nada deixa de funcionar nas configurações existentes.

## URL do servidor MCP remoto e descoberta

O servidor alojado está em https://api.quantumproxies.io/mcp e usa Streamable HTTP. Publica os metadados de recurso protegido OAuth (RFC 9728) em https://api.quantumproxies.io/.well-known/oauth-protected-resource/mcp, que indicam https://app.quantumproxies.io como servidor de autorização. Esse servidor publica os seus próprios metadados (RFC 8414) em /.well-known/oauth-authorization-server. Um cliente que implemente a autorização MCP encontra tudo isto sozinho, a partir da resposta 401.

## Como é protegido o início de sessão OAuth 2.1

PKCE com o método S256 é obrigatório em todas as autorizações. Os clientes podem registar-se através de Dynamic Client Registration (RFC 7591) ou identificar-se com um Client ID Metadata Document. Os access tokens duram uma hora; os refresh tokens duram 30 dias e são rodados a cada utilização. Os tokens ficam vinculados ao endpoint MCP com resource indicators (RFC 8707) e nunca são reencaminhados para outros serviços.

## Gerir e desligar clientes

Cada cliente que autoriza recebe uma chave de API dedicada, com o nome MCP · \<client name>, na página de chaves de API do seu painel. O uso é cobrado ao saldo da sua conta, como com qualquer outra chave de API. Apague a chave e esse cliente é desligado, enquanto os seus outros clientes e chaves continuam a funcionar.

## Ligar com uma chave de API

As chaves de API continuam a funcionar no mesmo endpoint: envie uma chave qp_live_ como Authorization: Bearer ou no cabeçalho X-Api-Key. O pacote local, npx -y quantumproxies-mcp, corre via stdio na sua máquina e lê a chave da variável de ambiente QUANTUMPROXIES_API_KEY. Use uma chave sempre que não houver um navegador para iniciar sessão: scripts, CI e agentes headless.

## As 29 ferramentas que o seu agente recebe

Pesquise, leia, rastreie e transforme a web em tempo real em contexto com fontes ou em linhas validadas. As ferramentas de longa duração expõem chamadas de estado, para que os agentes consultem o progresso sem descarregar os mesmos dados duas vezes.

- `scrape`: Um URL convertido em Markdown, HTML ou texto limpo através de um proxy residencial com a impressão TLS de um navegador real. Extração opcional para JSON estruturado com seletores CSS ou IA.
- `search`: Resultados estruturados do Google, Bing ou DuckDuckGo, incluindo verticais específicas de cada motor, blocos enriquecidos e metadados de paginação.
- `search_and_read`: Pesquisa a web em tempo real, obtém as principais fontes e devolve contexto pronto a citar, dentro do orçamento de tokens do seu agente.
- `read_video`: Lê um vídeo do YouTube como uma única cronologia: metadados, capítulos, a transcrição na língua falada e pequenos fotogramas onde quem fala aponta para o ecrã, diz um preço ou abre um capítulo.
- `map`: Descobre os URLs de um site em segundos a partir dos sitemaps e dos links da página inicial, para encontrar as páginas certas antes do scraping, sem um rastreamento completo.
- `crawl` + `crawl_status`: Rastreamento assíncrono a partir de um URL inicial, com cada página convertida em Markdown. Filtros de inclusão e exclusão, controlo de profundidade e progresso com crawl_status.
- `batch` + `batch_status`: Scraping assíncrono de até 1.000 URLs com opções partilhadas e consulta de resultados incrementais por URL.
- `search_bulk` + `search_bulk_status`: Recolhe várias páginas de SERP de forma assíncrona, mantendo os enriquecimentos da primeira página e fundindo resultados orgânicos duplicados.
- `unlock`: Web Unlocker como ferramenta: repete qualquer pedido HTTP (método, cabeçalhos, corpo) por uma saída residencial, tenta de novo com um IP novo e escala um GET bloqueado para um browser real. Uma página ainda bloqueada volta assinalada, nunca como um 200 silencioso.
- `create_dataset` + `dataset_status`: Transforma um pedido em linguagem natural num dataset validado, com linhas incrementais e downloads CSV/JSON assinados.
- `seo_audit`: Compara a versão sem JS e a versão renderizada de uma página do ponto de vista SEO: diferenças de metadados, canonical, títulos, conteúdo e dados estruturados.
- `ai_visibility`: ChatGPT, Claude, Perplexity, Google AI Overview e Bing Copilot conseguem ler e citar uma página? Auditoria on-page pontuada por pilar, com bloqueios e correções, mais um painel opcional de citações que consulta os motores.
- `generate_parser` + `save_parser_preset` + `list_parser_presets` + `parser_preset_stats` + `heal_parser_preset`: Aprende uma vez, com um LLM, os seletores CSS de um layout de página e reutiliza-os depois como extração determinística gratuita. Cinco ferramentas geram, guardam, listam, avaliam e corrigem automaticamente os parsers quando um site muda.
- `list_collectors` + `run_collector` + `collector_run_status`: list_collectors, run_collector e collector_run_status: entradas semânticas como palavra-chave e localização em vez de URLs. Amazon, Google Maps, vagas do LinkedIn, lojas de apps e mais 70, cobrados por linha entregue.
- `list_proxies` + `generate_proxies` + `proxy_locations` + `whitelist_ip`: list_proxies, generate_proxies, proxy_locations e whitelist_ip dão ao agente endpoints de proxy prontos a usar de todos os tipos, com segmentação geográfica até à cidade, ao ISP ou ao ASN.
- `report`: Envie feedback à equipa a partir do agente: um bug, uma função ou um collector em falta, uma pergunta. Funciona sem chave de API.

## Perguntas Frequentes

### O que é o servidor MCP da QuantumProxies.io?

É um servidor Model Context Protocol gratuito que liga a Scraper API da QuantumProxies.io ao Claude, ao Cursor e a qualquer cliente MCP. O seu agente recebe 29 ferramentas para fazer scraping, pesquisar, mapear e rastrear a web através de proxies residenciais com impressões TLS de navegadores reais. Use o endpoint alojado com início de sessão OAuth ou execute o pacote npx localmente.

### O servidor MCP suporta OAuth?

Sim. O endpoint alojado em https://api.quantumproxies.io/mcp suporta início de sessão OAuth 2.1, conforme definido na especificação de autorização MCP. Adicione o URL a um cliente com início de sessão OAuth, entre na QuantumProxies.io e clique em Allow access. PKCE é obrigatório, os access tokens duram uma hora e os refresh tokens são rodados.

### Como ligo o servidor MCP ao Claude?

No Claude, adicione https://api.quantumproxies.io/mcp como conector personalizado e inicie sessão quando a página da QuantumProxies.io abrir. No Claude Code, execute claude mcp add --transport http quantumproxies https://api.quantumproxies.io/mcp e depois /mcp para iniciar sessão. O Claude Desktop também pode executar o pacote npx local com uma chave de API.

### Como desligo um cliente?

Abra a página de chaves de API do seu painel. Cada cliente ligado com OAuth tem a sua própria chave, com o nome MCP · \<client name>. Apague essa chave e o cliente perde o acesso; os seus outros clientes e chaves de API não são afetados. Para o voltar a ligar, adicione o URL do servidor e inicie sessão novamente.

### Ainda posso usar uma chave de API?

Sim. Envie uma chave qp_live_ como Authorization: Bearer ou X-Api-Key para https://api.quantumproxies.io/mcp, ou execute o pacote local com npx -y quantumproxies-mcp e a variável de ambiente QUANTUMPROXIES_API_KEY. Uma chave é a opção mais simples para scripts, CI e agentes headless, onde não há um navegador para iniciar sessão.

### Quanto custa?

O servidor MCP em si é gratuito. Paga apenas os preços pay-as-you-go habituais pelas chamadas à API que ele faz, às mesmas tarifas que chamar a Scraper API diretamente, cobrados ao saldo da sua conta, quer se ligue com OAuth quer com uma chave. As contas novas recebem créditos gratuitos para testar, sem cartão de crédito.

### Existe um servidor MCP remoto ou só o pacote local?

Ambos. O endpoint alojado em https://api.quantumproxies.io/mcp usa Streamable HTTP para clientes que preferem um URL, com início de sessão OAuth ou chave de API, e expõe as mesmas 29 ferramentas. O pacote npx corre na sua máquina via stdio e autentica-se com a sua chave de API.

### Onde é executado? Têm acesso aos meus dados?

O pacote local corre na sua máquina via npx e comunica com a API pública da QuantumProxies.io usando a sua própria chave qp_live_: sem segredos internos no pacote e sem salto adicional. O endpoint alojado faz as mesmas chamadas à API com a chave associada à sua ligação; os tokens OAuth nunca são reencaminhados para outros serviços.

### Que clientes MCP são suportados?

Qualquer cliente que fale o Model Context Protocol. Os clientes que se ligam a servidores remotos via Streamable HTTP e suportam início de sessão OAuth usam o URL alojado; clientes stdio como Claude Desktop, Claude Code, Cursor, Windsurf, VS Code e Zed podem executar o pacote local com o mesmo JSON de cinco linhas.

### Que ferramentas recebe o meu agente?

Vinte e nove ferramentas: scrape, unlock, seo_audit, ai_visibility, search, search_and_read, read_video, map, crawl e batch com consulta de estado, search_bulk e create_dataset com as suas ferramentas de estado, generate_parser com quatro ferramentas de presets com autocorreção, três ferramentas Collector sobre os scrapers prontos a usar, quatro ferramentas de proxy para endpoints, segmentação geográfica e listas de IPs autorizados, e report para enviar feedback à equipa.

### Porque não deixar o agente obter as páginas sozinho?

Os pedidos HTTP simples de um agente são bloqueados por sistemas anti-bot precisamente nas páginas que valem a pena ler. O servidor MCP encaminha cada pedido por IPs residenciais com impressões TLS de nível navegador, nova tentativa automática em caso de bloqueio e recurso a um navegador stealth, para que o agente leia a página real e não um captcha.

## Produtos relacionados

- [Extract API: qualquer página em Markdown ou JSON](https://quantumproxies.io/pt/extract-api)
- [Dados web para LLMs e RAG](https://quantumproxies.io/pt/web-data-for-llms)
- [SERP API para Google, Bing e DuckDuckGo](https://quantumproxies.io/pt/serp-api)
- [Web Unlocker para sites protegidos contra bots](https://quantumproxies.io/pt/web-unlocker)
- [Proxies residenciais](https://quantumproxies.io/pt/residential-proxies)

## Sources

- [What is the Model Context Protocol (MCP)?](https://modelcontextprotocol.io/docs/2026-07-28/getting-started/intro)
- [Model Context Protocol Specification](https://modelcontextprotocol.io/specification/2025-06-18)
- [Introducing the Model Context Protocol (Anthropic)](https://www.anthropic.com/news/model-context-protocol)
- [modelcontextprotocol/modelcontextprotocol (GitHub)](https://github.com/modelcontextprotocol/modelcontextprotocol)
- [Model Context Protocol (Wikipedia)](https://en.wikipedia.org/wiki/Model_Context_Protocol)
