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