# Web Scraping MCP-Server mit OAuth | QuantumProxies.io

Web Scraping MCP-Server für Claude, Cursor und jeden MCP-Client. Anmeldung per OAuth 2.1, kein API-Key zum Einfügen, 29 Tools für Scraping, Suche und Crawl.

## MCP-Server für Web Scraping und KI-Agenten

Der MCP-Server von QuantumProxies.io gibt Claude, Cursor und jedem MCP-Client 29 Tools, um das Live-Web über Residential Proxies zu scrapen, zu durchsuchen, zu mappen und zu crawlen. Fügen Sie https://api.quantumproxies.io/mcp in einem Client mit OAuth-Anmeldung hinzu, melden Sie sich an und klicken Sie auf „Allow access“. Kein API-Key zum Kopieren.

- Anmeldung per OAuth 2.1
- Kostenlos, Sie zahlen nur die API-Nutzung
- 29 Tools
- Jeder MCP-Client

## In vier Schritten per OAuth verbinden

Für MCP-Clients mit OAuth-Anmeldung, nach dem Autorisierungsablauf der MCP-Spezifikation.

1. **Server-URL hinzufügen**: Fügen Sie https://api.quantumproxies.io/mcp in Ihren Client ein, zum Beispiel als benutzerdefinierten Connector in Claude.
2. **Anmelden**: Der Client öffnet die Anmeldeseite von QuantumProxies.io. Melden Sie sich an oder erstellen Sie ein kostenloses Konto.
3. **Zugriff erlauben**: Ein Zustimmungsdialog bittet um Bestätigung. Klicken Sie auf „Allow access“, und der Client ist verbunden.
4. **Agent fragen**: Die 29 Tools stehen sofort bereit. Die Nutzung wird wie bei jedem API-Key über Ihr Kontoguthaben abgerechnet.

Jede Verbindung erhält einen eigenen API-Key mit dem Namen MCP · \<client name> auf der Seite API-Keys in Ihrem Dashboard. Löschen Sie diesen Key, wird der Client getrennt.

## OAuth oder API-Key?

Beide führen zum selben Endpunkt und zu denselben 29 Tools.

### OAuth-Anmeldung

Für Chat-Apps und Desktop-Clients. Nichts zu kopieren oder zu speichern: Der Client verwaltet kurzlebige Tokens, und jede Verbindung erscheint als eigener Key, den Sie löschen können.

### API-Key

Für Skripte, CI und Headless-Agenten sowie für das lokale npx-Paket. Senden Sie einen qp_live_-Key als Authorization: Bearer oder X-Api-Key an den gehosteten Endpunkt, oder setzen Sie QUANTUMPROXIES_API_KEY für den lokalen Server.

## Skills für KI-Agenten

Fünf SKILL.md-Dateien bringen Claude Code, Claude.ai, Codex, Cursor, Gemini CLI und jedem Agenten, der das offene Agent-Skills-Format liest, bei, QuantumProxies.io richtig zu nutzen. Einmal installieren; der Agent lädt die passende, wenn die Aufgabe sie braucht.

Installation mit einem Befehl: `npx skills add https://quantumproxies.io`. Funktioniert mit der skills-CLI in über 70 Agenten. Claude Code lädt auch einen nach ~/.claude/skills kopierten Skill-Ordner; Codex, Cursor und Gemini CLI lesen ~/.agents/skills.

