# Server MCP per web scraping con OAuth | QuantumProxies.io

Server MCP di web scraping per Claude, Cursor e ogni client MCP. Accesso con OAuth 2.1, nessuna API key da incollare e 29 tool per scraping, ricerca e crawl.

## Server MCP per il web scraping e gli agenti AI

Il server MCP di QuantumProxies.io dà a Claude, Cursor e a qualsiasi client MCP 29 tool per fare scraping, ricerche, mappature e crawl del web in tempo reale tramite proxy residenziali. Aggiungi https://api.quantumproxies.io/mcp a un client che supporta l'accesso OAuth, entra nel tuo account e fai clic su "Allow access". Nessuna API key da copiare.

- Accesso OAuth 2.1
- Gratis, paghi solo l'uso delle API
- 29 tool
- Qualsiasi client MCP

## Collegati con OAuth in quattro passaggi

Per i client MCP che supportano l'accesso OAuth, il flusso di autorizzazione definito nella specifica MCP.

1. **Aggiungi l'URL del server**: Incolla https://api.quantumproxies.io/mcp nel tuo client, ad esempio come connettore personalizzato in Claude.
2. **Accedi**: Il client apre la pagina di accesso di QuantumProxies.io. Entra con il tuo account o creane uno gratuito.
3. **Autorizza l'accesso**: Una schermata di consenso ti chiede conferma. Fai clic su "Allow access" e il client è collegato.
4. **Chiedi al tuo agente**: I 29 tool sono subito disponibili. L'utilizzo viene addebitato sul saldo del tuo account, come per qualsiasi API key.

Ogni connessione riceve una propria API key, chiamata MCP · \<client name>, nella pagina delle API key della dashboard. Elimina quella chiave e il client viene scollegato.

## OAuth o API key?

Entrambi puntano allo stesso endpoint e agli stessi 29 tool.

### Accesso OAuth

Per app di chat e client desktop. Niente da copiare o conservare: il client gestisce token a breve scadenza e ogni connessione compare come chiave a sé, che puoi eliminare.

### API key

Per script, CI e agenti headless, oltre che per il pacchetto npx locale. Invia una chiave qp_live_ come Authorization: Bearer o X-Api-Key all'endpoint ospitato, oppure imposta QUANTUMPROXIES_API_KEY per il server locale.

## Skill per agenti AI

Cinque file SKILL.md insegnano a Claude Code, Claude.ai, Codex, Cursor, Gemini CLI e a qualsiasi agente che legge il formato aperto Agent Skills come usare QuantumProxies.io nel modo giusto. Li installi una volta; l'agente carica quello giusto quando il compito lo richiede.

Installazione con un comando: `npx skills add https://quantumproxies.io`. Funziona con la CLI skills in più di 70 agenti. Claude Code carica anche una cartella skill copiata in ~/.claude/skills; Codex, Cursor e Gemini CLI leggono ~/.agents/skills.

