웹 스크래핑과 AI 에이전트를 위한 MCP 서버

QuantumProxies.io MCP 서버는 Claude, Cursor 등 모든 MCP 클라이언트에 주거용 프록시를 통해 실시간 웹을 scrape·search·map·crawl하는 28개 도구를 제공합니다. OAuth 로그인을 지원하는 클라이언트에 https://api.quantumproxies.io/mcp를 추가하고, 계정에 로그인한 뒤 Allow access를 클릭하면 됩니다. 복사할 API 키는 없습니다.

4단계로 OAuth 연결

MCP 사양에 정의된 인가 흐름인 OAuth 로그인을 지원하는 MCP 클라이언트용입니다.

  1. 서버 URL 추가: 클라이언트에 https://api.quantumproxies.io/mcp를 붙여 넣습니다. Claude라면 사용자 지정 커넥터로 추가합니다.
  2. 로그인: 클라이언트가 QuantumProxies.io 로그인 페이지를 엽니다. 로그인하거나 무료 계정을 만드세요.
  3. 액세스 허용: 동의 화면에서 확인을 요청합니다. Allow access를 클릭하면 클라이언트가 연결됩니다.
  4. 에이전트에게 요청: 28개 도구를 바로 사용할 수 있습니다. 사용량은 일반 API 키와 마찬가지로 계정 잔액에서 차감됩니다.

연결마다 전용 API 키가 발급되며, 대시보드의 API 키 페이지에 MCP · <client name>이라는 이름으로 표시됩니다. 해당 키를 삭제하면 클라이언트 연결이 해제됩니다.

OAuth와 API 키, 무엇을 쓸까요?

둘 다 같은 엔드포인트, 같은 28개 도구에 연결됩니다.

OAuth 로그인

채팅 앱과 데스크톱 클라이언트용. 복사하거나 보관할 것이 없습니다. 클라이언트는 수명이 짧은 토큰을 보유하고, 각 연결은 삭제 가능한 개별 키로 표시됩니다.

API 키

스크립트, CI, 헤드리스 에이전트와 로컬 npx 패키지용. 호스팅 엔드포인트에는 qp_live_ 키를 Authorization: Bearer 또는 X-Api-Key로 보내고, 로컬 서버에는 QUANTUMPROXIES_API_KEY를 설정합니다.

AI 에이전트용 스킬

다섯 개의 SKILL.md 파일이 Claude Code, Claude.ai, Codex, Cursor, Gemini CLI와 개방형 Agent Skills 형식을 읽는 모든 에이전트에 QuantumProxies.io를 올바르게 사용하는 방법을 알려줍니다. 한 번만 설치하면 작업에 필요할 때 에이전트가 알맞은 스킬을 불러옵니다.

명령어 하나로 설치: npx skills add https://quantumproxies.io. 70개 이상의 에이전트에서 skills CLI로 사용할 수 있습니다. Claude Code는 ~/.claude/skills에 복사한 스킬 폴더도 불러오고, Codex, Cursor, Gemini CLI는 ~/.agents/skills를 읽습니다.

디스커버리 인덱스(/.well-known/agent-skills/) · GitHub의 소스 코드와 Claude Code 플러그인

호스팅 엔드포인트는 MCP 사양의 인가 규정을 따릅니다. OAuth 2.1 보호 리소스이며, 자격 증명 없는 요청에는 클라이언트에 로그인 위치를 알려 주는 401 응답을 반환합니다. 같은 URL에서 키도 계속 작동하므로 기존 설정은 그대로 유지됩니다.

원격 MCP 서버 URL과 디스커버리

호스팅 서버는 https://api.quantumproxies.io/mcp에 있으며 Streamable HTTP로 통신합니다. OAuth 보호 리소스 메타데이터(RFC 9728)를 https://api.quantumproxies.io/.well-known/oauth-protected-resource/mcp에 게시하며, 여기서 https://app.quantumproxies.io를 인가 서버로 지정합니다. 인가 서버는 자체 메타데이터(RFC 8414)를 /.well-known/oauth-authorization-server에 게시합니다. MCP 인가를 구현한 클라이언트는 401 응답에서 시작해 이 모든 정보를 스스로 찾습니다.

