> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code에 Data App 연결하기

> Data Hub 목록에서 고정 Data App을 고르고, 생성된 설치 프롬프트로 Claude Code에 MCP 서버로 추가한 뒤, 실제 호출을 검증하는 방법을 안내합니다.

이 튜토리얼은 **사용할 Data App을 이미 알고 있는** 사용자를 위한 것입니다. 먼저 Data Hub에서 앱을 고르고 테스트한 뒤, 해당 앱의 설치 프롬프트를 복사하여 Claude Code에 고정 MCP 서버로 추가합니다.

<Note>
  이 페이지는 "앱을 먼저 고른 뒤 연결" 방식을 따릅니다. 어떤 앱을 고를지 아직 모르고 MCP를 먼저 연결한 뒤 에이전트가 검색하게 하고 싶다면 <a href="/docs/ko/datahub/quick-start/agent-connection/general" target="_blank" rel="noopener noreferrer">범용 연결: 에이전트 안에서 앱 선택하기</a>를 대신 사용하세요.
</Note>

<Note>
  Claude Code와 Codex는 같은 Data Hub MCP 기능을 사용합니다. 차이는 각 클라이언트가 MCP 설정을 저장하고 서버 상태를 표시하는 방식뿐입니다. Data App 자체는 바뀌지 않습니다.
</Note>

## 완료 후 할 수 있는 일

이 튜토리얼을 마치면 Claude Code에서 데이터 요구를 직접 설명하고 Data Hub의 Data App을 호출하여 구조화된 데이터를 가져올 수 있습니다. 이 페이지는 단일 Data App과 여러 Data App을 연결하는 방법도 다룹니다.

## 시작하기 전에

다음을 준비하세요.

* 로그인할 수 있는 Octoparse 계정.
* 설치되고 로그인된 Claude Code.
* 명확하고 작은 테스트 목표(대상 플랫폼, 키워드, 레코드 수 등).

<Warning>
  API 키는 계정 자격 증명입니다. 실제 키를 프로젝트 파일, 코드 저장소, 공개 스크린샷, 그룹 채팅에 절대 넣지 마세요. Claude Code가 명시적으로 자격 증명을 요청할 때만 제공하세요.
</Warning>

## 1단계: Data App 선택 및 테스트

먼저 브라우저에서 앱의 입력과 출력을 확인한 뒤 Claude Code를 연결합니다. 나중에 문제가 생기면 매개변수가 잘못되었는지 서버 설정이 잘못되었는지 빠르게 판단할 수 있습니다.

<Steps>
  <Step title="Octoparse Data Hub 열기 및 로그인">
    <a href="https://www.octoparse.kr/data-hub" target="_blank" rel="noopener noreferrer">Octoparse Data Hub</a>로 이동하여 오른쪽 상단의 계정 진입점으로 로그인합니다.
  </Step>

  <Step title="대상 Data App 선택">
    검색이나 카테고리로 대상 앱을 찾습니다. 상세 페이지에서 기능 설명, 필수 매개변수, 반환 필드, 가격을 꼼꼼히 읽고 작업에 적합한지 확인합니다.
  </Step>

  <Step title="온라인에서 한 번 실행">
    **Try It Now**를 클릭하고 페이지 안내에 따라 매개변수를 입력합니다. 처음에는 소량의 데이터만 요청합니다. 실행이 끝나면 상태, 레코드 수, 핵심 필드를 확인합니다.
  </Step>
</Steps>

브라우저 실행에서 결과가 없으면 먼저 매개변수를 조정하거나 다른 Data App으로 바꾸세요. 브라우저 실행이 성공한 뒤에만 Claude Code로 진행합니다.

## 2단계: Claude Code 설치 프롬프트 복사

Data App 상세 페이지에서 **Integration**을 열고 MCP를 선택한 뒤 **Copy install prompt**를 클릭합니다. **Copy MCP URL**은 서버 주소만 제공하며, `claude mcp add`를 직접 실행하려는 경우에 사용합니다. 상세 페이지 사이드바의 MCP 링크로도 빠르게 이동할 수 있습니다.

