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 のセットアップ（デスクトップ、ウェブ、モバイル）
    • 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 Desktop／Web／Mobile、ChatGPT、Cursor、Claude Code など）

Claude のセットアップ（デスクトップ、Web、モバイル）

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

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

Teams／Enterprise に関する注意：チームメンバーがコネクタを設定する前に、ワークスペース管理者が BatchData コネクタを利用可能なコネクタの一覧に追加する必要があります。一覧にコネクタが表示されない場合は、管理者にお問い合わせください。

ステップ 1：BatchData コネクタを追加する

1. Claude（デスクトップまたは Web）を開きます
2. Settings → Connectors（または Settings → MCP Servers）に移動します
3. Add Connector（または Add Server）をクリックします
4. サーバー URL を入力します：

https://mcp.batchdata.com

5. Add または Connect をクリックします

ステップ 2：認証する

1. ブラウザーで BatchData のログインページが開きます
2. 次のいずれかの方法でサインインします。

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

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

ステップ 3：コネクタを有効にする

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

1. 任意のチャットを開きます
2. チャット入力欄の + ボタン（またはコネクタアイコン）をクリックします
3. 利用可能なコネクタの一覧から BatchData を探します
4. オンに切り替えて有効にします

これで、すべての会話でコネクタを利用できるようになります。

ステップ 4：ツールの初回使用を承認する

Claude が BatchData のツールを初めて使用するときは、承認を求められます。

1. Claude がツールを使用しようとすると、権限の確認画面が表示されます
2. 要求されているツールと操作を確認します
3. Allow をクリックして承認します
4. 今後そのツールを使用するときの承認を省略するには、"Always allow" を選択します

注：初回の承認後（または "Always allow" を選択した後）は、以降のツール使用時に追加の確認は不要です。

モバイルでの使用

デスクトップまたは Web でコネクタを追加して認証した後は、次のように操作します。

• 同じアカウントで Claude モバイルアプリを開きます
• BatchData コネクタがコネクタの一覧に表示されます
• まだ有効になっていない場合は、チャット入力欄の + ボタンからオンに切り替えます（設定はデバイス間で同期されます）
• デスクトップ／Web で承認したツールは、モバイルにも引き継がれます
• すべてのツールはデスクトップ／Web と同じように動作します

2 回目以降の接続

初回認証後は、次のとおりです。

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

Cursor のセットアップ

1. Cursor の設定を開きます
2. MCP の設定セクションに移動します
3. Add MCP Server をクリックします
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. または、プラスメニュー から 開発者モード を選択し、BatchData を選びます。
4. 不動産に関する質問をすると、ChatGPT が適切なツールを使用します。

プロンプトの例：

• 「ロサンゼルス（CA）の 123 Main Street にある物件を調べて」
• 「456 Oak Avenue の類似物件を探して」
• 「マイアミ（FL）の 789 Pine Road の所有者をスキップトレースして」

接続の管理

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

動作確認

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

プロンプトの例：

• 「ロサンゼルス（CA）の 123 Main Street にある物件を調べて」
• 「マイアミ（FL）の 456 Oak Avenue の所有者をスキップトレースして」
• 「オースティン（TX）の 789 Pine Road の類似物件を探して」
• 「マイアミ（FL）で空き物件を検索して」
• 「この電話番号を確認して：555-123-4567」
• 「この住所を確認して標準化して：100 main st los angeles ca」
• 「ニューヨーク（NY）の 200 Park Avenue の座標を取得して」

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. Settings > Developer > Edit Config に移動します
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 Token に置き換えます
6. ファイルを保存し、Claude Desktop を再起動します

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

カスタム MCP クライアントを実装する場合：

接続の詳細：

設定	値
サーバー URL	https://mcp.batchdata.com
トランスポート	ストリーミング可能な 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. Settings → Developer → Edit Config に移動します
3. 既存の BatchData 設定（command、args、env を含むブロック全体）を削除します
4. 設定ファイルを保存して閉じます
5. Claude Setup (Desktop, Web & Mobile) の手順に従い、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. Settings → Connectors から既存の BatchData コネクタを削除します
2. ChatGPT Setup の手順に従い、新しいコネクタを作成します
3. BatchData アカウントで認証します

移行のメリット

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

---

利用可能なツール

接続すると、BatchData MCP Server から次のツールを利用できます：

不動産の検索と詳細情報

ツール	説明
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 App で、トークンに必要なエンドポイント権限が付与されていることを確認してください。
Node.js のパスエラー	which npx を実行して npx へのパスが存在することを確認するか、Windows の場合はインストール先のパスを確認してください。
設定が読み込まれない	設定ファイルを保存した後、MCP クライアントを再起動してください。

一般的な問題

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

ヘルプの利用

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

---

© BatchData 2025