> ## 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.

# CodexにData Appを接続する

> Data Hubのカタログで固定のData Appを選び、生成されたインストールプロンプトでCodexに追加し、少量のテストで実際の呼び出しを完了する手順です。

このチュートリアルは、**使うData Appがすでに決まっている**方向けです。まずカタログでアプリを選んで試し、そのアプリのインストールプロンプトをコピーして、Codexに固定ツールとして使わせます。

<Note>
  このページは「先にアプリを選び、次に接続する」パターンです。どのアプリを選ぶかまだ決まっておらず、先にMCPを接続してエージェントに検索させたい場合は、<a href="/docs/jp/datahub/quick-start/agent-connection/general" target="_blank" rel="noopener noreferrer">汎用接続：エージェント内でアプリを選ぶ</a>を使ってください。
</Note>

<Note>
  このページでは企業情報補完（company enrichment）のData Appを例にします。企業名から業種、従業員数、本社所在地を返すアプリです。別のData Appを選ぶ場合、ページ名、入力パラメータ、返却フィールドは異なりますが、接続方法は同じです。
</Note>

## 完了後にできること

このチュートリアルを終えると、Codexで直接データの要件を説明し、CodexにData HubのData Appを呼び出させて、構造化された結果を受け取れます。MCP設定を手書きする必要はありません。

## 始める前に

次のものを用意してください。

* ログインできるOctoparseアカウント。
* インストールしてログイン済みのCodex。
* 明確で小規模なテスト目標（例：「3社の企業名に業種、従業員数、本社所在地を補完する」）。

<Warning>
  APIキーはアカウントの認証情報です。実際のキーをプロジェクトファイル、コードリポジトリ、公開スクリーンショット、グループチャットに絶対に含めないでください。Codexが明示的に認証情報を求めた時だけ提供します。
</Warning>

## ステップ1：Data Appを選んで試す

エージェントを接続する前に、ブラウザでData Appが要件を満たすことを確認します。後で呼び出しが失敗した時、問題がデータのパラメータにあるのかCodexの設定にあるのかをすぐに判断できます。

<Steps>
  <Step title="Octoparse Data Hubを開いてログインする">
    <a href="https://www.octoparse.jp/data-hub" target="_blank" rel="noopener noreferrer">Octoparse Data Hub</a>にアクセスし、右上のアカウント入口からログインします。
  </Step>

  <Step title="必要なData Appを見つける">
    検索やカテゴリフィルターで目的のアプリを探します。詳細ページでは、まず機能説明、入力パラメータ、出力フィールド、価格を読みます。アプリ名だけで適否を判断しないでください。
  </Step>

  <Step title="少量のデータでオンライン実行する">
    **今すぐ試す**をクリックし、必須パラメータを入力します。初回は少量のデータだけを要求します。実行完了後、ステータス、返却件数、主要フィールドを確認します。
  </Step>
</Steps>

ブラウザでの実行で結果が得られない場合は、先に入力パラメータを調整するか、別のData Appに変更してください。Codexの接続を急がないでください。

## ステップ2：Codexのインストールプロンプトをコピーする

Data Appの詳細ページで**連携**を開き、MCPを選んで**Copy install prompt**をクリックします。ページが生成した内容をそのままコピーします。**Copy MCP URL**はサーバーアドレスだけを取得するもので、手動でサーバーを追加したい場合に使います。サーバーアドレスを手で書き換えないでください。

<Tip>
  必要な機能が1つだけなら、単一のData Appを接続してください。Codexが正しいツールを選びやすくなり、トラブルシューティングも簡単になります。
</Tip>

## ステップ3：OctoparseのAPIキーを作成する

<Steps>
  <Step title="APIキーページを開く">
    <a href="https://www.octoparse.jp/console/account-center/api-keys" target="_blank" rel="noopener noreferrer">Octoparseアカウントセンター</a>に移動し、新しいキーを作成します。
  </Step>

  <Step title="新しいキーを一時的に保存する">
    キーの全文は通常、作成時に一度しか表示されません。信頼できるパスワードマネージャーに保存してください。設定完了後は、プレーンテキストファイルに残さないでください。
  </Step>
</Steps>

Data Appの詳細ページで生成される特定アプリ設定はAPIキーを使います。設定内の`Authorization: Bearer <API_KEY>`は、APIキーをヘッダーで渡す形式にすぎません。汎用接続はOAuthにも対応しています。2つのチュートリアルの設定スニペットを混在させないでください。

## ステップ4：Codexに接続を完了させる

<Steps>
  <Step title="インストールプロンプトをCodexに送る">
    新しいCodexの会話を開始し、コピーしたインストールプロンプト全文を貼り付けて送信します。Codexはサーバーアドレスと設定要件を読み取り、次に必要なものを説明します。
  </Step>

  <Step title="求められたらAPIキーを提供する">
    Codexが明示的に認証情報を求めた時だけ、作成したキーを提供します。Codexが編集しているのがプロジェクト内の共有ファイルではなく、現在のユーザーのMCP設定であることを確認してください。
  </Step>

  <Step title="設定結果を確認する">
    Codexは完了時に、書き込んだ設定ファイルと新しいサーバーの名前を伝えます。通常はユーザーレベルの`config.toml`を編集し、MCPの再読み込みまたはCodexの再起動を促します。
  </Step>

  <Step title="Codexを再読み込みする">
    Codexの案内に従ってMCPを再読み込みします。画面に再読み込みの入口がない場合は、Codexを閉じて開き直します。その後、下記の検証に進みます。
  </Step>
