BatchData MCP (Real Estate & Contact Data)

BatchData リモート MCP サーバー セットアップガイド

• 1 はじめに
• 2 認証方法
  • 2.1 OAuth 認証 (推奨)
  • 2.2 API トークン認証 (代替手段)
• 3 今後の拡張: OAuth アクセス制御 (近日公開)
• 4 OAuth セットアップ (推奨)
  • 4.1 前提条件
  • 4.2 Claude セットアップ (デスクトップ、Web、モバイル)
    • 4.2.1 ステップ 1: BatchData コネクタの追加
    • 4.2.2 ステップ 2: 認証
    • 4.2.3 ステップ 3: コネクタの有効化
    • 4.2.4 ステップ 4: 初回ツール使用の承認
    • 4.2.5 モバイルでの使用
    • 4.2.6 以降の接続
  • 4.3 Cursor セットアップ
  • 4.4 Claude Code セットアップ
  • 4.5 ChatGPT セットアップ (開発者モード)
    • 4.5.1 前提条件
    • 4.5.2 ステップ 1: 開発者モードの有効化
    • 4.5.3 ステップ 2: BatchData コネクタの作成
    • 4.5.4 ステップ 3: 認証
    • 4.5.5 ChatGPT での BatchData ツールの使用
    • 4.5.6 接続の管理
  • 4.6 検証
• 5 API トークン セットアップ (代替手段)
  • 5.1 前提条件
  • 5.2 API トークンを使用した Claude Desktop セットアップ
    • 5.2.1 ステップ 1: Node.js 22 のインストール
    • 5.2.2 ステップ 2: Claude Desktop の設定
  • 5.3 カスタム MCP クライアント セットアップ
• 6 API トークンから OAuth への移行
  • 6.1 Claude Desktop
  • 6.2 Claude Code
  • 6.3 ChatGPT
  • 6.4 移行のメリット
• 7 利用可能なツール
  • 7.1 物件検索と詳細
  • 7.2 比較物件分析
  • 7.3 物件検索
  • 7.4 連絡先情報
  • 7.5 電話番号検証
  • 7.6 住所処理
• 8 トラブルシューティング
  • 8.1 OAuth の問題
  • 8.2 ChatGPT の問題
  • 8.3 API トークンの問題
  • 8.4 一般的な問題
  • 8.5 ヘルプの利用

はじめに

このガイドでは、MCP 互換クライアントを使用して BatchData リモート MCP サーバーに接続する方法について説明します。

認証方法

BatchData MCP サーバーは、2 つの認証方法をサポートしています。

方法	セットアップの複雑さ	セキュリティ	推奨対象
OAuth (推奨)	シンプル	高	ほとんどのユーザー
API トークン	手動設定	中程度	カスタム MCP クライアント、デバッグ

OAuth 認証 (推奨)

OAuth は、合理化された接続エクスペリエンスを提供します。

• API トークンの設定が不要 — サーバー URL を指定するだけです
• ブラウザベースのログイン — BatchData アカウントの認証情報で認証します
• 自動トークン管理 — アクセストークンは自動的に更新されます
• 使い慣れたログインエクスペリエンス — メール/パスワードまたは Google サインインを使用します

API トークン認証 (代替手段)

直接 API トークンを設定したい場合や、OAuth をサポートしていないカスタム MCP クライアントを使用しているユーザー向けです。

• BatchData API トークンを手動で取得して設定する必要があります
• トークンは機密情報として管理および保護する必要があります
• デバッグ、自動化スクリプト、または OAuth をサポートしていないクライアントに役立ちます

今後の拡張: OAuth アクセス制御 (近日公開)

OAuth 認証のための拡張アクセス制御機能を開発中です。

• 権限検証 — OAuth ログイン時に、アカウントに MCP サーバーの使用権限が付与されているかどうかを自動的に検証します
• 一元化されたアクセス管理 — チームオーナーは、BatchData プラットフォームを通じてチームメンバーの MCP サーバーアクセスを許可または取り消すことができます

