> ## 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.
# Data Hub MCPをエージェントに接続する
> Data Appを事前に選ばずにData Hub MCPを接続し、タスクごとにエージェントが適切なデータ機能を検索・理解・実行できるようにする手順を解説します。
どのData Appを使うべきかまだ分からない場合や、タスクごとにエージェント自身に機能を探させたい場合は、このチュートリアルを使ってください。汎用接続では、Data Hubの検索ツールと実行ツールをエージェントに追加します。接続後は、必要なデータを説明するだけで、エージェントが適切なData Appを検索し、パラメータを確認し、承認を得てから実行します。
**汎用接続では、先にアプリを選ぶ必要はありません。** このチュートリアルと「Codex：特定のアプリを接続」「Claude Code：特定のアプリを接続」は、2つの異なる使い方です。特定アプリ接続は、目的が明確で長期的に固定の機能だけを使うケースに向いています。汎用接続は、ニーズが変わるケースや、アプリをまだ決めていないケースに向いています。
## 2つの接続方法を理解する
| 方法 | 操作の順序 | 適したケース |
| ----------- | ------------------------------------------------------ | --------------------------------------------------- |
| **汎用接続** | Data Hub MCPを接続 → エージェント内でアプリを検索 → 詳細を確認 → 選択して実行 | どのアプリを選ぶか分からない。タスクごとに異なるデータ機能が必要。エージェントに探索を手伝ってほしい。 |
| **特定アプリ接続** | カタログでアプリを選ぶ → そのアプリのインストールプロンプトをコピー → エージェントを接続 → 直接実行 | 固定のアプリが決まっている。ツールの範囲を絞りたい。安定した繰り返しの業務プロセスで使う。 |
どちらの方法も、呼び出すのはData Hub上の同じData Appです。違いは「どこでアプリを選ぶか」だけです。両方の接続を保持することもできますが、エージェントがツールを間違えないよう、識別しやすい名前を付けてください。
## 完了後にできること
このチュートリアルを終えると、エージェント内で次の操作を順に行えます。
1. キーワード、プラットフォーム、シーンでData Appを検索する。
2. アプリの用途、入力パラメータ、出力フィールド、課金を確認する。
3. アプリとパラメータを確認してから実行を開始する。
4. 非同期タスクのステータスを照会し、最終結果を取得する。
`search_data_apps`、`run_data_app`、非同期ステータスの照会、大きな結果の`handoff`の完全なパラメータと処理ルールは、Data Hub MCPの機能を参照してください。このページは接続と初回利用の流れに絞って説明します。
## 始める前に
次のものを用意してください。
* ログインできるOctoparseアカウント。
* Streamable HTTP MCPに対応したエージェントクライアント（Claude Code、Codex、Cursorなど）。
* APIキー方式を選ぶ場合：事前にOctoparseのAPIキーを作成しておく。
* テスト用の簡単なデータ対象（例：「企業情報を補完できるData Appを探す」）。
APIキーはアカウントの認証情報です。実際のキーをコードリポジトリ、共有設定、公開スクリーンショット、グループチャットに絶対に含めないでください。OAuth方式では、ブラウザセッションの一時的なアクセストークンをローカル設定にコピーしないでください。
## ステップ1：汎用MCP接続を開く
Octoparse公式サイトにログインし、上部のData Hubメニューから**Data Hubオープンプラットフォーム**をクリックします。
オープンプラットフォームの左側ナビゲーションで**MCP接続**をクリックし、Data Hub MCP Serverページを開きます。ページに表示されるデフォルトのツールセットは、Data Hub上のあらゆるData Appを検索・実行できます。Data Hubで事前にアプリを選ぶ必要はありません。
各Data Appの**連携**セクションの下部にもMCP接続へのリンクがあり、ここに移動できます。このリンクは近道にすぎず、そのアプリを先に選ばなければならないという意味ではありません。
## ステップ2：認証方式を選ぶ
汎用接続はAPIキーとOAuthの両方に対応しています。この選択は認証にのみ影響し、Data Appの検索や実行の方法は変わりません。
### 方式1：APIキー（推奨）
長期的な安定運用、コマンドラインクライアント、自動化に最適です。ページが生成する設定には次の内容が含まれます。
```text theme={null} theme={null}
Authorization: Bearer
```
`Bearer`はAPIキーを渡すためのヘッダー形式にすぎません。ログイン済みブラウザセッションの一時的なアクセストークンではなく、OctoparseのAPIキーを使ってください。
まだキーがない場合は、Octoparseアカウントセンターで作成します。APIキーの全文は通常、作成時に一度しか表示されません。信頼できるパスワードマネージャーに保存してください。
### 方式2：OAuthログイン
MCP OAuthに対応した対話型クライアントに最適です。OAuthを選ぶと、設定にAPIキーは含まれません。クライアントの初回接続時にブラウザが開き、Octoparseアカウントでログインして認可を確認します。セッションは期限切れになることがあり、その場合は再度認可します。
## ステップ3：汎用インストールプロンプトをコピーする
**MCP接続**ページでエージェントクライアントと認証方式を選び、**Copy install prompt**をクリックします。**Copy MCP URL**はサーバーアドレスだけを取得します。ページがその時点で生成した内容をそのままコピーしてください。サーバーアドレス、ツール範囲、ヘッダーを記憶で手入力しないでください。
ページに表示される汎用サーバーアドレスは`https://mcp-v2.octoparse.com`をベースにしています。具体的な設定やツールパラメータは変更される可能性があるため、常にオープンプラットフォームが現在生成する内容を使ってください。
## ステップ4：エージェントに設定を完了させる
以下の例ではClaude Codeを使います。CodexやCursorではボタンの位置が異なりますが、基本の手順は同じです。インストールプロンプトを貼り付け、認証方式を選び、現在のユーザーのMCP設定の変更を許可し、クライアントを再読み込みします。
新しい会話を開始し、コピーしたプロンプト全文を貼り付けます。エージェントは設定を書き込む前に認証方式を尋ねるはずです。プロジェクトファイルに認証情報を書き込もうとした場合は、すぐに止めて、現在のユーザーのローカルMCP設定に変更するよう求めてください。
APIキーを選んだ場合は、エージェントの求めに応じて安全にキーを提供します。OAuthを選んだ場合は、キーを一切提供せず、認証情報なしの設定を書き込ませます。
設定完了後、MCPサーバーを再読み込みするか、クライアントを再起動します。OAuthの場合、初回接続で「認証が必要」と表示されることがありますが、これは正常です。
## ステップ5：OAuth認可を完了する（OAuthのみ）
APIキーを選んだ場合は、次のステップに進んでください。
Claude Codeでは`/mcp`を実行し、追加したData Hubサーバー（デフォルト名は`octoparse_datahub`）を選択します。認証が必要と表示されたら、認証を選びます。他のクライアントでは、MCP設定に**接続**などのボタンが表示されます。
ブラウザにOctoparseの認証ページが開きます。ドメインと現在のアカウントを確認し、要求される権限範囲を読んでから承認します。ページの案内に従ってクライアントに戻ります。自動で戻るクライアントもあります。
クライアントに戻り、「認証が必要」の表示が消え、サーバーが有効になっていることを確認します。まだ未認証と表示される場合は、クライアントを再読み込みしてもう一度試してください。
## ステップ6：まず検索し、すぐには実行しない
汎用接続のポイントは、まずエージェントにData Appを発見させることです。初回は、検索と比較だけを行い、課金されるタスクをまだ作成しないよう明示的に指示してください。例：
```text theme={null} theme={null}
Data Hubで「企業情報補完」に関連するData Appを検索してください。
関連度の高い3件を挙げ、それぞれの用途、必要な入力、主な出力フィールド、課金方式を説明してください。
まだ実行しないでください。私の確認を待ってください。
```
エージェントは通常、`search_data_apps`でカタログを検索し、続いて`get_data_app_details`で候補アプリの完全な契約を確認します。
エージェントが見つけるアプリの数、名前、対応プラットフォームは、Data Hubのカタログの状況に応じてリアルタイムに変わります。このドキュメントでは固定のリストを提供しません。実際に`search_data_apps`が返す内容を参照してください。
## ステップ7：アプリを確認してから実行する
候補から1つのアプリを選びます。エージェントにパラメータと予定している操作を復唱させてから、小規模なテストを実行します。
```text theme={null} theme={null}
1番目のData Appを選びます。まず必須パラメータ、デフォルト値、課金方式を教えてください。
私が確認したら、最小限のデータ量だけで実行し、タスクのステータス、結果件数、先頭5件のデータを返してください。
```
必須パラメータ、データ範囲、返却フィールド、課金単位を確認します。不明な点があれば、パラメータを推測せず、エージェントに詳細ツールを再度呼び出させてください。
確認後にのみ、エージェントに`run_data_app`を呼び出させます。同期アプリは結果を直接返します。非同期アプリは続けてステータスを照会する必要があります。
非同期タスクでは、エージェントにステータスツールと結果ツールで完了を待たせてから最終データを返させます。「タスクを送信した」だけで収集成功と判断しないでください。
タスクのステータス、実際の件数、主要フィールドを確認します。個別のレコードでフィールドが欠けているのは、元データの違いによる可能性があります。大半のレコードが期待と異なる場合は、アプリの変更やパラメータの調整を検討してください。
## よくある質問
いいえ。汎用接続はまず検索ツールと実行ツールを提供し、接続後にエージェントが`search_data_apps`で機能を探します。Data Hubで先にアプリを選ぶ必要があるのは「特定アプリ接続」だけです。
長期利用、コマンドライン、自動化フローではAPIキーを優先してください。ブラウザでログインしたく、クライアントがMCP OAuthに明確に対応している場合はOAuthを選べます。OAuthのセッションは期限切れになり、再認可が必要になることがあります。
特定アプリの制限付き設定ではなく、オープンプラットフォームの**MCP接続**ページで生成した汎用設定を使っているか確認してください。現在のプロンプトをコピーし直し、クライアントを再読み込みします。
クライアントのMCP設定で接続を開始し、ブラウザでログインと認可を完了してからクライアントに戻ります。ブラウザがリダイレクトをブロックしていないか確認し、認可ページのドメインがOctoparse公式の認証サービスであることを確認してください。
プロンプトに「検索と比較だけを行い、まだ実行しない」と明記してください。費用や大量データが関わる場合は、`run_data_app`を呼び出す前に確認を待つようエージェントに求めてください。
そのアプリは非同期実行の可能性があります。エージェントにタスクのステータスを照会し続けさせ、完了後に結果を取得させてください。同じタスクを再送信しないでください。
## チェックリスト
* Data Hubオープンプラットフォームの**MCP接続**ページから汎用インストールプロンプトをコピーした。
* APIキーまたはOAuthのどちらかを明確に選び、2種類の認証情報を混在させていない。
* エージェントがData Hubの汎用ツールを読み込み、`search_data_apps`を使える。
* 先に検索とアプリ詳細の確認を行ってから実行を承認した。
* 最小限のデータ量で実際の呼び出しを1回完了し、最終結果を確認した。
## 使うアプリが決まっている場合
業務で長期的に固定のアプリを使う場合は、接続範囲を絞れます。
先に具体的なアプリを選び、固定ツールとしてCodexに追加します。
先に具体的なアプリを選び、固定のMCPサーバーとしてClaude Codeに追加します。
検索で返されるアプリの数、名前、発行者、価格はData Hubのカタログの状況に応じて変わります。各呼び出しでツールが返す内容を参照してください。