- [`use-data-api`](https://quantumproxies.io/.well-known/agent-skills/use-data-api/SKILL.md): Die REST Data API aufrufen: Authentifizierung, Antwort-Envelope, asynchrone Jobs, Referenzen
- [`use-mcp-server`](https://quantumproxies.io/.well-known/agent-skills/use-mcp-server/SKILL.md): Jeden MCP-Client verbinden: gehosteter OAuth-Endpunkt oder lokales npm-Paket, Tool-Presets
- [`scrape-to-markdown`](https://quantumproxies.io/.well-known/agent-skills/scrape-to-markdown/SKILL.md): Von einer URL zu sauberem Markdown oder strukturierten Feldern; batch, map und crawl für viele Seiten
- [`generate-proxies`](https://quantumproxies.io/.well-known/agent-skills/generate-proxies/SKILL.md): Proxy-Strings aus Ihren Plänen: Geo-Targeting, Sticky Sessions, IP-Whitelists
- [`find-business-leads`](https://quantumproxies.io/.well-known/agent-skills/find-business-leads/SKILL.md): Firmenlisten und Datasets: Collectors, AI Places Finder, Dataset-Builder

[Discovery-Index (/.well-known/agent-skills/)](https://quantumproxies.io/.well-known/agent-skills/index.json) · [Quellcode und Claude-Code-Plugin auf GitHub](https://github.com/quantumproxies/quantumproxies-skills)

Der gehostete Endpunkt folgt dem Autorisierungsteil der MCP-Spezifikation: Er ist eine per OAuth 2.1 geschützte Ressource, und eine Anfrage ohne Zugangsdaten erhält eine 401-Antwort, die dem Client mitteilt, wo er sich anmelden kann. Keys funktionieren weiterhin unter derselben URL, bestehende Setups laufen also unverändert weiter.

## URL und Discovery des Remote-MCP-Servers

Der gehostete Server ist unter https://api.quantumproxies.io/mcp erreichbar und spricht Streamable HTTP. Er veröffentlicht Metadaten als OAuth Protected Resource (RFC 9728) unter https://api.quantumproxies.io/.well-known/oauth-protected-resource/mcp, die https://app.quantumproxies.io als Autorisierungsserver benennen. Dieser Server veröffentlicht eigene Metadaten (RFC 8414) unter /.well-known/oauth-authorization-server. Ein Client mit MCP-Autorisierung findet all das selbstständig, ausgehend von der 401-Antwort.

## Wie die Anmeldung per OAuth 2.1 abgesichert ist

PKCE mit der Methode S256 ist bei jeder Autorisierung Pflicht. Clients können sich über Dynamic Client Registration (RFC 7591) registrieren oder sich mit einem Client ID Metadata Document ausweisen. Access Tokens gelten eine Stunde; Refresh Tokens gelten 30 Tage und werden bei jeder Nutzung rotiert. Tokens sind per Resource Indicators (RFC 8707) an den MCP-Endpunkt gebunden und werden nie an andere Dienste weitergegeben.

## Clients verwalten und trennen

Jeder Client, den Sie zulassen, erhält einen eigenen API-Key mit dem Namen MCP · \<client name> auf der Seite API-Keys in Ihrem Dashboard. Seine Nutzung wird wie bei jedem anderen API-Key über Ihr Kontoguthaben abgerechnet. Löschen Sie den Key, ist dieser Client getrennt, während Ihre übrigen Clients und Keys weiter funktionieren.

## Alternativ mit einem API-Key verbinden

API-Keys funktionieren weiterhin am selben Endpunkt: Senden Sie einen qp_live_-Key als Authorization: Bearer oder im Header X-Api-Key. Das lokale Paket, npx -y quantumproxies-mcp, läuft über stdio auf Ihrem Rechner und liest den Key aus der Umgebungsvariable QUANTUMPROXIES_API_KEY. Nutzen Sie einen Key überall dort, wo kein Browser für die Anmeldung zur Verfügung steht: in Skripten, CI und Headless-Agenten.

## 29 Tools für Ihren Agenten

Suchen, lesen, crawlen und das Live-Web in belegten Kontext oder validierte Datensätze verwandeln. Lang laufende Tools bieten Status-Abfragen, damit Agenten pollen können, ohne dieselben Daten zweimal herunterzuladen.

- `scrape`: Eine URL als sauberes Markdown, HTML oder Text, abgerufen über einen Residential Proxy mit echtem Browser-TLS-Fingerprint. Optional Extraktion per CSS-Selektor oder KI in strukturiertes JSON.
- `search`: Strukturierte Ergebnisse von Google, Bing oder DuckDuckGo, einschließlich suchmaschinenspezifischer Verticals, Rich Blocks und Paginierungs-Metadaten.
- `search_and_read`: Durchsucht das Live-Web, ruft die wichtigsten Quellen ab und liefert zitierfähigen Kontext, zugeschnitten auf das Token-Budget Ihres Agenten.
- `read_video`: Liest ein YouTube-Video als eine einzige Zeitleiste: Metadaten, Kapitel, das Transkript in der gesprochenen Sprache und kleine Frames dort, wo der Sprecher auf den Bildschirm zeigt, einen Preis nennt oder ein Kapitel beginnt.
- `map`: Ermittelt die URLs einer Website in Sekunden aus Sitemaps und Links der Startseite, um vor dem Scraping die richtigen Seiten zu finden, ohne vollständigen Crawl.
- `crawl` + `crawl_status`: Asynchroner Crawl ab einer Start-URL, jede Seite in Markdown umgewandelt. Include- und Exclude-Filter, Tiefensteuerung, Fortschritt über crawl_status.
- `batch` + `batch_status`: Bis zu 1.000 URLs asynchron mit gemeinsamen Optionen scrapen und die Ergebnisse pro URL fortlaufend abfragen.
- `search_bulk` + `search_bulk_status`: Mehrere SERP-Seiten asynchron erfassen, die Anreicherungen der ersten Seite behalten und doppelte organische Ergebnisse zusammenführen.
- `unlock`: Web Unlocker als Tool: Wiederholt jede HTTP-Anfrage (Methode, Header, Body) über einen Residential-Exit, versucht es mit einer frischen IP erneut und eskaliert ein blockiertes GET an einen echten Browser. Eine weiterhin blockierte Seite kommt markiert zurück, nie als stilles 200.
- `create_dataset` + `dataset_status`: Verwandelt eine Anfrage in natürlicher Sprache in einen validierten Datensatz mit fortlaufend gelieferten Zeilen und signierten CSV/JSON-Downloads.
- `seo_audit`: Vergleicht die SEO-Ansicht einer Seite ohne JavaScript mit der gerenderten: Unterschiede bei Metadaten, Canonical, Überschriften, Inhalt und strukturierten Daten.
- `ai_visibility`: Können ChatGPT, Claude, Perplexity, Google AI Overview und Bing Copilot eine Seite lesen und zitieren? On-Page-Audit mit Punktzahl pro Säule, Blockern und Korrekturen, plus ein optionales Zitationspanel, das die Engines befragt.
- `generate_parser` + `save_parser_preset` + `list_parser_presets` + `parser_preset_stats` + `heal_parser_preset`: Lernt die CSS-Selektoren für ein Seitenlayout einmalig mit einem LLM und nutzt sie danach als kostenlose, deterministische Extraktion. Fünf Tools erzeugen, speichern, listen, bewerten und reparieren Parser selbstständig, wenn sich eine Website ändert.
- `list_collectors` + `run_collector` + `collector_run_status`: list_collectors, run_collector und collector_run_status: semantische Eingaben wie Keyword und Standort statt URLs. Amazon, Google Maps, LinkedIn-Jobs, App Stores und 70 weitere, abgerechnet pro gelieferter Zeile.
- `list_proxies` + `generate_proxies` + `proxy_locations` + `whitelist_ip`: list_proxies, generate_proxies, proxy_locations und whitelist_ip geben dem Agenten einsatzbereite Proxy-Endpunkte jedes Typs, mit Geo-Targeting bis auf Stadt, ISP oder ASN.
- `report`: Feedback aus dem Agenten heraus an das Team senden: ein Bug, ein fehlendes Feature oder ein fehlender Collector, eine Frage. Funktioniert ohne API-Key.

## Häufig gestellte Fragen

### Was ist der MCP-Server von QuantumProxies.io?

Ein kostenloser Model-Context-Protocol-Server, der die Scraper API von QuantumProxies.io mit Claude, Cursor und jedem MCP-Client verbindet. Ihr Agent erhält 29 Tools, um das Web über Residential Proxies mit echten Browser-TLS-Fingerprints zu scrapen, zu durchsuchen, zu mappen und zu crawlen. Nutzen Sie den gehosteten Endpunkt mit OAuth-Anmeldung oder das npx-Paket lokal.

### Unterstützt der MCP-Server OAuth?

Ja. Der gehostete Endpunkt unter https://api.quantumproxies.io/mcp unterstützt die Anmeldung per OAuth 2.1 gemäß der MCP-Autorisierungsspezifikation. Fügen Sie die URL in einem Client mit OAuth-Anmeldung hinzu, melden Sie sich bei QuantumProxies.io an und klicken Sie auf „Allow access“. PKCE ist Pflicht, Access Tokens gelten eine Stunde, Refresh Tokens werden rotiert.

### Wie verbinde ich den MCP-Server mit Claude?

Fügen Sie in Claude https://api.quantumproxies.io/mcp als benutzerdefinierten Connector hinzu und melden Sie sich an, sobald sich die Seite von QuantumProxies.io öffnet. In Claude Code führen Sie claude mcp add --transport http quantumproxies https://api.quantumproxies.io/mcp aus und melden sich dann über /mcp an. Claude Desktop kann auch das lokale npx-Paket mit einem API-Key nutzen.

### Wie trenne ich einen Client?

Öffnen Sie die Seite API-Keys in Ihrem Dashboard. Jeder per OAuth verbundene Client hat einen eigenen Key mit dem Namen MCP · \<client name>. Löschen Sie diesen Key, verliert der Client den Zugriff; Ihre übrigen Clients und API-Keys bleiben davon unberührt. Um ihn erneut zu verbinden, fügen Sie die Server-URL hinzu und melden sich noch einmal an.

### Kann ich weiterhin einen API-Key verwenden?

Ja. Senden Sie einen qp_live_-Key als Authorization: Bearer oder X-Api-Key an https://api.quantumproxies.io/mcp, oder starten Sie das lokale Paket mit npx -y quantumproxies-mcp und der Umgebungsvariable QUANTUMPROXIES_API_KEY. Für Skripte, CI und Headless-Agenten, bei denen kein Browser zur Anmeldung bereitsteht, ist ein Key die einfachere Wahl.

### Was kostet der MCP-Server?

Der MCP-Server selbst ist kostenlos. Sie zahlen nur die regulären Pay-as-you-go-Preise für die API-Aufrufe, die er ausführt, zu denselben Tarifen wie bei direkten Aufrufen der Scraper API, abgerechnet über Ihr Kontoguthaben, egal ob Sie per OAuth oder mit Key verbinden. Neue Konten erhalten Gratis-Guthaben zum Testen, ohne Kreditkarte.

### Gibt es einen Remote-MCP-Server oder nur das lokale Paket?

Beides. Der gehostete Endpunkt unter https://api.quantumproxies.io/mcp spricht Streamable HTTP für Clients, die eine URL bevorzugen, mit OAuth-Anmeldung oder API-Key, und stellt dieselben 29 Tools bereit. Das npx-Paket läuft über stdio auf Ihrem Rechner und authentifiziert sich mit Ihrem API-Key.

### Wo läuft der Server? Sehen Sie meine Daten?

Das lokale Paket läuft per npx auf Ihrem Rechner und spricht mit Ihrem eigenen qp_live_-Key direkt die öffentliche API von QuantumProxies.io an: keine internen Secrets im Paket, kein zusätzlicher Zwischenschritt. Der gehostete Endpunkt führt dieselben API-Aufrufe mit dem Key Ihrer Verbindung aus; OAuth-Tokens werden nie an andere Dienste weitergegeben.

### Welche MCP-Clients werden unterstützt?

Jeder Client, der das Model Context Protocol spricht. Clients, die sich über Streamable HTTP mit Remote-Servern verbinden und die OAuth-Anmeldung unterstützen, nutzen die gehostete URL; stdio-Clients wie Claude Desktop, Claude Code, Cursor, Windsurf, VS Code und Zed können das lokale Paket mit derselben fünfzeiligen JSON-Konfiguration ausführen.

### Welche Tools erhält mein Agent?

Neunundzwanzig Tools: scrape, unlock, seo_audit, ai_visibility, search, search_and_read, read_video, map, crawl und batch mit Status-Abfrage, search_bulk und create_dataset mit ihren Status-Tools, generate_parser mit vier selbstheilenden Preset-Tools, drei Collector-Tools für die fertigen Scraper, vier Proxy-Tools für Endpunkte, Geo-Targeting und IP-Whitelists sowie report, um dem Team Feedback zu senden.

### Warum ruft der Agent die Seiten nicht einfach selbst ab?

Einfache HTTP-Abrufe eines Agenten werden von Anti-Bot-Systemen genau auf den Seiten blockiert, die sich zu lesen lohnen. Der MCP-Server leitet jede Anfrage über Residential IPs mit TLS-Fingerprints auf Browser-Niveau, mit automatischem Retry bei Blockierung und einem Stealth-Browser als Fallback. So liest der Agent die echte Seite statt eines Captchas.

## Verwandte Produkte

- [Extract API: jede Seite als Markdown oder JSON](https://quantumproxies.io/de/extract-api)
- [Webdaten für LLMs und RAG](https://quantumproxies.io/de/web-data-for-llms)
- [SERP API für Google, Bing und DuckDuckGo](https://quantumproxies.io/de/serp-api)
- [Web Unlocker für botgeschützte Websites](https://quantumproxies.io/de/web-unlocker)
- [Residential Proxies](https://quantumproxies.io/de/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)