<Tip>
  첫 연결에서는 Data App 하나만 선택하세요. 도구가 적을수록 Claude Code가 올바른 기능을 더 쉽게 고르고 문제 해결도 간단해집니다.
</Tip>

## 3단계: Octoparse API 키 생성

<Steps>
  <Step title="API 키 페이지 열기">
    <a href="https://www.octoparse.kr/console/open-platform/api-keys" target="_blank" rel="noopener noreferrer">Octoparse 계정 센터</a>로 이동하여 새 API 키를 생성합니다.
  </Step>

  <Step title="API 키 안전하게 보관">
    키 전체는 보통 생성 시 한 번만 표시됩니다. 신뢰할 수 있는 비밀번호 관리자에 임시로 보관하세요. 프로젝트 디렉터리나 공유 문서에 저장하지 마세요.
  </Step>
</Steps>

Data App 상세 페이지에서 생성되는 특정 앱 설정은 API 키를 사용합니다. 설정의 `Authorization: Bearer <API_KEY>` 줄은 API 키의 헤더 형식입니다. 범용 연결은 OAuth도 지원합니다. 두 튜토리얼의 설정 조각을 섞지 마세요.

## 4단계: Claude Code에 서버 추가

<Steps>
  <Step title="설치 프롬프트를 Claude Code에 보내기">
    새 Claude Code 세션을 시작하고 복사한 전체 설치 프롬프트를 붙여넣어 보냅니다. Claude Code는 서버 주소와 설정 요구 사항을 읽고 필요할 때 API 키를 요청합니다.
  </Step>

  <Step title="요청 시 API 키 제공">
    Claude Code가 명시적으로 요청할 때만 키를 제공합니다. 서버 주소가 앱의 현재 **Integration** 섹션에서 온 것인지 확인하고, 출처가 불분명한 주소는 사용하지 마세요.
  </Step>

  <Step title="사용자 범위 설정 확인">
    Claude Code는 보통 `claude mcp add`로 사용자 범위에 서버(기본 이름 `octoparse_datahub`)를 추가하므로 모든 프로젝트에서 사용할 수 있습니다. 대신 프로젝트 범위의 `.mcp.json` 파일을 제안하면, 키가 프로젝트와 함께 커밋되지 않도록 사용자 범위를 요청하세요.
  </Step>

  <Step title="서버 다시 로드">
    도구가 바로 나타나지 않으면 Claude Code에서 `/mcp`를 실행하여 서버 상태를 확인하거나 새 세션을 시작합니다. 서버가 여전히 없으면 Claude Code를 닫았다가 다시 엽니다.
  </Step>
</Steps>

## 5단계: 첫 실제 호출

플랫폼, 필터, 수량을 포함하여 명확하고 구체적인 자연어로 요청합니다. 예시:

```text theme={null} theme={null}
방금 연결한 Data Hub 도구로 다음 세 리드에 업종, 직원 수, 본사 위치를 보강해 줘: 토스, 당근마켓, 배달의민족.
```

<Steps>
  <Step title="Claude Code가 서버를 호출했는지 확인">
    대화의 도구 호출을 살펴봅니다. Data Hub 도구 호출이 나타나야만 Claude Code가 실제로 Data App에 접근한 것입니다.
  </Step>

  <Step title="데이터 결과 확인">
    레코드 수, 핵심 필드, 내용이 기대에 맞는지 확인합니다. 설명 텍스트만 받았다면 "방금 연결한 Data Hub 도구를 호출해"라고 명시적으로 요청하세요.
  </Step>
</Steps>

## 선택 사항: Claude Code가 여러 Data App을 사용하게 하기

하나의 워크플로에 여러 기능이 정말 필요하다면 여러 Data App을 하나의 MCP 연결에 묶는 사용자 정의 도구 세트를 만드세요.