OAuth 2.1 로그인 보안 방식

모든 인가에 S256 방식의 PKCE가 필수입니다. 클라이언트는 Dynamic Client Registration(RFC 7591)으로 등록하거나 Client ID Metadata Document로 자신을 식별할 수 있습니다. 액세스 토큰은 1시간, 리프레시 토큰은 30일간 유효하며 사용할 때마다 교체됩니다. 토큰은 리소스 표시자(RFC 8707)로 MCP 엔드포인트에 바인딩되며 다른 서비스로 전달되지 않습니다.

클라이언트 관리와 연결 해제

허용한 클라이언트마다 전용 API 키가 발급되며, 대시보드의 API 키 페이지에 MCP · <client name>이라는 이름으로 표시됩니다. 사용량은 다른 API 키와 마찬가지로 계정 잔액에서 차감됩니다. 키를 삭제하면 해당 클라이언트의 연결이 해제되고, 다른 클라이언트와 키는 계속 작동합니다.

API 키로 연결하기

API 키는 같은 엔드포인트에서 계속 사용할 수 있습니다. qp_live_ 키를 Authorization: Bearer 또는 X-Api-Key 헤더로 보내세요. 로컬 패키지 npx -y quantumproxies-mcp는 사용자의 컴퓨터에서 stdio로 실행되며 QUANTUMPROXIES_API_KEY 환경 변수에서 키를 읽습니다. 스크립트, CI, 헤드리스 에이전트처럼 로그인할 브라우저가 없는 곳에서는 키를 사용하세요.

에이전트가 쓰는 28개 도구

실시간 웹을 검색하고 읽고 crawl하여, 출처가 있는 컨텍스트나 검증된 행 데이터로 바꿉니다. 오래 걸리는 도구에는 status 호출이 있어, 같은 데이터를 두 번 내려받지 않고 폴링할 수 있습니다.

자주 묻는 질문

QuantumProxies.io MCP 서버란 무엇인가요?

QuantumProxies.io Scraper API를 Claude, Cursor 등 모든 MCP 클라이언트에 연결하는 무료 Model Context Protocol 서버입니다. 에이전트는 실제 브라우저 TLS 지문을 가진 주거용 프록시를 통해 웹을 scrape·search·map·crawl하는 28개 도구를 사용할 수 있습니다. OAuth 로그인으로 호스팅 엔드포인트를 쓰거나 npx 패키지를 로컬에서 실행하세요.

MCP 서버가 OAuth를 지원하나요?

네. 호스팅 엔드포인트 https://api.quantumproxies.io/mcp는 MCP 인가 사양에 정의된 OAuth 2.1 로그인을 지원합니다. OAuth 로그인을 지원하는 클라이언트에 URL을 추가하고, QuantumProxies.io에 로그인한 뒤 Allow access를 클릭하세요. PKCE가 필수이며, 액세스 토큰은 1시간 유효하고 리프레시 토큰은 교체됩니다.

Claude에 MCP 서버를 연결하려면?

Claude에서는 https://api.quantumproxies.io/mcp를 사용자 지정 커넥터로 추가하고, QuantumProxies.io 페이지가 열리면 로그인합니다. Claude Code에서는 claude mcp add --transport http quantumproxies https://api.quantumproxies.io/mcp를 실행한 뒤 /mcp로 로그인합니다. Claude Desktop에서는 API 키로 로컬 npx 패키지를 실행할 수도 있습니다.

클라이언트 연결은 어떻게 해제하나요?

