Octoparse MCP Server

✅ 가능한 작업

사전 제작된 스크래핑 템플릿 검색
사전 설정된 템플릿에서 새 클라우드 작업을 생성해 실행
클라우드 지원 작업 실행 시작 및 모니터링
수집된 데이터 내보내기(JSON/CSV)
기존 작업 목록 조회 및 검색
실행 중인 작업 시작 또는 중지
쿠폰 코드 사용

❌ 불가능한 작업

로컬 전용 작업 실행(데스크톱 클라이언트 필요)
완전한 사용자 지정 작업 생성 또는 필드, 페이지 넘기기, 루프, 브라우저 워크플로 같은 작업 구성 세부 정보 편집
사용자 지정 스크래핑 템플릿 업로드
계정 설정 또는 청구 정보 접근
사전 설정된 템플릿 없이 스크래핑

MCP는 Octoparse 사전 설정 템플릿에서 새 클라우드 작업을 생성하고 실행할 수 있습니다. 완전한 사용자 지정 스크래핑 워크플로를 만들거나 사용자 지정 작업 구성 세부 정보를 편집할 수는 없습니다. 사용자 지정 워크플로가 필요하면 먼저 Octoparse에서 만든 뒤 MCP로 실행, 모니터링, 중지 또는 내보내기하세요.

빠른 시작

서버 URL

Server URL

https://mcp.octoparse.com

인증 방법

경로 A: OAuth 2.1

브라우저 기반 로그인 방식이며 대부분의 사용자에게 권장됩니다. API 키 없이 메시지가 표시될 때 Octoparse에 로그인하면 됩니다.

경로 B: API 키

API 키로 직접 인증합니다. Claude Code, Codex CLI, VS Code, TRAE, OpenClaw 같은 자동화 또는 헤드리스 환경에 적합합니다.Octoparse 계정 센터에서 키를 발급하세요.

지원 클라이언트

ChatGPT

사용자 지정 설정 열기

프로필 아바타를 클릭하고 Customize ChatGPT를 선택합니다.

개발자 모드 활성화

Apps → Advanced Settings로 이동해 **Developer Mode (Beta)**를 켭니다.

Octoparse 앱 생성

Create app을 클릭합니다. 이름을 Octoparse, MCP URL을 https://mcp.octoparse.com으로 설정하고 OAuth Client ID와 Secret은 비워 둡니다. 확인 사항에 동의한 뒤 앱을 생성합니다.

OAuth로 승인

ChatGPT가 Octoparse로 리디렉션합니다. 로그인한 뒤 Allow를 클릭합니다.

전체 설정 가이드 보기

Codex

Codex CLI와 Codex IDE 확장 프로그램은 동일한 MCP 구성(~/.codex/config.toml)을 공유합니다. 한 번 설정하면 두 환경에서 모두 작동합니다.

경로 A: OAuth

서버 추가

codex mcp add octoparse --url https://mcp.octoparse.com

OAuth로 승인

codex mcp login octoparse

브라우저 창이 열립니다. Octoparse에 로그인하고 Allow를 클릭합니다.

경로 B: API 키~/.codex/config.toml에 다음을 추가합니다.

    [mcp_servers.octoparse]
    url = "https://mcp.octoparse.com"
    http_headers = { "x-api-key" = "YOUR_API_KEY" }

Claude

경로 A: OAuth

Settings → Connectors 열기

Claude 사이드바에서 Settings → Connectors로 이동합니다.

서버 URL 추가

Add Connector를 클릭하고 https://mcp.octoparse.com을 입력합니다.

OAuth로 승인

Connect를 클릭합니다. 브라우저 창이 열리면 로그인하고 Allow를 클릭합니다.

전체 설정 가이드 보기

Claude Code

claude mcp add로 추가한 서버는 Claude Code CLI, 데스크톱 앱 및 IDE 확장 프로그램(VS Code/JetBrains)에서 공유됩니다. 한 번 설정하면 모든 환경에서 작동합니다.

경로 A: OAuth

서버 추가

claude mcp add --transport http octoparse https://mcp.octoparse.com

OAuth로 승인

