# Serwer MCP do web scrapingu z OAuth | QuantumProxies.io

Serwer MCP do web scrapingu dla Claude, Cursor i każdego klienta MCP. Logowanie OAuth 2.1 bez wklejania klucza API. 29 narzędzi: scrape, search, map, crawl.

## Serwer MCP do web scrapingu i agentów AI

Serwer MCP QuantumProxies.io daje Claude, Cursor i każdemu klientowi MCP 29 narzędzi do scrapowania, wyszukiwania, mapowania i crawlowania aktualnej sieci przez proxy rezydencjalne. Dodaj https://api.quantumproxies.io/mcp w kliencie obsługującym logowanie OAuth, zaloguj się na swoje konto i kliknij „Allow access”. Żadnego klucza API do kopiowania.

- Logowanie przez OAuth 2.1
- Za darmo, płacisz tylko za użycie API
- 29 narzędzi
- Dowolny klient MCP

## Połączenie przez OAuth w czterech krokach

Dla klientów MCP obsługujących logowanie OAuth, zgodnie z przepływem autoryzacji ze specyfikacji MCP.

1. **Dodaj URL serwera**: Wklej https://api.quantumproxies.io/mcp w swoim kliencie, na przykład jako własny konektor w Claude.
2. **Zaloguj się**: Klient otwiera stronę logowania QuantumProxies.io. Zaloguj się albo załóż darmowe konto.
3. **Zezwól na dostęp**: Ekran zgody poprosi o potwierdzenie. Kliknij „Allow access” i klient jest połączony.
4. **Zapytaj agenta**: 29 narzędzi jest dostępnych od razu. Użycie jest rozliczane z salda konta, tak jak przy każdym kluczu API.

Każde połączenie dostaje własny klucz API o nazwie MCP · \<client name> na stronie kluczy API w panelu. Usuń ten klucz, a klient zostanie odłączony.

## OAuth czy klucz API?

Oba prowadzą do tego samego endpointu i tych samych 29 narzędzi.

### Logowanie OAuth

Dla aplikacji czatowych i klientów desktopowych. Nic do kopiowania ani przechowywania: klient trzyma krótkotrwałe tokeny, a każde połączenie widać jako osobny klucz, który możesz usunąć.

### Klucz API

Dla skryptów, CI i agentów headless oraz dla lokalnego pakietu npx. Wyślij klucz qp_live_ jako Authorization: Bearer lub X-Api-Key do hostowanego endpointu albo ustaw QUANTUMPROXIES_API_KEY dla lokalnego serwera.

## Skille dla agentów AI

Pięć plików SKILL.md uczy Claude Code, Claude.ai, Codex, Cursor, Gemini CLI i każdego agenta czytającego otwarty format Agent Skills, jak poprawnie korzystać z QuantumProxies.io. Instalujesz je raz; agent wczytuje właściwy, gdy wymaga tego zadanie.

Instalacja jednym poleceniem: `npx skills add https://quantumproxies.io`. Działa z CLI skills w ponad 70 agentach. Claude Code wczytuje też folder skilla skopiowany do ~/.claude/skills; Codex, Cursor i Gemini CLI czytają ~/.agents/skills.