대시보드의 API 키 페이지를 여세요. OAuth로 연결된 클라이언트마다 MCP · <client name>이라는 이름의 키가 있습니다. 그 키를 삭제하면 클라이언트는 액세스를 잃으며, 다른 클라이언트와 API 키에는 영향이 없습니다. 다시 연결하려면 서버 URL을 추가하고 한 번 더 로그인하세요.

API 키도 계속 쓸 수 있나요?

네. qp_live_ 키를 Authorization: Bearer 또는 X-Api-Key로 https://api.quantumproxies.io/mcp에 보내거나, npx -y quantumproxies-mcp와 QUANTUMPROXIES_API_KEY 환경 변수로 로컬 패키지를 실행하세요. 로그인할 브라우저가 없는 스크립트, CI, 헤드리스 에이전트에는 키가 더 간단합니다.

비용은 얼마인가요?

MCP 서버 자체는 무료입니다. 서버가 수행하는 API 호출에 대해 표준 종량제 요금만 내며, Scraper API를 직접 호출할 때와 같은 요율입니다. OAuth와 키 중 무엇으로 연결하든 계정 잔액에서 차감됩니다. 신규 계정은 테스트용 무료 크레딧을 받으며 신용카드가 필요 없습니다.

원격 MCP 서버가 있나요, 아니면 로컬 패키지뿐인가요?

둘 다 있습니다. 호스팅 엔드포인트 https://api.quantumproxies.io/mcp는 URL을 선호하는 클라이언트를 위해 Streamable HTTP로 통신하며, OAuth 로그인 또는 API 키로 같은 28개 도구를 제공합니다. npx 패키지는 사용자의 컴퓨터에서 stdio로 실행되며 API 키로 인증합니다.

어디에서 실행되나요? 제 데이터를 보나요?

로컬 패키지는 npx로 사용자의 컴퓨터에서 실행되며, 본인의 qp_live_ 키로 공개 QuantumProxies.io API와 통신합니다. 패키지에 내부 비밀이 없고 추가 경유 지점도 없습니다. 호스팅 엔드포인트는 연결에 묶인 키로 같은 API 호출을 하며, OAuth 토큰은 다른 서비스로 전달되지 않습니다.

어떤 MCP 클라이언트를 지원하나요?

Model Context Protocol을 지원하는 모든 클라이언트입니다. Streamable HTTP로 원격 서버에 연결하고 OAuth 로그인을 지원하는 클라이언트는 호스팅 URL을 사용합니다. Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Zed 같은 stdio 클라이언트는 같은 다섯 줄짜리 JSON으로 로컬 패키지를 실행할 수 있습니다.

에이전트는 어떤 도구를 쓰나요?

28개 도구입니다. scrape, unlock, seo_audit, ai_visibility, search, search_and_read, map, 상태 폴링을 지원하는 crawl과 batch, 각각 상태 도구가 딸린 search_bulk와 create_dataset, 자가 복구 프리셋 도구 4개가 딸린 generate_parser, 기성 스크래퍼를 다루는 Collector 도구 3개, 엔드포인트, 지역 타기팅, IP 화이트리스트용 프록시 도구 4개, 그리고 팀에 피드백을 보내는 report입니다.

에이전트가 직접 페이지를 가져오면 안 되나요?

에이전트의 일반 HTTP 요청은 정작 읽을 가치가 있는 페이지에서 안티봇 시스템에 차단됩니다. MCP 서버는 모든 요청을 브라우저 수준 TLS 지문을 가진 주거용 IP로 보내고, 차단 시 자동 재시도와 스텔스 브라우저 대체를 수행합니다. 그래서 에이전트는 캡차가 아닌 실제 페이지를 읽습니다.

관련 제품

Sources

AI 에이전트라면

마케팅은 건너뛰세요. QuantumProxies.io는 LLM용 사이트맵, 모든 페이지의 Markdown, 무료 MCP 서버, 프록시와 같은 잔액으로 청구되는 API를 제공합니다.

명령 하나로 연결: npx -y quantumproxies-mcp