---

OAuth セットアップ (推奨)

前提条件

• 有効な認証情報を持つ BatchData アカウント
• MCP 互換クライアント (Claude デスクトップ/Web/モバイル、ChatGPT、Cursor、Claude Code など)

Claude セットアップ (デスクトップ、Web、モバイル)

Claude は、デスクトップアプリ、Web インターフェース、モバイルアプリを通じて MCP サーバーをサポートしています。

モバイルに関する注意: コネクタはモバイルアプリから追加できません。最初にデスクトップまたは Web でコネクタを追加すると、同じアカウントのモバイルで自動的に利用可能になります。

チーム/エンタープライズに関する注意: ワークスペース管理者は、チームメンバーが設定する前に、まず利用可能なコネクタのリストに BatchData コネクタを追加する必要があります。リストにコネクタが表示されない場合は、管理者にお問い合わせください。

ステップ 1: BatchData コネクタの追加

1. Claude (デスクトップまたは Web) を開きます
2. 設定 → コネクタ (または 設定 → MCP サーバー) に移動します
3. コネクタを追加 (または サーバーを追加) をクリックします
4. サーバー URL を入力します:

https://mcp.batchdata.com

5. 追加 または 接続 をクリックします

ステップ 2: 認証

1. ブラウザが BatchData ログインページを開きます
2. 次のいずれかを使用してサインインします:

• メールアドレスとパスワード — BatchData アカウントの認証情報を入力します
• Google サインイン — Google ボタンをクリックして認証します

3. ログインに成功すると、Claude にリダイレクトされます

ステップ 3: コネクタの有効化

コネクタは追加後、デフォルトでは有効になっていません。一度有効にすると、設定は保存されます。

1. 任意のチャットを開きます
2. チャット入力エリアの + ボタン (またはコネクタアイコン) をクリックします
3. 利用可能なコネクタのリストで BatchData を見つけます
4. トグルを オン にして有効にします

これで、すべての会話でコネクタが利用可能になります。

ステップ 4: 初回ツール使用の承認

Claude が初めて BatchData ツールを使用する際に、承認を求められます。

1. Claude がツールを使用しようとすると、許可プロンプトが表示されます
2. 要求されているツールとアクションを確認します
3. 許可 をクリックして承認します
4. 今後そのツールの承認をスキップしたい場合は、"常に許可" を選択します

注意: 初回承認後 (または "常に許可" を選択した後) は、以降のツール使用で追加の確認は不要です。

モバイルでの使用

デスクトップまたは Web でコネクタを追加して認証すると:

• 同じアカウントで Claude モバイルアプリを開きます
• BatchData コネクタがコネクタリストで利用可能になります
• まだ有効になっていない場合は、チャット入力の + ボタンからトグルをオンにします (設定はデバイス間で同期されます)
• デスクトップ/Web で付与されたツール承認はモバイルにも引き継がれます
• すべてのツールはデスクトップ/Web と同様に動作します

以降の接続

初回認証後:

• アクセストークンはキャッシュされ、すべてのデバイスで自動的に更新されます
• セッションの有効期限が切れない限り (通常、14 日間操作がない場合)、再度ログインする必要はありません
• 再認証を求められた場合は、ブラウザで再度ログインしてください (デスクトップまたは Web)

Cursor セットアップ

1. Cursor 設定を開きます
2. MCP 設定セクションに移動します
3. MCP サーバーを追加 をクリックします
4. サーバー URL を入力します:

https://mcp.batchdata.com

5. 初回使用時に、ブラウザのポップアップで認証します

Claude Code セットアップ

CLI から直接 BatchData MCP サーバーを追加します:

claude mcp add BatchData --url https://mcp.batchdata.com

初回使用時に、ブラウザで認証するよう求められます。

ChatGPT セットアップ (開発者モード)

ChatGPT は、完全な Model Context Protocol クライアントサポートを提供する 開発者モード を通じて MCP サーバーをサポートしています。

