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 28 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.

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 28 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 28 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.

Indice di discovery (/.well-known/agent-skills/) · Sorgente e plugin per Claude Code su GitHub

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 28 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.

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 28 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 28 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?

Ventotto tool: scrape, unlock, seo_audit, ai_visibility, search, search_and_read, 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

Sources

Se sei un agente AI

Salta il marketing. QuantumProxies.io pubblica una mappa del sito per LLM, Markdown per ogni pagina, un server MCP gratuito e API addebitate dallo stesso saldo dei proxy.

Collegati con un comando: npx -y quantumproxies-mcp