- [`use-data-api`](https://quantumproxies.io/.well-known/agent-skills/use-data-api/SKILL.md): Chiamare la Data API REST: autenticazione, envelope di risposta, job asincroni, riferimenti
- [`use-mcp-server`](https://quantumproxies.io/.well-known/agent-skills/use-mcp-server/SKILL.md): Collegare qualsiasi client MCP: endpoint OAuth hosted o pacchetto npm locale, preset di tool
- [`scrape-to-markdown`](https://quantumproxies.io/.well-known/agent-skills/scrape-to-markdown/SKILL.md): Da un URL a Markdown pulito o campi strutturati; batch, map e crawl per molte pagine
- [`generate-proxies`](https://quantumproxies.io/.well-known/agent-skills/generate-proxies/SKILL.md): Stringhe proxy dai tuoi piani: geo-targeting, sessioni sticky, whitelist IP
- [`find-business-leads`](https://quantumproxies.io/.well-known/agent-skills/find-business-leads/SKILL.md): Liste di aziende e dataset: Collector, AI Places Finder, dataset builder

[Indice di discovery (/.well-known/agent-skills/)](https://quantumproxies.io/.well-known/agent-skills/index.json) · [Sorgente e plugin per Claude Code su GitHub](https://github.com/quantumproxies/quantumproxies-skills)

L'endpoint ospitato segue la parte sull'autorizzazione della specifica MCP: è una risorsa protetta OAuth 2.1 e una richiesta senza credenziali riceve una risposta 401 che indica al client dove effettuare l'accesso. Le chiavi continuano a funzionare sullo stesso URL, quindi le configurazioni esistenti non si rompono.

## URL del server MCP remoto e discovery

Il server ospitato si trova su https://api.quantumproxies.io/mcp e usa Streamable HTTP. Pubblica i metadati della risorsa protetta OAuth (RFC 9728) su https://api.quantumproxies.io/.well-known/oauth-protected-resource/mcp, che indicano https://app.quantumproxies.io come authorization server. Quel server pubblica a sua volta i propri metadati (RFC 8414) su /.well-known/oauth-authorization-server. Un client che implementa l'autorizzazione MCP trova tutto da solo, a partire dalla risposta 401.

## Come è protetto l'accesso OAuth 2.1

PKCE con metodo S256 è obbligatorio a ogni autorizzazione. I client possono registrarsi tramite Dynamic Client Registration (RFC 7591) o identificarsi con un Client ID Metadata Document. Gli access token durano un'ora; i refresh token durano 30 giorni e ruotano a ogni utilizzo. I token sono vincolati all'endpoint MCP tramite resource indicator (RFC 8707) e non vengono mai inoltrati ad altri servizi.

## Gestire e scollegare i client

Ogni client che autorizzi riceve una API key dedicata, chiamata MCP · \<client name>, nella pagina delle API key della dashboard. L'utilizzo viene addebitato sul saldo del tuo account, come per qualsiasi altra API key. Elimina la chiave e quel client viene scollegato, mentre gli altri client e le altre chiavi continuano a funzionare.

## Collegarsi con una API key

Le API key continuano a funzionare sullo stesso endpoint: invia una chiave qp_live_ come Authorization: Bearer o nell'header X-Api-Key. Il pacchetto locale, npx -y quantumproxies-mcp, gira via stdio sulla tua macchina e legge la chiave dalla variabile d'ambiente QUANTUMPROXIES_API_KEY. Usa una chiave ovunque non ci sia un browser per l'accesso: script, CI e agenti headless.

## I 29 tool a disposizione del tuo agente

Cerca, leggi, esegui crawl e trasforma il web in tempo reale in contesto con fonti verificabili o in righe validate. I tool di lunga durata espongono chiamate di stato, così l'agente può seguirne l'avanzamento senza scaricare due volte gli stessi dati.

- `scrape`: Un URL in Markdown, HTML o testo pulito, tramite proxy residenziale con fingerprint TLS da browser reale. Estrazione opzionale in JSON strutturato con selettori CSS o AI.
- `search`: Risultati strutturati di Google, Bing o DuckDuckGo, inclusi verticali specifici di ogni motore, blocchi rich e metadati di paginazione.
- `search_and_read`: Cerca nel web in tempo reale, recupera le fonti principali e restituisce contesto pronto da citare, entro il budget di token del tuo agente.
- `read_video`: Legge un video YouTube come un'unica timeline: metadati, capitoli, la trascrizione nella lingua in cui si parla e piccoli frame dove chi parla indica lo schermo, dice un prezzo o apre un capitolo.
- `map`: Individua in pochi secondi gli URL di un sito da sitemap e link della homepage, per trovare le pagine giuste prima dello scraping, senza un crawl completo.
- `crawl` + `crawl_status`: Crawl asincrono da un URL di partenza, con ogni pagina convertita in Markdown. Filtri di inclusione ed esclusione, controllo della profondità, avanzamento con crawl_status.
- `batch` + `batch_status`: Scraping asincrono fino a 1.000 URL con opzioni condivise e risultati incrementali per singolo URL, da interrogare man mano.
- `search_bulk` + `search_bulk_status`: Raccoglie in modo asincrono più pagine SERP, mantenendo gli arricchimenti della prima pagina e unendo i risultati organici duplicati.
- `unlock`: Web Unlocker come tool: ripete qualsiasi richiesta HTTP (metodo, header, body) da un'uscita residenziale, riprova con un IP nuovo e passa a un browser reale se una GET è bloccata. Una pagina ancora bloccata torna segnalata, mai come un 200 silenzioso.
- `create_dataset` + `dataset_status`: Trasforma una richiesta in linguaggio naturale in un dataset validato, con righe incrementali e download CSV/JSON firmati.
- `seo_audit`: Confronta la vista SEO no-JS e quella renderizzata di una pagina: differenze di metadati, canonical, heading, contenuto e dati strutturati.
- `ai_visibility`: ChatGPT, Claude, Perplexity, Google AI Overview e Bing Copilot riescono a leggere e citare una pagina? Audit on-page con punteggio per pilastro, blocchi e correzioni, più un pannello opzionale di citazioni che interroga i motori.
- `generate_parser` + `save_parser_preset` + `list_parser_presets` + `parser_preset_stats` + `heal_parser_preset`: Impara una volta i selettori CSS di un layout con un LLM, poi li riusa come estrazione deterministica gratuita. Cinque tool generano, salvano, elencano, valutano e riparano da soli i parser quando un sito cambia.
- `list_collectors` + `run_collector` + `collector_run_status`: list_collectors, run_collector e collector_run_status: input semantici come parola chiave e località al posto degli URL. Amazon, Google Maps, offerte di lavoro LinkedIn, app store e altri 70, addebitati per riga consegnata.
- `list_proxies` + `generate_proxies` + `proxy_locations` + `whitelist_ip`: list_proxies, generate_proxies, proxy_locations e whitelist_ip danno all'agente endpoint proxy pronti all'uso di ogni tipo, con targeting geografico fino a città, ISP o ASN.
- `report`: Invia un feedback al team dall'interno dell'agente: un bug, una funzione o un collector mancante, una domanda. Funziona senza API key.

## Domande Frequenti

### Cos'è il server MCP di QuantumProxies.io?

È un server Model Context Protocol gratuito che collega la Scraper API di QuantumProxies.io a Claude, Cursor e a qualsiasi client MCP. Il tuo agente ottiene 29 tool per fare scraping, ricerche, mappature e crawl del web tramite proxy residenziali con fingerprint TLS da browser reale. Usa l'endpoint ospitato con accesso OAuth o esegui il pacchetto npx in locale.

### Il server MCP supporta OAuth?

Sì. L'endpoint ospitato su https://api.quantumproxies.io/mcp supporta l'accesso OAuth 2.1 come definito nella specifica di autorizzazione MCP. Aggiungi l'URL a un client che supporta l'accesso OAuth, entra in QuantumProxies.io e fai clic su "Allow access". PKCE è obbligatorio, gli access token durano un'ora e i refresh token ruotano.

### Come collego il server MCP a Claude?

In Claude, aggiungi https://api.quantumproxies.io/mcp come connettore personalizzato ed effettua l'accesso quando si apre la pagina di QuantumProxies.io. In Claude Code, esegui claude mcp add --transport http quantumproxies https://api.quantumproxies.io/mcp, poi /mcp per accedere. Claude Desktop può anche eseguire il pacchetto npx locale con una API key.

### Come scollego un client?

Apri la pagina delle API key della dashboard. Ogni client collegato con OAuth ha una propria chiave, chiamata MCP · \<client name>. Elimina quella chiave e il client perde l'accesso; gli altri client e le altre API key non ne risentono. Per ricollegarlo, aggiungi di nuovo l'URL del server ed effettua l'accesso.

### Posso ancora usare una API key?

Sì. Invia una chiave qp_live_ come Authorization: Bearer o X-Api-Key a https://api.quantumproxies.io/mcp, oppure esegui il pacchetto locale con npx -y quantumproxies-mcp e la variabile d'ambiente QUANTUMPROXIES_API_KEY. Per script, CI e agenti headless, dove non c'è un browser per l'accesso, la chiave è la scelta più semplice.

### Quanto costa?

Il server MCP in sé è gratuito. Paghi solo le chiamate API che esegue, con le normali tariffe a consumo, le stesse della Scraper API chiamata direttamente, addebitate sul saldo del tuo account sia che ti colleghi con OAuth sia con una chiave. I nuovi account ricevono crediti gratuiti per provare, senza carta di credito.

### Esiste un server MCP remoto o solo il pacchetto locale?

Entrambi. L'endpoint ospitato su https://api.quantumproxies.io/mcp usa Streamable HTTP per i client che preferiscono un URL, con accesso OAuth o API key, ed espone gli stessi 29 tool. Il pacchetto npx gira invece sulla tua macchina via stdio e si autentica con la tua API key.

### Dove gira? Vedete i miei dati?

Il pacchetto locale gira sulla tua macchina via npx e comunica con l'API pubblica di QuantumProxies.io usando la tua chiave qp_live_: nessun segreto interno nel pacchetto e nessun passaggio intermedio. L'endpoint ospitato esegue le stesse chiamate API con la chiave legata alla tua connessione; i token OAuth non vengono mai inoltrati ad altri servizi.

### Quali client MCP sono supportati?

Qualsiasi client che parli il Model Context Protocol. I client che si collegano a server remoti via Streamable HTTP e supportano l'accesso OAuth usano l'URL ospitato; i client stdio come Claude Desktop, Claude Code, Cursor, Windsurf, VS Code e Zed possono eseguire il pacchetto locale con lo stesso JSON di cinque righe.

### Quali tool riceve il mio agente?

Ventinove tool: scrape, unlock, seo_audit, ai_visibility, search, search_and_read, read_video, map, crawl e batch con polling dello stato, search_bulk e create_dataset con i rispettivi tool di stato, generate_parser con quattro tool per preset che si riparano da soli, tre tool Collector sugli scraper pronti all'uso, quattro tool proxy per endpoint, targeting geografico e whitelist IP, e report per mandare un feedback al team.

### Perché non lasciare che l'agente scarichi le pagine da solo?

Le semplici richieste HTTP di un agente vengono bloccate dai sistemi anti-bot proprio sulle pagine che vale la pena leggere. Il server MCP instrada ogni richiesta attraverso IP residenziali con fingerprint TLS di livello browser, retry automatico in caso di blocco e fallback su browser stealth, così l'agente legge la pagina vera, non un captcha.

## Prodotti correlati

- [Extract API: qualsiasi pagina in Markdown o JSON](https://quantumproxies.io/it/extract-api)
- [Dati web per LLM e RAG](https://quantumproxies.io/it/web-data-for-llms)
- [SERP API per Google, Bing e DuckDuckGo](https://quantumproxies.io/it/serp-api)
- [Web Unlocker per siti protetti da bot](https://quantumproxies.io/it/web-unlocker)
- [Proxy residenziali](https://quantumproxies.io/it/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)