前提条件

• ChatGPT Plus または Pro サブスクリプション
• Business/Enterprise の場合: 管理者がワークスペース設定で開発者モードを有効にする必要があります

ステップ 1: 開発者モードの有効化

1. ChatGPT を開きます
2. 設定 → アプリとコネクタ → 詳細設定 に移動します
3. 開発者モード のトグルをオンにします

Business/Enterprise ワークスペースの場合:

• 管理者は、ワークスペース設定 → 権限とロール → 接続データ → 開発者モード / カスタム MCP コネクタの作成 から最初に開発者モードを有効にする必要があります

ステップ 2: BatchData コネクタの作成

1. ChatGPT で、設定 → コネクタ に移動します
2. 作成 をクリックします
3. 次の詳細を入力します:

• コネクタ名: BatchData
• MCP サーバー URL: https://mcp.batchdata.com

4. 作成 をクリックします

ステップ 3: 認証

1. コネクタを作成すると、ChatGPT が認証を求めるプロンプトを表示します
2. ブラウザが BatchData ログインページを開きます
3. 次のいずれかを使用してサインインします:

• メールアドレスとパスワード — BatchData アカウントの認証情報を入力します
• Google サインイン — Google ボタンをクリックして認証します

4. ログインに成功すると、ChatGPT にリダイレクトされます
5. BatchData コネクタが使用可能になりました

ChatGPT での BatchData ツールの使用

接続すると、会話で BatchData ツールを使用できます。

1. 新しいチャットを開始します
2. + ボタンをクリックし、その他 メニューからコネクタを選択します
3. または、Plus メニュー から 開発者モード を選択し、BatchData を選択します
4. 物件に関する質問をすると、ChatGPT が適切なツールを使用します

プロンプトの例:

• "123 Main Street, Los Angeles, CA の物件を調べて"
• "456 Oak Avenue の比較物件を見つけて"
• "789 Pine Road, Miami, FL の所有者をスキップトレースして"

接続の管理

• 切断するには: 設定 → コネクタ に移動し、BatchData をクリックして切断します
• 再接続するには: コネクタをクリックして再認証します
• セッションの有効期限: セッションの有効期限が切れた場合 (通常 14 日後)、再接続を求められます

検証

接続したら、物件データやスキップトレースについて質問するだけで、LLM が自動的に BatchData ツールを使用します。

プロンプトの例:

• "123 Main Street, Los Angeles, CA の物件を調べて"
• "456 Oak Avenue, Miami, FL の所有者をスキップトレースして"
• "789 Pine Road, Austin, TX の比較物件を見つけて"
• "Miami, FL の空き物件を検索して"
• "この電話番号を確認して: 555-123-4567"
• "この住所を確認して標準化して: 100 main st los angeles ca"
• "200 Park Avenue, New York, NY の座標を取得して"

Claude または ChatGPT は意図を認識し、適切な BatchData ツールを使用して情報を取得します。

---

API トークン セットアップ (代替手段)

以下の場合にこの方法を使用します。

• MCP クライアントが OAuth をサポートしていない場合
• MCP サーバー接続をデバッグまたは自動化する必要がある場合
• 明示的なトークン管理を希望する場合

前提条件

• BatchData API トークン (BatchData Web アプリから取得)
• MCP 互換クライアント
• Node.js 22+ (Claude Desktop の場合)

API トークンを使用した Claude Desktop セットアップ

ステップ 1: Node.js 22 のインストール

Claude Desktop にバンドルされている Node.js は古いバージョンです。Node.js 22 を別途インストールしてください。

macOS/Linux:

# Install Volta (Node.js version manager) curl https://get.volta.sh | bash # Restart terminal, then install Node.js 22 volta install node@22 # Find your username for the config below whoami

Windows:

nodejs.org から Node.js 22.x LTS をダウンロードしてインストールします

ステップ 2: Claude Desktop の設定

1. Claude Desktop を開きます
2. 設定 > 開発者 > 設定を編集 に移動します
3. 次の設定を追加します:

