이 페이지는 “앱을 먼저 고른 뒤 연결” 방식을 따릅니다. 어떤 앱을 고를지 아직 모르고 MCP를 먼저 연결한 뒤 에이전트가 검색하게 하고 싶다면 범용 연결: 에이전트 안에서 앱 선택하기를 대신 사용하세요.
Claude Code와 Codex는 같은 Data Hub MCP 기능을 사용합니다. 차이는 각 클라이언트가 MCP 설정을 저장하고 서버 상태를 표시하는 방식뿐입니다. Data App 자체는 바뀌지 않습니다.
완료 후 할 수 있는 일
이 튜토리얼을 마치면 Claude Code에서 데이터 요구를 직접 설명하고 Data Hub의 Data App을 호출하여 구조화된 데이터를 가져올 수 있습니다. 이 페이지는 단일 Data App과 여러 Data App을 연결하는 방법도 다룹니다.시작하기 전에
다음을 준비하세요.- 로그인할 수 있는 Octoparse 계정.
- 설치되고 로그인된 Claude Code.
- 명확하고 작은 테스트 목표(대상 플랫폼, 키워드, 레코드 수 등).
1단계: Data App 선택 및 테스트
먼저 브라우저에서 앱의 입력과 출력을 확인한 뒤 Claude Code를 연결합니다. 나중에 문제가 생기면 매개변수가 잘못되었는지 서버 설정이 잘못되었는지 빠르게 판단할 수 있습니다.1
Octoparse Data Hub 열기 및 로그인
Octoparse Data Hub로 이동하여 오른쪽 상단의 계정 진입점으로 로그인합니다.
2
대상 Data App 선택
검색이나 카테고리로 대상 앱을 찾습니다. 상세 페이지에서 기능 설명, 필수 매개변수, 반환 필드, 가격을 꼼꼼히 읽고 작업에 적합한지 확인합니다.
3
온라인에서 한 번 실행
Try It Now를 클릭하고 페이지 안내에 따라 매개변수를 입력합니다. 처음에는 소량의 데이터만 요청합니다. 실행이 끝나면 상태, 레코드 수, 핵심 필드를 확인합니다.
2단계: Claude Code 설치 프롬프트 복사
Data App 상세 페이지에서 Integration을 열고 MCP를 선택한 뒤 Copy install prompt를 클릭합니다. Copy MCP URL은 서버 주소만 제공하며,claude mcp add를 직접 실행하려는 경우에 사용합니다. 상세 페이지 사이드바의 MCP 링크로도 빠르게 이동할 수 있습니다.
3단계: Octoparse API 키 생성
1
API 키 페이지 열기
Octoparse 계정 센터로 이동하여 새 API 키를 생성합니다.
2
API 키 안전하게 보관
키 전체는 보통 생성 시 한 번만 표시됩니다. 신뢰할 수 있는 비밀번호 관리자에 임시로 보관하세요. 프로젝트 디렉터리나 공유 문서에 저장하지 마세요.
Authorization: Bearer <API_KEY> 줄은 API 키의 헤더 형식입니다. 범용 연결은 OAuth도 지원합니다. 두 튜토리얼의 설정 조각을 섞지 마세요.
4단계: Claude Code에 서버 추가
1
설치 프롬프트를 Claude Code에 보내기
새 Claude Code 세션을 시작하고 복사한 전체 설치 프롬프트를 붙여넣어 보냅니다. Claude Code는 서버 주소와 설정 요구 사항을 읽고 필요할 때 API 키를 요청합니다.
2
요청 시 API 키 제공
Claude Code가 명시적으로 요청할 때만 키를 제공합니다. 서버 주소가 앱의 현재 Integration 섹션에서 온 것인지 확인하고, 출처가 불분명한 주소는 사용하지 마세요.
3
사용자 범위 설정 확인
Claude Code는 보통
claude mcp add로 사용자 범위에 서버(기본 이름 octoparse_datahub)를 추가하므로 모든 프로젝트에서 사용할 수 있습니다. 대신 프로젝트 범위의 .mcp.json 파일을 제안하면, 키가 프로젝트와 함께 커밋되지 않도록 사용자 범위를 요청하세요.4
서버 다시 로드
도구가 바로 나타나지 않으면 Claude Code에서
/mcp를 실행하여 서버 상태를 확인하거나 새 세션을 시작합니다. 서버가 여전히 없으면 Claude Code를 닫았다가 다시 엽니다.5단계: 첫 실제 호출
플랫폼, 필터, 수량을 포함하여 명확하고 구체적인 자연어로 요청합니다. 예시:1
Claude Code가 서버를 호출했는지 확인
대화의 도구 호출을 살펴봅니다. Data Hub 도구 호출이 나타나야만 Claude Code가 실제로 Data App에 접근한 것입니다.
2
데이터 결과 확인
레코드 수, 핵심 필드, 내용이 기대에 맞는지 확인합니다. 설명 텍스트만 받았다면 “방금 연결한 Data Hub 도구를 호출해”라고 명시적으로 요청하세요.
선택 사항: Claude Code가 여러 Data App을 사용하게 하기
하나의 워크플로에 여러 기능이 정말 필요하다면 여러 Data App을 하나의 MCP 연결에 묶는 사용자 정의 도구 세트를 만드세요.1
오픈 플랫폼에서 MCP connection 열기
Data Hub에서 오픈 플랫폼을 열고 MCP connection을 클릭한 뒤 사용자 정의 도구 세트 섹션을 엽니다.
2
필요한 Data App 추가
현재 흐름에 정말 필요한 앱만 선택합니다. 도구가 너무 많으면 Claude Code가 잘못된 도구를 고를 가능성이 커집니다.
3
다중 앱 설치 프롬프트 복사
도구 세트를 저장한 뒤 페이지가 현재 생성하는 전체 설치 프롬프트를 복사합니다.
4
Claude Code에 보내고 다시 로드
다중 앱 설치 프롬프트를 Claude Code에 보내고 안내에 따라 서버를 업데이트한 뒤 다시 로드합니다. 그런 다음 먼저 Claude Code에 사용 가능한 기능을 나열하게 하고 선택한 앱을 하나씩 테스트합니다.
자주 묻는 질문
서버는 추가됐는데 도구가 보이지 않아요
서버는 추가됐는데 도구가 보이지 않아요
/mcp를 실행하여 서버가 연결되었는지 확인한 뒤 새 세션을 시작하거나 Claude Code를 재시작합니다. 여전히 도구가 보이지 않으면 claude mcp list를 실행하고 서버 주소와 헤더를 설치 프롬프트와 비교하세요.인증되지 않았거나 API 키가 유효하지 않다고 나와요
인증되지 않았거나 API 키가 유효하지 않다고 나와요
키에 빠진 문자, 공백, 줄바꿈이 없고 여전히 유효한지 확인하세요. 이 페이지는 특정 앱 페이지에서 생성된 API 키 설정을 사용합니다. OAuth가 필요하면 범용 연결 페이지에서 생성된 설정을 대신 사용하세요.
Claude Code가 도구를 호출하지 않고 텍스트로만 답했어요
Claude Code가 도구를 호출하지 않고 텍스트로만 답했어요
요청에 “방금 연결한 Data Hub 도구를 사용해”라고 명시하고 앱이 지원하는 매개변수를 제공하세요. 먼저 Claude Code에 사용 가능한 도구를 나열하게 하여 서버가 로드되었는지 확인할 수도 있습니다.
브라우저에서는 결과가 나오는데 Claude Code 호출은 실패해요
브라우저에서는 결과가 나오는데 Claude Code 호출은 실패해요
브라우저에서 성공한 매개변수와 비교하세요. 서버 주소, API 키, 매개변수 형식을 하나씩 확인하고
/mcp에 표시된 오류를 읽습니다. 첫 검증에서는 요청 범위를 작게 유지하여 시간 초과를 연결 실패로 오해하지 않도록 하세요.도구 세트를 변경했는데 Claude Code에 여전히 이전 도구가 보여요
도구 세트를 변경했는데 Claude Code에 여전히 이전 도구가 보여요
새 도구 세트를 저장한 뒤 현재 설치 프롬프트를 다시 복사하고 Claude Code가 서버를 업데이트하게 한 다음 다시 로드하세요. 클라이언트는 도구 세트 변경을 자동으로 동기화하지 않습니다.
체크리스트
- 브라우저에서 소량의 데이터로 Data App을 성공적으로 실행했습니다.
- 앱의 현재 Integration 섹션에서 설치 프롬프트를 복사했습니다.
- API 키는 사용자 범위의 Claude Code 설정이나 자격 증명 도구에만 저장되어 있습니다.
/mcp에서 Data Hub 서버가 연결됨으로 표시되고 도구가 나타납니다.- 실제 도구 호출을 한 번 완료하고 레코드 수와 핵심 필드를 확인했습니다.
범용 연결
앱을 미리 고르지 않습니다. 연결한 뒤 에이전트가 알맞은 데이터 기능을 검색하고 실행하게 합니다.
Codex: 특정 앱 연결
Codex를 사용한다면 해당 클라이언트의 특정 앱 연결 전체 흐름을 참고하세요.