<Steps>
  <Step title="오픈 플랫폼에서 MCP connection 열기">
    Data Hub에서 오픈 플랫폼을 열고 **MCP connection**을 클릭한 뒤 사용자 정의 도구 세트 섹션을 엽니다.
  </Step>

  <Step title="필요한 Data App 추가">
    현재 흐름에 정말 필요한 앱만 선택합니다. 도구가 너무 많으면 Claude Code가 잘못된 도구를 고를 가능성이 커집니다.
  </Step>

  <Step title="다중 앱 설치 프롬프트 복사">
    도구 세트를 저장한 뒤 페이지가 현재 생성하는 전체 설치 프롬프트를 복사합니다.
  </Step>

  <Step title="Claude Code에 보내고 다시 로드">
    다중 앱 설치 프롬프트를 Claude Code에 보내고 안내에 따라 서버를 업데이트한 뒤 다시 로드합니다. 그런 다음 먼저 Claude Code에 사용 가능한 기능을 나열하게 하고 선택한 앱을 하나씩 테스트합니다.
  </Step>
</Steps>

## 자주 묻는 질문

<AccordionGroup>
  <Accordion title="서버는 추가됐는데 도구가 보이지 않아요">
    `/mcp`를 실행하여 서버가 연결되었는지 확인한 뒤 새 세션을 시작하거나 Claude Code를 재시작합니다. 여전히 도구가 보이지 않으면 `claude mcp list`를 실행하고 서버 주소와 헤더를 설치 프롬프트와 비교하세요.
  </Accordion>

  <Accordion title="인증되지 않았거나 API 키가 유효하지 않다고 나와요">
    키에 빠진 문자, 공백, 줄바꿈이 없고 여전히 유효한지 확인하세요. 이 페이지는 특정 앱 페이지에서 생성된 API 키 설정을 사용합니다. OAuth가 필요하면 범용 연결 페이지에서 생성된 설정을 대신 사용하세요.
  </Accordion>

  <Accordion title="Claude Code가 도구를 호출하지 않고 텍스트로만 답했어요">
    요청에 "방금 연결한 Data Hub 도구를 사용해"라고 명시하고 앱이 지원하는 매개변수를 제공하세요. 먼저 Claude Code에 사용 가능한 도구를 나열하게 하여 서버가 로드되었는지 확인할 수도 있습니다.
  </Accordion>

  <Accordion title="브라우저에서는 결과가 나오는데 Claude Code 호출은 실패해요">
    브라우저에서 성공한 매개변수와 비교하세요. 서버 주소, API 키, 매개변수 형식을 하나씩 확인하고 `/mcp`에 표시된 오류를 읽습니다. 첫 검증에서는 요청 범위를 작게 유지하여 시간 초과를 연결 실패로 오해하지 않도록 하세요.
  </Accordion>

  <Accordion title="도구 세트를 변경했는데 Claude Code에 여전히 이전 도구가 보여요">
    새 도구 세트를 저장한 뒤 현재 설치 프롬프트를 다시 복사하고 Claude Code가 서버를 업데이트하게 한 다음 다시 로드하세요. 클라이언트는 도구 세트 변경을 자동으로 동기화하지 않습니다.
  </Accordion>
</AccordionGroup>

## 체크리스트

* 브라우저에서 소량의 데이터로 Data App을 성공적으로 실행했습니다.
* 앱의 현재 **Integration** 섹션에서 설치 프롬프트를 복사했습니다.
* API 키는 사용자 범위의 Claude Code 설정이나 자격 증명 도구에만 저장되어 있습니다.
* `/mcp`에서 Data Hub 서버가 연결됨으로 표시되고 도구가 나타납니다.
* 실제 도구 호출을 한 번 완료하고 레코드 수와 핵심 필드를 확인했습니다.

<CardGroup cols={2}>
  <Card title="범용 연결" href="/docs/ko/datahub/quick-start/agent-connection/general">
    앱을 미리 고르지 않습니다. 연결한 뒤 에이전트가 알맞은 데이터 기능을 검색하고 실행하게 합니다.
  </Card>

  <Card title="Codex: 특정 앱 연결" href="/docs/ko/datahub/quick-start/agent-connection/codex">
    Codex를 사용한다면 해당 클라이언트의 특정 앱 연결 전체 흐름을 참고하세요.
  </Card>
</CardGroup>