macOS 設定:

{ "mcpServers": { "BatchData": { "command": "/Users/YOUR_USERNAME/.volta/bin/npx", "args": [ "-y", "mcp-remote", "https://mcp.batchdata.com", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer YOUR_API_TOKEN_HERE" } } } }

Linux 設定:

{ "mcpServers": { "BatchData": { "command": "/home/YOUR_USERNAME/.volta/bin/npx", "args": [ "-y", "mcp-remote", "https://mcp.batchdata.com", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer YOUR_API_TOKEN_HERE" } } } }

Windows 設定:

{ "mcpServers": { "BatchData": { "command": "C:\\Program Files\\nodejs\\npx.cmd", "args": [ "-y", "mcp-remote", "https://mcp.batchdata.com", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer YOUR_API_TOKEN_HERE" } } } }

4. YOUR_USERNAME を実際のユーザー名に置き換えます
5. YOUR_API_TOKEN_HERE を BatchData API トークンに置き換えます
6. ファイルを保存し、Claude Desktop を再起動します

カスタム MCP クライアント セットアップ

カスタム MCP クライアント実装の場合:

接続の詳細:

設定	値
サーバー URL	https://mcp.batchdata.com
トランスポート	Streamable HTTP
認証	Authorization ヘッダーによる Bearer トークン

設定例:

{ "server_url": "https://mcp.batchdata.com", "headers": { "Authorization": "Bearer YOUR_API_TOKEN_HERE" } }

npx の使用:

npx mcp-remote https://mcp.batchdata.com --header "Authorization:Bearer YOUR_API_TOKEN_HERE"

---

API トークンから OAuth への移行

以前に API トークン方式で BatchData をセットアップし、よりシンプルなエクスペリエンスのために OAuth に切り替えたい場合は、次の手順に従ってください。

Claude Desktop

1. Claude Desktop を開きます
2. 設定 → 開発者 → 設定を編集 に移動します
3. 既存の BatchData 設定（command、args、env を含むブロック全体）を削除します
4. 設定ファイルを保存して閉じます
5. Claude セットアップ (デスクトップ、Web、モバイル) の手順に従って、UI からコネクタを追加します
6. プロンプトが表示されたら、BatchData アカウントで認証します

変更前 (API トークン):

{ "mcpServers": { "BatchData": { "command": "/Users/YOUR_USERNAME/.volta/bin/npx", "args": ["-y", "mcp-remote", "https://mcp.batchdata.com", "--header", "Authorization:${AUTH_HEADER}"], "env": { "AUTH_HEADER": "Bearer YOUR_API_TOKEN" } } } }

変更後 (OAuth): UI から設定 — JSON の編集は不要です。

Claude Code

1. 既存の設定を削除します:

claude mcp remove BatchData

2. OAuth を使用して再度追加します:

claude mcp add BatchData --url https://mcp.batchdata.com

3. プロンプトが表示されたら、ブラウザで認証します

ChatGPT

API トークンを使用した回避策を使用していた場合は、次の手順を実行します:

1. 設定 → コネクタ から既存の BatchData コネクタを削除します
2. ChatGPT セットアップ の手順に従って、新しいコネクタを作成します
3. BatchData アカウントで認証します

移行のメリット

項目	API トークン	OAuth
セットアップ	手動での JSON 編集	シンプルな UI フロー
トークン管理	手動ローテーション	自動更新
セキュリティ	設定ファイルにトークンを保存	クライアントがトークンを管理
マルチデバイス	各デバイスで設定	デバイス間で同期

---

利用可能なツール

接続すると、BatchData MCP サーバーは以下のツールを提供します:

物件検索と詳細

ツール	説明
lookup_property	ID、住所、または区画番号で詳細な物件情報を取得します

比較物件分析

ツール	説明
comparable_property_count	比較物件の数と集計指標を取得します
comparable_property_preview	最初の 10 件の比較物件の概要をサマリーフィールド付きでクイックプレビューします
comparable_property_page	完全な比較物件詳細へのページ分割アクセス (オフセットベースとカーソルベースの両方のページネーションをサポート)
comparable_property	⚠️ 非推奨 — すべての比較物件を一度に返します

物件検索

ツール	説明
search_properties_count	検索条件に一致する物件の数をクイックリストの内訳付きで取得します
search_properties_preview	最初の 10 件の一致する物件をクイックプレビューします
search_properties_page	完全な詳細を含むページ分割された物件検索 (オフセットとカーソルベースのページネーションをサポート)

連絡先情報

ツール	説明
skip_trace_property	住所または区画番号で物件の所有者と連絡先情報を取得します

電話検証

ツール	説明
verify_phone	到達可能性、DNC ステータス、キャリア、TCPA 訴訟当事者ステータスを含む完全な検証詳細
check_dnc_status	Do Not Call ステータスのみを確認します
check_tcpa_status	TCPA 訴訟当事者ステータスのみを確認します

住所処理

ツール	説明
verify_address	USPS 準拠に住所を整形します
geocode_address	住所から座標を取得します
reverse_geocode_address	緯度/経度座標から住所を取得します

---

トラブルシューティング

OAuth の問題

問題	解決策
ログイン用のブラウザが開かない	ポップアップが許可されていることを確認してください。デフォルトのブラウザが正しく設定されているか確認してください。
ログインページに「セッションの有効期限が切れました」と表示される	コネクタを削除して再度追加し、再度認証してください。
「ログイン試行回数が多すぎます」エラー	15 分間待ってから再試行してください。
Google サインインが機能しない	ポップアップが許可されていることを確認し、代わりにメール/パスワードを使用してみてください。
ログイン後に接続が失敗する	インターネット接続を確認してください。MCP クライアントへのリダイレクトが失敗した可能性があります。コネクタを削除して再度追加してみてください。

ChatGPT の問題

問題	解決策
コネクタを作成できない	設定 → アプリとコネクタ → 詳細設定 で開発者モードが有効になっていることを確認してください。
開発者モードのトグルがない	Business/Enterprise の場合、ワークスペース管理者が最初にワークスペース設定で有効にする必要があります。
認証が失敗する	http://chatgpt.com のポップアップが許可されていることを確認してください。コネクタを切断して再接続してみてください。
ツールが使用されない	プロンプトで明示的に指定してください: 「BatchData コネクタを使用して...」。プロンプトを入力する前に + ボタンでコネクタを追加してください。
コネクタが応答しない	設定 → コネクタ → BatchData → 更新 に移動してメタデータを更新してください。サーバーが一時的に利用できない可能性があります。
間違ったツールが呼び出される	指定してください: 「組み込みのブラウジングや他のツールは使用せず、BatchData コネクタのみを使用してください。」

API トークンの問題

問題	解決策
401 Unauthorized	API トークンが正しく、有効期限が切れていないことを確認してください。
403 Forbidden	BatchData Web アプリでトークンに必要なエンドポイント権限があることを確認してください。
Node.js のパスエラー	which npx (macOS/Linux) を実行するか、インストールパス (Windows) を確認して、npx へのパスが存在することを確認してください。
設定が読み込まれない	設定ファイルを保存した後、MCP クライアントを再起動してください。

一般的な問題

問題	解決策
ツールが表示されない	クライアントの拡張機能リストで MCP サーバーが有効になっていることを確認してください。
SkipTracing が 403 を返す	管理者がチームに対して SkipTracing v3 を有効にする必要があり、トークンに権限が必要です。
応答が遅い	インターネット接続を確認してください。サーバーは BatchData API へのリクエストをプロキシします。

ヘルプの利用

• API トークンの問題: BatchData Web アプリにログインして、サーバー側のトークンを管理します
• 権限の問題: BatchData チーム管理者にお問い合わせください
• 技術的な問題: BatchData サポートチームにお問い合わせください

---

© BatchData 2025