Claude Code를 시작하고 /mcp를 실행한 뒤 octoparse를 선택해 인증합니다. 브라우저 창이 열리면 Octoparse에 로그인하고 Allow를 클릭합니다.

경로 B: API 키

claude mcp add --transport http octoparse https://mcp.octoparse.com --header "x-api-key: YOUR_API_KEY"

OpenClaw

경로 A: OAuth

OpenClaw 설치

OpenClaw를 설치한 뒤 온보딩 명령어를 실행합니다.

MCP 서버 등록

Octoparse MCP 서버를 설정하고 구성을 확인합니다.

Gateway 다시 시작

구성을 적용하려면 Gateway를 다시 시작합니다.

OAuth로 승인

첫 Octoparse 도구 호출 시 OAuth용 브라우저가 열립니다. 로그인하고 Allow를 클릭합니다.

경로 B: API 키

    mcporter config add octoparse https://mcp.octoparse.com
    mcporter config set octoparse header.x-api-key "YOUR_API_KEY"

그런 다음 OpenClaw 구성에 추가합니다.

    {
      "mcp": {
        "servers": {
          "octoparse": {
            "command": "mcporter",
            "args": ["run", "stdio", "--server", "octoparse"]
          }
        }
      }
    }

Cursor

경로 A: OAuth

Cursor Settings 열기

Cursor를 열고 오른쪽 위의 설정 아이콘을 클릭합니다.

Tools & MCP로 이동

왼쪽 사이드바에서 Tools & MCP를 선택합니다.

사용자 지정 MCP 서버 추가

Add Custom MCP를 클릭합니다. Cursor가 MCP 구성 파일을 열면 https://mcp.octoparse.com을 추가하고 저장합니다.

전체 설정 가이드 보기

경로 B: API 키~/.cursor/mcp.json에 다음을 추가합니다.

    {
      "mcpServers": {
        "octoparse": {
          "type": "http",
          "url": "https://mcp.octoparse.com",
          "headers": {
            "x-api-key": "YOUR_API_KEY"
          }
        }
      }
    }

VS Code

활성 GitHub Copilot 구독이 필요합니다.

경로 A: OAuth.vscode/mcp.json에 다음을 추가합니다.

    {
      "servers": {
        "octoparse": {
          "type": "http",
          "url": "https://mcp.octoparse.com"
        }
      }
    }

전체 설정 가이드 보기

경로 B: API 키

    {
      "servers": {
        "octoparse": {
          "type": "http",
          "url": "https://mcp.octoparse.com",
          "headers": {
            "x-api-key": "YOUR_API_KEY"
          }
        }
      }
    }

Antigravity

Antigravity IDE와 Antigravity CLI는 동일한 MCP 구성(~/.gemini/config/mcp_config.json)을 공유합니다. 한 번 설정하면 두 환경에서 모두 작동합니다. IDE에서는 에이전트 패널의 MCP Servers → View raw config에서도 열 수 있습니다.

경로 A: OAuth~/.gemini/config/mcp_config.json에 다음을 추가합니다.

    {
      "mcpServers": {
        "octoparse": {
          "serverUrl": "https://mcp.octoparse.com"
        }
      }
    }

MCP 서버 목록을 새로 고칩니다. 첫 Octoparse 도구 호출 시 OAuth용 브라우저가 열리면 로그인하고 Allow를 클릭합니다.

경로 B: API 키

    {
      "mcpServers": {
        "octoparse": {
          "serverUrl": "https://mcp.octoparse.com",
          "headers": {
            "x-api-key": "YOUR_API_KEY"
          }
        }
      }
    }

시작하기

도구 레퍼런스

사전 요구 사항

범위 및 제한 사항

✅ 가능한 작업

❌ 불가능한 작업

빠른 시작

서버 URL

인증 방법

경로 A: OAuth 2.1

경로 B: API 키

지원 클라이언트

​사전 요구 사항

​범위 및 제한 사항

✅ 가능한 작업

❌ 불가능한 작업

​빠른 시작

​서버 URL

​인증 방법

경로 A: OAuth 2.1

경로 B: API 키

​지원 클라이언트

사전 요구 사항

범위 및 제한 사항

빠른 시작

서버 URL

인증 방법

지원 클라이언트