Apify MCP Server: 에이전트가 웹 스크래핑 Actor를 실행하게 하는 MCP 서버
Apify 공식 MCP 서버로, AI 에이전트가 Apify Store에서 작업에 맞는 Actor를 검색하고 입력 스키마와 가격을 확인한 뒤 웹 스크래핑·검색·데이터 추출·브라우저 자동화를 실행하고 구조화된 결과를 조회하도록 한다. OAuth를 지원하는 호스팅 서버 또는 npm 패키지의 로컬 stdio 프로세스로 연결하며, 두 방식 모두 Actor는 Apify 클라우드에서 실행된다.
주요 기능
- Actor 검색·정보/가격 조회·실행·진행/로그/데이터셋 조회
- 도구 카테고리·이름·특정 Actor만 선택하는 tools 설정
- Streamable HTTP/OAuth 또는 로컬 stdio/Bearer token 지원
- 지원 클라이언트용 MCP Apps 위젯, API 문서 조회 및 선택적인 플랫폼 작업 도구
- 저장 작업·스케줄·버전·빌드 관리와 일반 API 쓰기 도구도 선택 가능
구조
공개 TypeScript 코어를 npm 패키지 @apify/actors-mcp-server로 배포해요. 로컬은 stdio, 호스팅은 Streamable HTTP로 MCP 도구를 노출해요. 도구가 Apify API를 호출하고 Actor 실행·스토리지는 Apify 클라우드가 담당해요. 호스팅 서비스는 이 코어를 쓰는 별도 비공개 저장소에서 운영돼요.
누구에게 쓸모 있나요
여러 웹사이트의 데이터 수집·시장 조사·RAG 수집을 MCP 에이전트에 연결하려는 개발자.
설치 전 준비
- 로컬 npm 패키지 Node.js >=22.0.0; 개발에는 pnpm 필요. 확인 package.json은 0.20.3 및 pnpm@11.11.0
- 호스팅 연결 자체 무료. Actor 실행은 각 Actor 가격에 따라 Apify 계정에 청구
- README 기준 무료 플랜은 월 $5 플랫폼 이용량 포함. 실제 이용 직전 현행 요금 확인
- pay-per-event는 callOptions.maxTotalChargeUsd, pay-per-result는 maxItems로 비용 제한. timeout/memory는 가격 상한이 아님
- 호스팅은 계정당 초당 20 요청. 일부 검색/문서 도구는 계정 없이 사용 가능
- OAuth 지원 호스팅 MCP 클라이언트
- 로컬 stdio: Node.js 22+ 및 Apify token/CLI 로그인
- 개발: pnpm, 로컬 HTTP 개발 서버
설치 방법
설치 방법 1
권장 호스팅 엔드포인트: https://mcp.apify.com (웹 configurator에서 클라이언트별 설정 생성)
설치 방법 2
공식 README에 문서화된 경로예요. 이번 조사에서는 설치·실행하지 않았어요.
claude mcp add apify "https://mcp.apify.com" -t http설치 방법 3
로컬 stdio 경로예요. 클라이언트 환경에 APIFY_TOKEN을 설정하거나 기존 Apify CLI 로그인을 사용해요. 이번 조사에서는 실행하지 않았어요.
npx -y @apify/actors-mcp-server설치 방법 4
공식 README에 문서화된 경로예요. 이번 조사에서는 설치·실행하지 않았어요.
npx @apify/actors-mcp-server --tools actors,docs,apify/web-search,apify/web-fetch설치 방법 5
공식 README에 문서화된 경로예요. 이번 조사에서는 설치·실행하지 않았어요.
pnpm install
pnpm run build
pnpm run dev사용 방법
- 호스팅 연결 후 OAuth 로그인 또는 Authorization: Bearer 헤더 사용
- search-actors → fetch-actor-details → call-actor → get-dataset-items 흐름
- 예: 특정 사이트 문서를 Markdown으로 수집하거나 상품 가격·리뷰를 구조화해 비교
- 운영에서는 https://mcp.apify.com?tools=apify/instagram-scraper 등 명시적 tools 설정
비용과 API 키
MCP 연결 자체는 무료이며 Actor 실행은 개별 가격에 따라 과금돼요. README 기준 무료 플랜 월 $5 이용량이 포함돼요. pay-per-event는 maxTotalChargeUsd, pay-per-result는 maxItems로 제한하며 timeout·memory는 비용 상한이 아니에요. 이용 직전 현행 요금 확인이 필요해요.
라이선스
MIT (Copyright 2025 Apify) — 고정 커밋의 라이선스 원문 확인. 배포 시 해당 고지·조건을 준수해야 해요.
주의사항과 알려진 이슈
- 로컬 MCP 실행도 데이터와 Actor 입력이 Apify API로 전송되고 결과는 Apify 플랫폼에 저장됨
- telemetry 기본 켜짐: 세션 trace ID, 모델 작성 검색 이유(_useCase), stdio Sentry 오류 추적. –telemetry-enabled=false 또는 TELEMETRY_ENABLED=false로 옵트아웃
- API token은 비밀번호처럼 취급하고 저장소·공개 URL에 넣지 말 것
- 일부 도구는 실행 비용·외부 부작용·삭제·공개 게시·스케줄 생성 가능. 도구 힌트만 안전 보장으로 보지 말고 필요한 도구만 노출
- 전체 권한 Actor는 일회 승인 필요. 검색은 안전 필터 통과 free/pay-per-event Actor만 반환하여 모든 Actor를 포괄하지 않음
- 기본 도구 집합은 버전 사이 변경 가능. 동적 도구·OAuth·MCP Apps 지원은 클라이언트별로 다름
- 호스팅 서비스는 공개 코어를 사용하는 별도 비공개 저장소에서 운영되므로 공개 소스만으로 호스팅 전체 구현을 확인할 수 없음
- 웹 수집 대상의 이용약관·개인정보·수집 권한을 별도 검토
확인 범위
확인 날짜: 2026-11-05
확인 커밋: 87849cae575692238583b1bc4bb92f8df4af79d3
확인한 범위: 공식 GitHub 저장소 메타데이터·master 브랜치 HEAD·README·라이선스·package.json를 정적으로 확인했어요. 비아카이브 상태이며 요청 저장소 이름이 canonical 경로와 일치해요.
확인 한계: 대상 프로그램 설치·실행·계정 연결·토큰 생성·유료 호출은 하지 않았어요. 성능·플랫폼별 실제 동작·전체 보안 감사·배포 채널 최신 버전은 미검증이에요.