Apify MCP Server – AI 어시스턴트가 Apify Actors를 실행할 수 있게 하는 브리지

개요

Apify Model Context Protocol (MCP) server (mcp.apify.com)는 Model Context Protocol을 구현한 호스팅 서비스로, 대규모 언어 모델(LLM) 에이전트가 외부 도구를 호출하는 표준 방법입니다. 이 경우 도구는 Apify Actors로, Apify 플랫폼에서 실행되는 즉시 사용 가능한 웹 스크래핑, 데이터 추출 및 자동화 스크립트입니다.

누가 사용할까요?

• LLM 기반 어시스턴트(Claude, Claude Desktop, Cursor, VS Code 확장, ChatGPT 등)로 실시간 웹 데이터를 가져오거나 사용자 지정 자동화 단계를 실행해야 하는 경우.
• 자율 에이전트를 개발하는 개발자로, HTTP 코드를 직접 작성하지 않고 8,000개 이상의 Actors 카탈로그를 플러그 앤 플레이로 사용하려는 경우.
• 내장된 에이전트 결제(AGI 토큰, x402 USDC 또는 Skyfire PAY 토큰)를 통해 에이전트를 실행별로 청구하려는 팀.

핵심 기능

기능	설명	중요성
동적 도구 검색	서버는 Actor의 입력 스키마를 읽고 MCP 도구(예: call-actor, search-actors)를 자동으로 생성합니다. LLM은 전달할 인수를 정확히 알 수 있습니다.	도구 서명을 하드코딩할 필요 없음; 새 Actors는 즉시 사용 가능.
HTTPS 엔드포인트 및 OAuth	클라이언트는 Authorization: Bearer <APIFY_TOKEN> 헤더 또는 OAuth 흐름을 통해 https://mcp.apify.com을 호출합니다.	클라우드 호스팅 에이전트와 데스크톱 클라이언트 모두에서 작동하는 안전한 토큰 기반 액세스.
StdIO 모드	npx @apify/actors-mcp-server를 사용하여 서버를 로컬에서 실행하고 stdin/stdout을 통해 JSON 메시지를 파이프합니다.	오프라인 또는 CLI 기반 통합(예: Claude for Desktop)에 유용.
에이전트 결제	API 토큰 없이 Actor 실행 비용을 지불하는 방법:

• AGI – x402 또는 MPP 결제 후 발행되는 선불 Apify 토큰(권장).
• Direct x402 – Base 블록체인의 USDC. mcpc 클라이언트가 처리.
• Skyfire – PAY 토큰 시스템. | 사용자가 Apify 계정이 없어도 유료 Actors를 실행할 수 있는 '종량제' AI 에이전트를 가능하게 합니다. | | 풍부한 도구 세트 | call-actor 외에도 Apify Store 검색, 문서 가져오기, 데이터셋, 키-값 저장소, 스케줄, 빌드 등을 관리하는 헬퍼를 제공합니다. | 에이전트에게 스크래핑뿐만 아니라 Apify 플랫폼에 대한 전체 CRUD 액세스를 제공합니다. | | 원격 측정 및 보고 | 선택적 원격 측정 도구(report-problem, dev)를 통해 에이전트가 사용 데이터를 Apify로 보낼 수 있습니다. | 서비스 개선 및 클라이언트 문제 디버깅에 도움이 됩니다. |

시작 방법

1. 클라이언트 선택 – Claude Desktop, VS Code Genie, 오픈 소스 mcpc CLI 또는 웹 기반 Apify Tester MCP Client.
2. 연결 – URL https://mcp.apify.com을 사용하고 OAuth 흐름 또는 APIFY_TOKEN(또는 AGI 생성 토큰)을 제공합니다.
3. 도구 검색 – search-actors 또는 fetch-actor-details를 호출하여 사용 가능한 Actors를 나열하고 스키마를 가져옵니다.
4. 도구 실행 – 예: call-actor actor:="apify/rag-web-browser" input:{"query":"latest AI news","maxResults":3}.
5. 결제(선택 사항) – API 토큰이 없으면 AGI 토큰을 얻거나 README의 설명에 따라 x402/Skyfire를 구성합니다.

사용 사례 예시

자율 연구 어시스턴트가 *"양자 컴퓨팅 돌파구에 관한 최근 기사 상위 3개를 요약해 주세요."*라는 프롬프트를 받습니다. 그것은:

1. search-actors를 호출 → apify/rag-web-browser를 발견.
2. 쿼리와 maxResults:3로 call-actor를 호출.
3. 스크래핑된 기사 텍스트를 받아 요약하고 사용자에게 답변을 반환. 이 모든 것이 단일 MCP 요청/응답 주기로 이루어집니다.

---

결론 – Apify MCP Server는 LLM 에이전트가 Apify의 방대한 웹 자동화 Actors 라이브러리를 네이티브 도구로 취급할 수 있게 하는 실제 프로덕션급 브리지로, 인증, 결제 옵션 및 풍부한 관리 API가 내장되어 있습니다.