</Steps>

## ステップ5：最初の実際の呼び出しを行う

自然言語で何を照会したいかをCodexに伝え、明確な範囲を指定します。初回の呼び出しでは件数を制限してください。例：

```text theme={null} theme={null}
先ほど接続した企業情報補完ツールを使って、次の3社のリードに業種、従業員数、本社所在地を補完してください：Sansan、freee、SmartHR。
```

<Steps>
  <Step title="CodexがData Appを呼び出したことを確認する">
    会話内のツール呼び出しを確認します。Data Hubのツール呼び出しが表示されて初めて、Codexが自身の知識で回答したのではなく、実際にData Appを使ったと言えます。
  </Step>

  <Step title="返却結果を確認する">
    件数、フィールド、内容がブラウザでのテストと一致するか確認します。フィールドが空でも必ずしも失敗ではありません。まず、そのレコードの元データにそのフィールドがあるかを確認してください。
  </Step>
</Steps>

## オプション：Codexに複数のData Appを使わせる

1つのワークフローで本当に複数のデータ機能が必要な場合にのみ、複数アプリのツールセットを作成します。

<Steps>
  <Step title="オープンプラットフォームのMCP接続を開く">
    Data Hubからオープンプラットフォームを開き、**MCP接続**をクリックして、カスタムツールセットのセクションを開きます。
  </Step>

  <Step title="必要なData Appを選ぶ">
    現在のワークフローに本当に必要なアプリだけを追加します。一部のアプリ詳細ページには**関連Data Apps**のバンドル入口もあります。
  </Step>

  <Step title="複数アプリのインストールプロンプトをコピーして送る">
    ツールセットを保存し、ページが生成したインストールプロンプトをコピーしてCodexに送り、案内に従ってMCPを再読み込みします。
  </Step>

  <Step title="ツールを1つずつ検証する">
    まずCodexに利用可能なデータ機能を一覧させ、1回に1つのアプリだけをテストします。すべて合格したら、複数のアプリを連携させて複雑なタスクを実行します。
  </Step>
</Steps>

## よくある質問

<AccordionGroup>
  <Accordion title="Codexは設定成功と言うが、ツールが表示されない">
    MCPを再読み込みするか、Codexを再起動します。それでも表示されない場合は、ユーザーレベルの`config.toml`内のサーバーアドレスとヘッダーが完全か、同じユーザー設定を読み込んでいるかをCodexに確認させてください。
  </Accordion>

  <Accordion title="未認証またはAPIキーが無効と表示される">
    キーに欠けた文字、スペース、改行がなく、まだ有効であることを確認します。このページでは特定アプリページで生成されたAPIキー設定を使います。OAuthが必要な場合は、汎用接続ページで生成された設定を使ってください。
  </Accordion>

  <Accordion title="Codexがツールを呼び出さず、テキストで回答した">
    質問に「先ほど接続したData Hubツールを使ってください」と明記し、アプリが対応するパラメータを指定します。まずCodexに利用可能なツールを一覧させ、サーバーが読み込まれているか確認する方法もあります。
  </Accordion>

  <Accordion title="ブラウザでは結果が出るが、Codexの呼び出しは失敗する">
    ブラウザで成功したパラメータと比較し、サーバーアドレス、APIキー、パラメータ形式、Codexのログを1つずつ確認します。初回の検証ではリクエスト範囲を小さく保ち、タイムアウトを接続失敗と誤認しないようにします。
  </Accordion>

  <Accordion title="ツールセットを変更しても、Codexに古いツールが表示される">
    新しいツールセットを保存した後、現在のインストールプロンプトを再度コピーし、Codexに設定を更新させてからMCPを再読み込みします。クライアントはツールセットの変更を自動的に同期しません。
  </Accordion>
</AccordionGroup>

## チェックリスト

* ブラウザで少量のデータを使ってData Appの実行に成功した。
* アプリの現在の**連携**セクションからインストールプロンプトをコピーした。
* APIキーは信頼できるローカル設定または認証情報ツールにのみ保存している。
* CodexがMCPを再読み込みし、Data Hubのツールが表示されている。
* 実際のツール呼び出しを1回完了し、件数と主要フィールドを確認した。

<CardGroup cols={2}>
  <Card title="汎用接続" href="/docs/jp/datahub/quick-start/agent-connection/general">
    先にアプリを選びません。接続してから、エージェントに適切なデータ機能を検索・実行させます。
  </Card>

  <Card title="Claude Code：特定のアプリを接続" href="/docs/jp/datahub/quick-start/agent-connection/claude-code">
    Claude Codeを使う場合は、そのクライアント向けの特定アプリ接続の完全な流れを参照してください。
  </Card>
</CardGroup>
