Skip to main content
このチュートリアルは、使うData Appがすでに決まっている方向けです。まずカタログでアプリを選んで試し、そのアプリのインストールプロンプトをコピーして、Codexに固定ツールとして使わせます。
このページは「先にアプリを選び、次に接続する」パターンです。どのアプリを選ぶかまだ決まっておらず、先にMCPを接続してエージェントに検索させたい場合は、汎用接続：エージェント内でアプリを選ぶを使ってください。
このページでは企業情報補完（company enrichment）のData Appを例にします。企業名から業種、従業員数、本社所在地を返すアプリです。別のData Appを選ぶ場合、ページ名、入力パラメータ、返却フィールドは異なりますが、接続方法は同じです。

​
完了後にできること

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

​
始める前に

次のものを用意してください。
  • ログインできるOctoparseアカウント。
  • インストールしてログイン済みのCodex。
  • 明確で小規模なテスト目標（例：「3社の企業名に業種、従業員数、本社所在地を補完する」）。
APIキーはアカウントの認証情報です。実際のキーをプロジェクトファイル、コードリポジトリ、公開スクリーンショット、グループチャットに絶対に含めないでください。Codexが明示的に認証情報を求めた時だけ提供します。

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

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

Octoparse Data Hubを開いてログインする

Octoparse Data Hubにアクセスし、右上のアカウント入口からログインします。
2

必要なData Appを見つける

検索やカテゴリフィルターで目的のアプリを探します。詳細ページでは、まず機能説明、入力パラメータ、出力フィールド、価格を読みます。アプリ名だけで適否を判断しないでください。
3

少量のデータでオンライン実行する

今すぐ試すをクリックし、必須パラメータを入力します。初回は少量のデータだけを要求します。実行完了後、ステータス、返却件数、主要フィールドを確認します。
ブラウザでの実行で結果が得られない場合は、先に入力パラメータを調整するか、別のData Appに変更してください。Codexの接続を急がないでください。

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

Data Appの詳細ページで連携を開き、MCPを選んでCopy install promptをクリックします。ページが生成した内容をそのままコピーします。Copy MCP URLはサーバーアドレスだけを取得するもので、手動でサーバーを追加したい場合に使います。サーバーアドレスを手で書き換えないでください。
必要な機能が1つだけなら、単一のData Appを接続してください。Codexが正しいツールを選びやすくなり、トラブルシューティングも簡単になります。

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

1

APIキーページを開く

Octoparseアカウントセンターに移動し、新しいキーを作成します。
2

新しいキーを一時的に保存する

キーの全文は通常、作成時に一度しか表示されません。信頼できるパスワードマネージャーに保存してください。設定完了後は、プレーンテキストファイルに残さないでください。
Data Appの詳細ページで生成される特定アプリ設定はAPIキーを使います。設定内のAuthorization: Bearer <API_KEY>は、APIキーをヘッダーで渡す形式にすぎません。汎用接続はOAuthにも対応しています。2つのチュートリアルの設定スニペットを混在させないでください。

​
ステップ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つのワークフローで本当に複数のデータ機能が必要な場合にのみ、複数アプリのツールセットを作成します。
1

オープンプラットフォームのMCP接続を開く

Data Hubからオープンプラットフォームを開き、MCP接続をクリックして、カスタムツールセットのセクションを開きます。
2

必要なData Appを選ぶ

現在のワークフローに本当に必要なアプリだけを追加します。一部のアプリ詳細ページには関連Data Appsのバンドル入口もあります。
3

複数アプリのインストールプロンプトをコピーして送る

ツールセットを保存し、ページが生成したインストールプロンプトをコピーしてCodexに送り、案内に従ってMCPを再読み込みします。
4

ツールを1つずつ検証する

まずCodexに利用可能なデータ機能を一覧させ、1回に1つのアプリだけをテストします。すべて合格したら、複数のアプリを連携させて複雑なタスクを実行します。

​
よくある質問

MCPを再読み込みするか、Codexを再起動します。それでも表示されない場合は、ユーザーレベルのconfig.toml内のサーバーアドレスとヘッダーが完全か、同じユーザー設定を読み込んでいるかをCodexに確認させてください。
キーに欠けた文字、スペース、改行がなく、まだ有効であることを確認します。このページでは特定アプリページで生成されたAPIキー設定を使います。OAuthが必要な場合は、汎用接続ページで生成された設定を使ってください。
質問に「先ほど接続したData Hubツールを使ってください」と明記し、アプリが対応するパラメータを指定します。まずCodexに利用可能なツールを一覧させ、サーバーが読み込まれているか確認する方法もあります。
ブラウザで成功したパラメータと比較し、サーバーアドレス、APIキー、パラメータ形式、Codexのログを1つずつ確認します。初回の検証ではリクエスト範囲を小さく保ち、タイムアウトを接続失敗と誤認しないようにします。
新しいツールセットを保存した後、現在のインストールプロンプトを再度コピーし、Codexに設定を更新させてからMCPを再読み込みします。クライアントはツールセットの変更を自動的に同期しません。

​
チェックリスト

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

汎用接続

先にアプリを選びません。接続してから、エージェントに適切なデータ機能を検索・実行させます。

Claude Code：特定のアプリを接続

Claude Codeを使う場合は、そのクライアント向けの特定アプリ接続の完全な流れを参照してください。