Skip to main content
このチュートリアルは、使うData Appがすでに決まっている方向けです。まずカタログでアプリを選んで試し、そのアプリのインストールプロンプトをコピーして、Claude Codeに固定のMCPサーバーとして追加します。
このページは「先にアプリを選び、次に接続する」パターンです。どのアプリを選ぶかまだ決まっておらず、先にMCPを接続してエージェントに検索させたい場合は、汎用接続：エージェント内でアプリを選ぶを使ってください。
Claude CodeとCodexは同じData Hub MCPの機能を使います。違いは、各クライアントがMCP設定をどこに保存し、サーバーの状態をどう表示するかだけです。Data App自体は変わりません。

​
完了後にできること

このチュートリアルを終えると、Claude Codeで直接データの要件を説明し、Data HubのData Appを呼び出して構造化データを取得できます。このページでは、単一のData Appと複数のData Appの接続方法の両方を説明します。

​
始める前に

次のものを用意してください。
  • ログインできるOctoparseアカウント。
  • インストールしてログイン済みのClaude Code。
  • 明確で小規模なテスト目標（対象プラットフォーム、キーワード、件数など）。
APIキーはアカウントの認証情報です。実際のキーをプロジェクトファイル、コードリポジトリ、公開スクリーンショット、グループチャットに絶対に含めないでください。Claude Codeが明示的に認証情報を求めた時だけ提供します。

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

まずブラウザでアプリの入出力を確認してから、Claude Codeを接続します。後で問題が起きた時、パラメータが誤っているのかサーバーの設定が不適切なのかをすぐに判断できます。
1

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

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

目的のData Appを選ぶ

検索やカテゴリで目的のアプリを探します。詳細ページで機能説明、必須パラメータ、返却フィールド、価格をよく読み、タスクに適しているか確認します。
3

オンラインで1回実行する

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

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

Data Appの詳細ページで連携を開き、MCPを選んでCopy install promptをクリックします。Copy MCP URLはサーバーアドレスだけを取得するもので、claude mcp addを手動で実行したい場合に使います。詳細ページのサイドバーにあるMCPリンクからも素早くアクセスできます。
初回の接続では、Data Appを1つだけ選んでください。ツールが少ないほどClaude Codeが正しい機能を選びやすくなり、トラブルシューティングも簡単になります。

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

1

APIキーページを開く

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

APIキーを安全に保存する

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

​
ステップ4：Claude Codeにサーバーを追加する

1

インストールプロンプトをClaude Codeに送る

新しいClaude Codeセッションを開始し、コピーしたインストールプロンプト全文を貼り付けて送信します。Claude Codeはサーバーアドレスと設定要件を読み取り、必要に応じてAPIキーを求めます。
2

求められたらAPIキーを提供する

Claude Codeが明示的に求めた時だけキーを提供します。サーバーアドレスがアプリの現在の連携セクションのものであることを確認し、出所不明のアドレスは使わないでください。
3

ユーザースコープの設定を確認する

Claude Codeは通常、claude mcp addでユーザースコープにサーバー（デフォルト名はoctoparse_datahub）を追加するため、すべてのプロジェクトで利用できます。代わりにプロジェクトスコープの.mcp.jsonファイルを提案された場合は、キーがプロジェクトと一緒にコミットされないよう、ユーザースコープを求めてください。
4

サーバーを再読み込みする

ツールがすぐに表示されない場合は、Claude Codeで/mcpを実行してサーバーの状態を確認するか、新しいセッションを開始します。それでもサーバーがない場合は、Claude Codeを閉じて開き直します。

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

プラットフォーム、絞り込み条件、件数を含めて、明確で具体的な自然言語で要求を伝えます。例：
1

Claude Codeがサーバーを呼び出したことを確認する

会話内のツール呼び出しを確認します。Data Hubのツール呼び出しが表示されて初めて、Claude Codeが実際にData Appにアクセスしたと言えます。
2

データ結果を確認する

件数、主要フィールド、内容が期待どおりか確認します。説明文だけが返ってきた場合は、「先ほど接続したData Hubツールを呼び出してください」と明示的に指示します。

​
オプション：Claude Codeに複数のData Appを使わせる

1つのワークフローで本当に複数の機能が必要な場合は、複数のData Appを1つのMCP接続にまとめるカスタムツールセットを作成します。
1

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

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

必要なData Appを追加する

現在のフローに本当に必要なアプリだけを選びます。ツールが多すぎると、Claude Codeが誤ったツールを選ぶ可能性が高まります。
3

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

ツールセットを保存し、ページが現在生成しているインストールプロンプト全文をコピーします。
4

Claude Codeに送って再読み込みする

複数アプリのインストールプロンプトをClaude Codeに送り、案内に従ってサーバーを更新して再読み込みします。その後、まずClaude Codeに利用可能な機能を一覧させ、選んだアプリを1つずつテストします。

​
よくある質問

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

​
チェックリスト

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

汎用接続

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

Codex：特定のアプリを接続

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