- [`use-data-api`](https://quantumproxies.io/.well-known/agent-skills/use-data-api/SKILL.md): Wywoływanie REST Data API: uwierzytelnianie, envelope odpowiedzi, zadania asynchroniczne, referencje
- [`use-mcp-server`](https://quantumproxies.io/.well-known/agent-skills/use-mcp-server/SKILL.md): Podłączenie dowolnego klienta MCP: hostowany endpoint OAuth lub lokalny pakiet npm, presety narzędzi
- [`scrape-to-markdown`](https://quantumproxies.io/.well-known/agent-skills/scrape-to-markdown/SKILL.md): Z jednego URL do czystego Markdown lub pól strukturalnych; batch, map i crawl dla wielu stron
- [`generate-proxies`](https://quantumproxies.io/.well-known/agent-skills/generate-proxies/SKILL.md): Ciągi proxy z Twoich planów: geo-targeting, sesje sticky, białe listy IP
- [`find-business-leads`](https://quantumproxies.io/.well-known/agent-skills/find-business-leads/SKILL.md): Listy firm i zbiory danych: Collectors, AI Places Finder, kreator zbiorów danych

[Indeks discovery (/.well-known/agent-skills/)](https://quantumproxies.io/.well-known/agent-skills/index.json) · [Źródła i wtyczka Claude Code na GitHubie](https://github.com/quantumproxies/quantumproxies-skills)

Hostowany endpoint jest zgodny z częścią specyfikacji MCP dotyczącą autoryzacji: to zasób chroniony przez OAuth 2.1, a zapytanie bez poświadczeń dostaje odpowiedź 401, która mówi klientowi, gdzie się zalogować. Klucze nadal działają pod tym samym URL-em, więc istniejące konfiguracje działają bez zmian.

## URL zdalnego serwera MCP i discovery

Hostowany serwer działa pod adresem https://api.quantumproxies.io/mcp i używa Streamable HTTP. Publikuje metadane OAuth protected resource (RFC 9728) pod adresem https://api.quantumproxies.io/.well-known/oauth-protected-resource/mcp, które wskazują https://app.quantumproxies.io jako serwer autoryzacji. Ten serwer publikuje własne metadane (RFC 8414) pod /.well-known/oauth-authorization-server. Klient implementujący autoryzację MCP znajdzie to wszystko sam, zaczynając od odpowiedzi 401.

## Jak zabezpieczone jest logowanie OAuth 2.1

PKCE z metodą S256 jest wymagane przy każdej autoryzacji. Klienci mogą się zarejestrować przez Dynamic Client Registration (RFC 7591) albo przedstawić się dokumentem Client ID Metadata Document. Tokeny dostępu są ważne godzinę; tokeny odświeżania są ważne 30 dni i rotują przy każdym użyciu. Tokeny są powiązane z endpointem MCP przez resource indicators (RFC 8707) i nigdy nie są przekazywane do innych usług.

## Zarządzanie klientami i ich odłączanie

Każdy klient, któremu zezwolisz na dostęp, dostaje dedykowany klucz API o nazwie MCP · \<client name> na stronie kluczy API w panelu. Jego użycie jest rozliczane z salda konta, jak przy każdym innym kluczu API. Usuń klucz, a ten klient zostanie odłączony, podczas gdy pozostali klienci i klucze działają dalej.

## Połączenie przez klucz API

Klucze API nadal działają na tym samym endpoincie: wyślij klucz qp_live_ jako Authorization: Bearer lub w nagłówku X-Api-Key. Lokalny pakiet, npx -y quantumproxies-mcp, działa przez stdio na Twoim komputerze i odczytuje klucz ze zmiennej środowiskowej QUANTUMPROXIES_API_KEY. Używaj klucza wszędzie tam, gdzie nie ma przeglądarki do zalogowania: w skryptach, CI i agentach headless.

## 29 narzędzi dla Twojego agenta

Wyszukuj, czytaj, crawluj i zamieniaj aktualną sieć w kontekst z podanymi źródłami albo zwalidowane wiersze. Długo działające narzędzia udostępniają wywołania statusu, więc agent może odpytywać postęp bez dwukrotnego pobierania tych samych danych.

- `scrape`: Jeden URL jako czysty Markdown, HTML lub tekst, pobrany przez proxy rezydencjalne z prawdziwym odciskiem TLS przeglądarki. Opcjonalna ekstrakcja do ustrukturyzowanego JSON przez selektory CSS lub AI.
- `search`: Ustrukturyzowane wyniki z Google, Bing lub DuckDuckGo, w tym wertykale specyficzne dla danej wyszukiwarki, bloki rozszerzone i metadane paginacji.
- `search_and_read`: Przeszukuje aktualną sieć, pobiera najlepsze źródła i zwraca kontekst gotowy do cytowania, dopasowany do budżetu tokenów Twojego agenta.
- `read_video`: Odczytuje film z YouTube jako jedną oś czasu: metadane, rozdziały, transkrypcję w oryginalnym języku nagrania i małe klatki tam, gdzie mówca wskazuje ekran, podaje cenę lub zaczyna rozdział.
- `map`: W kilka sekund znajduje URL-e serwisu z map witryny i linków na stronie głównej, żeby przed scrapowaniem wskazać właściwe strony, bez pełnego crawla.
- `crawl` + `crawl_status`: Asynchroniczny crawl od początkowego URL-a, każda strona zamieniona na Markdown. Filtry include i exclude, kontrola głębokości, postęp przez crawl_status.
- `batch` + `batch_status`: Scrapuj do 1000 URL-i asynchronicznie ze wspólnymi opcjami i odbieraj wyniki dla każdego URL-a na bieżąco.
- `search_bulk` + `search_bulk_status`: Pobieraj kilka stron SERP asynchronicznie, zachowując wzbogacenia z pierwszej strony i scalając zduplikowane wyniki organiczne.
- `unlock`: Web Unlocker jako narzędzie: powtarza dowolne żądanie HTTP (metoda, nagłówki, treść) przez wyjście rezydencjalne, ponawia próbę ze świeżym IP i przekazuje zablokowane GET do prawdziwej przeglądarki. Nadal zablokowana strona wraca oznaczona, nigdy jako ciche 200.
- `create_dataset` + `dataset_status`: Zamienia prośbę w zwykłym języku w zwalidowany zbiór danych z wierszami dostarczanymi na bieżąco i podpisanymi plikami CSV/JSON do pobrania.
- `seo_audit`: Porównuje widok SEO strony bez JS z widokiem wyrenderowanym: różnice w metadanych, canonical, nagłówkach, treści i danych strukturalnych.
- `ai_visibility`: Czy ChatGPT, Claude, Perplexity, Google AI Overview i Bing Copilot potrafią przeczytać i zacytować stronę? Audyt on-page z oceną per filar, blokadami i poprawkami, plus opcjonalny panel cytowań odpytujący silniki.
- `generate_parser` + `save_parser_preset` + `list_parser_presets` + `parser_preset_stats` + `heal_parser_preset`: Raz uczy się z pomocą LLM selektorów CSS dla układu strony, a potem używa ich do darmowej, deterministycznej ekstrakcji. Pięć narzędzi generuje, zapisuje, listuje, ocenia i samodzielnie naprawia parsery, gdy serwis się zmieni.
- `list_collectors` + `run_collector` + `collector_run_status`: list_collectors, run_collector i collector_run_status: semantyczne dane wejściowe, takie jak słowo kluczowe i lokalizacja, zamiast URL-i. Amazon, Google Maps, oferty pracy z LinkedIn, sklepy z aplikacjami i 70 innych, rozliczane za każdy dostarczony wiersz.
- `list_proxies` + `generate_proxies` + `proxy_locations` + `whitelist_ip`: list_proxies, generate_proxies, proxy_locations i whitelist_ip dają agentowi gotowe do użycia endpointy proxy każdego typu, z geotargetowaniem do poziomu miasta, ISP lub ASN.
- `report`: Wyślij opinię do zespołu z poziomu agenta: błąd, brakującą funkcję lub collector, pytanie. Działa bez klucza API.

## Najczęściej zadawane pytania

### Czym jest serwer MCP QuantumProxies.io?

To darmowy serwer Model Context Protocol, który łączy Scraper API QuantumProxies.io z Claude, Cursor i każdym klientem MCP. Twój agent dostaje 29 narzędzi do scrapowania, wyszukiwania, mapowania i crawlowania sieci przez proxy rezydencjalne z prawdziwymi odciskami TLS przeglądarek. Użyj hostowanego endpointu z logowaniem OAuth albo uruchom pakiet npx lokalnie.

### Czy serwer MCP obsługuje OAuth?

Tak. Hostowany endpoint pod adresem https://api.quantumproxies.io/mcp obsługuje logowanie OAuth 2.1 zgodnie ze specyfikacją autoryzacji MCP. Dodaj URL w kliencie obsługującym logowanie OAuth, zaloguj się do QuantumProxies.io i kliknij „Allow access”. PKCE jest wymagane, tokeny dostępu są ważne godzinę, a tokeny odświeżania rotują.

### Jak podłączyć serwer MCP do Claude?

W Claude dodaj https://api.quantumproxies.io/mcp jako własny konektor i zaloguj się, gdy otworzy się strona QuantumProxies.io. W Claude Code uruchom claude mcp add --transport http quantumproxies https://api.quantumproxies.io/mcp, a potem /mcp, żeby się zalogować. Claude Desktop może też uruchomić lokalny pakiet npx z kluczem API.

### Jak odłączyć klienta?

Otwórz stronę kluczy API w panelu. Każdy klient połączony przez OAuth ma własny klucz o nazwie MCP · \<client name>. Usuń ten klucz, a klient straci dostęp; pozostali klienci i klucze API nie są objęci zmianą. Żeby połączyć go ponownie, dodaj URL serwera i zaloguj się jeszcze raz.

### Czy nadal mogę używać klucza API?

Tak. Wyślij klucz qp_live_ jako Authorization: Bearer lub X-Api-Key na https://api.quantumproxies.io/mcp albo uruchom lokalny pakiet przez npx -y quantumproxies-mcp ze zmienną środowiskową QUANTUMPROXIES_API_KEY. Klucz to prostszy wybór dla skryptów, CI i agentów headless, gdzie nie ma przeglądarki do zalogowania.

### Ile to kosztuje?

Sam serwer MCP jest darmowy. Płacisz tylko standardowe stawki pay-as-you-go za wykonywane przez niego wywołania API, takie same jak przy bezpośrednich wywołaniach Scraper API, rozliczane z salda konta niezależnie od tego, czy łączysz się przez OAuth, czy kluczem. Nowe konta dostają darmowe środki na testy, bez karty kredytowej.

### Czy jest zdalny serwer MCP, czy tylko lokalny pakiet?

Jest jedno i drugie. Hostowany endpoint pod adresem https://api.quantumproxies.io/mcp używa Streamable HTTP dla klientów, które wolą URL, z logowaniem OAuth lub kluczem API, i udostępnia te same 29 narzędzi. Pakiet npx działa na Twoim komputerze przez stdio i uwierzytelnia się Twoim kluczem API.

### Gdzie to działa? Czy widzicie moje dane?

Lokalny pakiet działa na Twoim komputerze przez npx i komunikuje się z publicznym API QuantumProxies.io przy użyciu Twojego własnego klucza qp_live_: bez wewnętrznych sekretów w pakiecie i bez dodatkowego pośrednika. Hostowany endpoint wykonuje te same wywołania API kluczem przypisanym do Twojego połączenia; tokeny OAuth nigdy nie są przekazywane do innych usług.

### Jakie klienty MCP są obsługiwane?

Każdy klient obsługujący Model Context Protocol. Klienci, którzy łączą się ze zdalnymi serwerami przez Streamable HTTP i obsługują logowanie OAuth, używają hostowanego URL-a; klienci stdio, tacy jak Claude Desktop, Claude Code, Cursor, Windsurf, VS Code i Zed, mogą uruchomić lokalny pakiet z tym samym pięciolinijkowym JSON-em.

### Jakie narzędzia dostaje mój agent?

Dwadzieścia dziewięć narzędzi: scrape, unlock, seo_audit, ai_visibility, search, search_and_read, read_video, map, crawl i batch z odpytywaniem statusu, search_bulk i create_dataset z własnymi narzędziami statusu, generate_parser z czterema samonaprawiającymi się narzędziami presetów, trzy narzędzia Collector obsługujące gotowe scrapery, cztery narzędzia proxy do endpointów, geotargetowania i białych list IP oraz report do wysyłania opinii zespołowi.

### Dlaczego agent nie może pobierać stron sam?

Zwykłe zapytania HTTP wysyłane przez agenta są blokowane przez systemy anty-botowe właśnie na tych stronach, które warto przeczytać. Serwer MCP kieruje każde zapytanie przez rezydencjalne IP z odciskami TLS klasy przeglądarki, z automatycznym ponawianiem po blokadzie i przeglądarką stealth jako fallbackiem, więc agent czyta prawdziwą stronę, a nie captchę.

## Powiązane produkty

- [Extract API: dowolna strona do Markdown lub JSON](https://quantumproxies.io/pl/extract-api)
- [Dane z sieci dla LLM i RAG](https://quantumproxies.io/pl/web-data-for-llms)
- [SERP API dla Google, Bing i DuckDuckGo](https://quantumproxies.io/pl/serp-api)
- [Web Unlocker dla stron chronionych przed botami](https://quantumproxies.io/pl/web-unlocker)
- [Proxy rezydencjalne](https://quantumproxies.io/pl/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)
