BatchData MCP (Real Estate & Contact Data)

Panduan Pengaturan Server MCP Jarak Jauh BatchData

• 1 Pendahuluan
• 2 Metode Autentikasi
  • 2.1 Autentikasi OAuth (Direkomendasikan)
  • 2.2 Autentikasi Token API (Alternatif)
• 3 Peningkatan Mendatang: Kontrol Akses OAuth (Segera Hadir)
• 4 Pengaturan OAuth (Direkomendasikan)
  • 4.1 Prasyarat
  • 4.2 Pengaturan Claude (Desktop, Web & Seluler)
    • 4.2.1 Langkah 1: Tambahkan Konektor BatchData
    • 4.2.2 Langkah 2: Autentikasi
    • 4.2.3 Langkah 3: Aktifkan Konektor
    • 4.2.4 Langkah 4: Setujui Penggunaan Alat Awal
    • 4.2.5 Menggunakan di Seluler
    • 4.2.6 Koneksi Selanjutnya
  • 4.3 Pengaturan Cursor
  • 4.4 Pengaturan Claude Code
  • 4.5 Pengaturan ChatGPT (Mode Pengembang)
    • 4.5.1 Prasyarat
    • 4.5.2 Langkah 1: Aktifkan Mode Pengembang
    • 4.5.3 Langkah 2: Buat Konektor BatchData
    • 4.5.4 Langkah 3: Autentikasi
    • 4.5.5 Menggunakan Alat BatchData di ChatGPT
    • 4.5.6 Mengelola Koneksi
  • 4.6 Verifikasi
• 5 Pengaturan Token API (Alternatif)
  • 5.1 Prasyarat
  • 5.2 Pengaturan Claude Desktop dengan Token API
    • 5.2.1 Langkah 1: Instal Node.js 22
    • 5.2.2 Langkah 2: Konfigurasi Claude Desktop
  • 5.3 Pengaturan Klien MCP Kustom
• 6 Migrasi dari Token API ke OAuth
  • 6.1 Claude Desktop
  • 6.2 Claude Code
  • 6.3 ChatGPT
  • 6.4 Manfaat Migrasi
• 7 Alat yang Tersedia
  • 7.1 Pencarian & Detail Properti
  • 7.2 Analisis Properti Sebanding
  • 7.3 Pencarian Properti
  • 7.4 Informasi Kontak
  • 7.5 Verifikasi Telepon
  • 7.6 Pemrosesan Alamat
• 8 Pemecahan Masalah
  • 8.1 Masalah OAuth
  • 8.2 Masalah ChatGPT
  • 8.3 Masalah Token API
  • 8.4 Masalah Umum
  • 8.5 Mendapatkan Bantuan

Pendahuluan

Panduan ini mendokumentasikan cara menghubungkan ke Server MCP Jarak Jauh BatchData menggunakan klien yang kompatibel dengan MCP Anda.

Metode Autentikasi

Server MCP BatchData mendukung dua metode autentikasi:

Metode	Kompleksitas Pengaturan	Keamanan	Direkomendasikan Untuk
OAuth (Direkomendasikan)	Sederhana	Tinggi	Sebagian besar pengguna
Token API	Konfigurasi manual	Sedang	Klien MCP kustom, debugging

Autentikasi OAuth (Direkomendasikan)

OAuth menyediakan pengalaman koneksi yang efisien:

• Tidak perlu konfigurasi token API — Cukup berikan URL server
• Login berbasis browser — Autentikasi dengan kredensial akun BatchData Anda
• Manajemen token otomatis — Token akses diperbarui secara otomatis
• Pengalaman login yang familiar — Gunakan email/kata sandi atau Google Sign-In

Autentikasi Token API (Alternatif)

Untuk pengguna yang lebih memilih konfigurasi token API langsung atau menggunakan klien MCP kustom yang tidak mendukung OAuth:

• Memerlukan perolehan dan konfigurasi token API BatchData Anda secara manual
• Token harus dikelola dan dilindungi sebagai kredensial sensitif
• Berguna untuk debugging, skrip otomatisasi, atau klien tanpa dukungan OAuth

Peningkatan Mendatang: Kontrol Akses OAuth (Segera Hadir)

Kami sedang mengembangkan fitur kontrol akses yang ditingkatkan untuk autentikasi OAuth:

• Verifikasi izin — Login OAuth akan secara otomatis memverifikasi apakah akun Anda telah diberikan izin untuk menggunakan server MCP
• Manajemen akses terpusat — Pemilik tim akan dapat memberikan atau mencabut akses server MCP untuk anggota tim melalui platform BatchData

---

Pengaturan OAuth (Direkomendasikan)

Prasyarat

• Akun BatchData dengan kredensial yang valid
• Klien yang kompatibel dengan MCP (Claude Desktop/Web/Seluler, ChatGPT, Cursor, Claude Code, atau sejenisnya)

Pengaturan Claude (Desktop, Web & Seluler)

Claude mendukung server MCP melalui aplikasi desktop, antarmuka web, dan aplikasi seluler.

Catatan Seluler: Konektor tidak dapat ditambahkan dari aplikasi seluler. Tambahkan konektor di Desktop atau Web terlebih dahulu, dan secara otomatis akan tersedia di seluler untuk akun yang sama.

Catatan Tim/Enterprise: Admin ruang kerja harus terlebih dahulu menambahkan konektor BatchData ke daftar konektor yang tersedia sebelum anggota tim dapat mengonfigurasinya. Hubungi admin Anda jika Anda tidak melihat konektor dalam daftar Anda.

Langkah 1: Tambahkan Konektor BatchData

1. Buka Claude (Desktop atau Web)
2. Buka Pengaturan → Konektor (atau Pengaturan → Server MCP)
3. Klik Tambah Konektor (atau Tambah Server)
4. Masukkan URL server:

https://mcp.batchdata.com

5. Klik Tambah atau Hubungkan

Langkah 2: Autentikasi

1. Browser Anda akan terbuka ke halaman login BatchData
2. Masuk menggunakan salah satu:

• Email dan kata sandi — Masukkan kredensial akun BatchData Anda
• Google Sign-In — Klik tombol Google untuk autentikasi

3. Setelah login berhasil, Anda akan diarahkan kembali ke Claude

Langkah 3: Aktifkan Konektor

Konektor tidak diaktifkan secara default setelah menambahkannya. Aktifkan sekali dan pengaturannya disimpan:

1. Buka obrolan apa pun
2. Klik tombol + (atau ikon konektor) di area input obrolan
3. Temukan BatchData dalam daftar konektor yang tersedia
4. Alihkan ke aktif untuk mengaktifkannya

Konektor sekarang akan tersedia di semua percakapan Anda.

Langkah 4: Setujui Penggunaan Alat Awal

Pertama kali Claude menggunakan alat BatchData apa pun, Anda akan diminta untuk menyetujuinya:

1. Saat Claude mencoba menggunakan alat, prompt izin akan muncul
2. Tinjau alat dan tindakan yang diminta
3. Klik Izinkan untuk menyetujui
4. Pilih "Selalu izinkan" jika Anda ingin melewati persetujuan untuk penggunaan alat tersebut di masa mendatang

Catatan: Setelah persetujuan awal (atau memilih "Selalu izinkan"), penggunaan alat selanjutnya tidak akan memerlukan konfirmasi tambahan.

Menggunakan di Seluler

Setelah Anda menambahkan dan mengautentikasi konektor di Desktop atau Web:

• Buka aplikasi seluler Claude dengan akun yang sama
• Konektor BatchData akan tersedia di daftar konektor Anda
• Jika belum diaktifkan, alihkan ke aktif melalui tombol + di input obrolan (pengaturan disinkronkan di seluruh perangkat)
• Persetujuan alat yang diberikan di Desktop/Web berlaku di seluler
• Semua alat bekerja sama seperti di Desktop/Web

Koneksi Selanjutnya

Setelah autentikasi awal:

• Token akses di-cache dan diperbarui secara otomatis di semua perangkat
• Anda tidak perlu login lagi kecuali sesi Anda kedaluwarsa (biasanya setelah 14 hari tidak aktif)
• Jika diminta untuk mengautentikasi ulang, cukup login lagi melalui browser Anda (di Desktop atau Web)

Pengaturan Cursor

1. Buka Pengaturan Cursor
2. Arahkan ke bagian konfigurasi MCP
3. Klik Tambah Server MCP
4. Masukkan URL server:

https://mcp.batchdata.com

5. Pada penggunaan pertama, autentikasi melalui popup browser

Pengaturan Claude Code

Tambahkan server MCP BatchData langsung melalui CLI:

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

Pada penggunaan pertama, Anda akan diminta untuk mengautentikasi melalui browser Anda.

Pengaturan ChatGPT (Mode Pengembang)

ChatGPT mendukung server MCP melalui Mode Pengembang, yang menyediakan dukungan penuh klien Model Context Protocol.

Prasyarat

• Langganan ChatGPT Plus atau Pro
• Untuk Bisnis/Enterprise: Admin harus mengaktifkan mode pengembang di Pengaturan Ruang Kerja

Langkah 1: Aktifkan Mode Pengembang

1. Buka ChatGPT
2. Buka Pengaturan → Aplikasi & Konektor → Pengaturan lanjutan
3. Alihkan Mode pengembang ke aktif

Untuk ruang kerja Bisnis/Enterprise:

• Admin harus terlebih dahulu mengaktifkan mode pengembang dari Pengaturan Ruang Kerja → Izin & Peran → Data Terhubung → Mode pengembang / Buat konektor MCP kustom

Langkah 2: Buat Konektor BatchData

1. Di ChatGPT, buka Pengaturan → Konektor
2. Klik Buat
3. Masukkan detail berikut:

• Nama konektor: BatchData
• URL Server MCP: https://mcp.batchdata.com

4. Klik Buat

Langkah 3: Autentikasi

1. Setelah membuat konektor, ChatGPT akan meminta Anda untuk mengautentikasi
2. Browser Anda akan terbuka ke halaman login BatchData
3. Masuk menggunakan salah satu:

• Email dan kata sandi — Masukkan kredensial akun BatchData Anda
• Google Sign-In — Klik tombol Google untuk autentikasi

4. Setelah login berhasil, Anda akan diarahkan kembali ke ChatGPT
5. Konektor BatchData sekarang siap digunakan

Menggunakan Alat BatchData di ChatGPT

Setelah terhubung, Anda dapat menggunakan alat BatchData dalam percakapan:

1. Mulai obrolan baru
2. Klik tombol +, lalu pilih konektor Anda dari menu Lainnya
3. Atau, pilih Mode pengembang dari Menu Plus dan pilih BatchData
4. Ajukan pertanyaan terkait properti — ChatGPT akan menggunakan alat yang sesuai

Contoh prompt:

• "Cari properti di 123 Main Street, Los Angeles, CA"
• "Temukan properti sebanding untuk 456 Oak Avenue"
• "Lacak pemilik 789 Pine Road, Miami, FL"

Mengelola Koneksi

• Untuk memutuskan: Buka Pengaturan → Konektor, klik BatchData, dan putuskan
• Untuk menyambungkan kembali: Klik konektor dan autentikasi ulang
• Kedaluwarsa sesi: Jika sesi Anda kedaluwarsa (biasanya setelah 14 hari), Anda akan diminta untuk menyambungkan kembali

Verifikasi

Setelah terhubung, cukup tanyakan tentang data properti atau pelacakan dan LLM akan secara otomatis menggunakan alat BatchData.

Contoh prompt:

• "Cari properti di 123 Main Street, Los Angeles, CA"
• "Lacak pemilik 456 Oak Avenue, Miami, FL"
• "Temukan properti sebanding untuk 789 Pine Road, Austin, TX"
• "Cari properti kosong di Miami, FL"
• "Verifikasi nomor telepon ini: 555-123-4567"
• "Verifikasi dan standarisasi alamat ini: 100 main st los angeles ca"
• "Dapatkan koordinat untuk 200 Park Avenue, New York, NY"

Claude atau ChatGPT akan mengenali maksudnya dan menggunakan alat BatchData yang sesuai untuk mengambil informasi.

---

Pengaturan Token API (Alternatif)

Gunakan metode ini jika:

• Klien MCP Anda tidak mendukung OAuth
• Anda perlu men-debug atau mengotomatiskan koneksi server MCP
• Anda lebih memilih manajemen token eksplisit

Prasyarat

• Token API BatchData Anda (dapatkan dari Aplikasi Web BatchData)
• Klien yang kompatibel dengan MCP
• Node.js 22+ (untuk Claude Desktop)

Pengaturan Claude Desktop dengan Token API

Langkah 1: Instal Node.js 22

Node.js bawaan Claude Desktop sudah usang. Instal Node.js 22 secara terpisah:

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:

Unduh dan instal Node.js 22.x LTS dari nodejs.org

Langkah 2: Konfigurasi Claude Desktop

1. Buka Claude Desktop
2. Buka Pengaturan > Pengembang > Edit Konfigurasi
3. Tambahkan konfigurasi berikut:

Konfigurasi 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" } } } }

Konfigurasi 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" } } } }

Konfigurasi 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. Ganti YOUR_USERNAME dengan nama pengguna Anda yang sebenarnya
5. Ganti YOUR_API_TOKEN_HERE dengan Token API BatchData Anda
6. Simpan file dan mulai ulang Claude Desktop

Pengaturan Klien MCP Kustom

Untuk implementasi klien MCP kustom:

Detail Koneksi:

Pengaturan	Nilai
URL Server	https://mcp.batchdata.com
Transport	HTTP Streamable
Autentikasi	Token Bearer melalui header Authorization

Contoh Konfigurasi:

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

Menggunakan npx:

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

---

Migrasi dari Token API ke OAuth

Jika Anda sebelumnya mengatur BatchData menggunakan metode token API dan ingin beralih ke OAuth untuk pengalaman yang lebih sederhana, ikuti langkah-langkah berikut:

Claude Desktop

1. Buka Claude Desktop
2. Buka Pengaturan → Pengembang → Edit Konfigurasi
3. Hapus konfigurasi BatchData yang ada (seluruh blok dengan command, args, dan env)
4. Simpan dan tutup berkas konfigurasi
5. Ikuti petunjuk Pengaturan Claude (Desktop, Web & Seluler) untuk menambahkan konektor melalui antarmuka
6. Autentikasi dengan akun BatchData Anda saat diminta

Sebelum (Token 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" } } } }

Sesudah (OAuth): Dikonfigurasi melalui antarmuka — tidak perlu mengedit JSON.

Claude Code

1. Hapus konfigurasi yang ada:

claude mcp remove BatchData

2. Tambahkan kembali menggunakan OAuth:

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

3. Autentikasi melalui peramban Anda saat diminta

ChatGPT

Jika Anda menggunakan solusi sementara dengan token API, cukup:

1. Hapus konektor BatchData yang ada dari Pengaturan → Konektor
2. Ikuti petunjuk Pengaturan ChatGPT untuk membuat konektor baru
3. Autentikasi dengan akun BatchData Anda

Manfaat Migrasi

Aspek	Token API	OAuth
Pengaturan	Pengeditan JSON manual	Alur antarmuka sederhana
Manajemen token	Rotasi manual	Penyegaran otomatis
Keamanan	Token tersimpan di berkas konfigurasi	Token dikelola oleh klien
Multi-perangkat	Konfigurasi tiap perangkat	Sinkronisasi lintas perangkat

---

Alat yang Tersedia

Setelah terhubung, Server MCP BatchData menyediakan alat berikut:

Pencarian & Detail Properti

Alat	Deskripsi
lookup_property	Dapatkan informasi properti terperinci berdasarkan ID, alamat, atau nomor persil

Analisis Properti Pembanding

Alat	Deskripsi
comparable_property_count	Dapatkan jumlah dan metrik agregat properti pembanding
comparable_property_preview	Pratinjau cepat 10 properti pembanding pertama dengan ringkasan
comparable_property_page	Akses terhalaman ke detail lengkap properti pembanding (mendukung paginasi berbasis offset dan kursor)
comparable_property	⚠️ Tidak digunakan lagi — Mengembalikan semua properti pembanding sekaligus

Pencarian Properti

Alat	Deskripsi
search_properties_count	Dapatkan jumlah properti yang cocok dengan kriteria pencarian beserta rincian daftar cepat
search_properties_preview	Pratinjau cepat 10 properti pertama yang cocok
search_properties_page	Pencarian properti terhalaman dengan detail lengkap (mendukung paginasi berbasis offset dan kursor)

Informasi Kontak

Alat	Deskripsi
skip_trace_property	Dapatkan informasi pemilik dan kontak untuk properti berdasarkan alamat atau nomor persil

Verifikasi Telepon

Alat	Deskripsi
verify_phone	Detail verifikasi lengkap termasuk keterjangkauan, status DNC, operator, status penggugat TCPA
check_dnc_status	Periksa status Jangan Dihubungi saja
check_tcpa_status	Periksa status penggugat TCPA saja

Pemrosesan Alamat

Alat	Deskripsi
verify_address	Format alamat sesuai kepatuhan USPS
geocode_address	Dapatkan koordinat dari alamat
reverse_geocode_address	Dapatkan alamat dari koordinat lintang/bujur

---

Pemecahan Masalah

Masalah OAuth

Masalah	Solusi
Peramban tidak terbuka untuk masuk	Pastikan pop-up diizinkan. Periksa apakah peramban default Anda sudah diatur dengan benar.
Halaman masuk menampilkan "Sesi kedaluwarsa"	Hapus dan tambahkan kembali konektor, lalu autentikasi ulang.
Kesalahan "Terlalu banyak percobaan masuk"	Tunggu 15 menit sebelum mencoba lagi.
Masuk dengan Google tidak berfungsi	Pastikan pop-up diizinkan dan coba gunakan email/kata sandi sebagai gantinya.
Koneksi gagal setelah masuk	Periksa koneksi internet Anda. Pengalihan kembali ke klien MCP mungkin gagal. Coba hapus dan tambahkan kembali konektor.

Masalah ChatGPT

Masalah	Solusi
Tidak dapat membuat konektor	Pastikan Mode Pengembang diaktifkan di Pengaturan → Aplikasi & Konektor → Pengaturan lanjutan.
Tombol Mode Pengembang tidak ada	Untuk Bisnis/Perusahaan, admin ruang kerja Anda harus mengaktifkannya di Pengaturan Ruang Kerja terlebih dahulu.
Autentikasi gagal	Pastikan pop-up diizinkan untuk http://chatgpt.com . Coba putuskan dan sambungkan kembali konektor.
Alat tidak digunakan	Bersikaplah eksplisit dalam perintah Anda: "Gunakan konektor BatchData untuk...". Tambahkan konektor melalui tombol + sebelum memberikan perintah.
Konektor tidak merespons	Buka Pengaturan → Konektor → BatchData → Segarkan untuk memperbarui metadata. Server mungkin sedang tidak tersedia untuk sementara.
Alat yang salah dipanggil	Tentukan: "Jangan gunakan penjelajahan bawaan atau alat lain; hanya gunakan konektor BatchData."

Masalah Token API

Masalah	Solusi
401 Tidak Sah	Verifikasi token API Anda benar dan belum kedaluwarsa.
403 Terlarang	Pastikan token Anda memiliki izin titik akhir yang diperlukan di Aplikasi Web BatchData.
Kesalahan jalur Node.js	Verifikasi jalur ke npx ada dengan menjalankan which npx (macOS/Linux) atau periksa jalur instalasi (Windows).
Konfigurasi tidak dimuat	Mulai ulang klien MCP Anda setelah menyimpan berkas konfigurasi.

Masalah Umum

Masalah	Solusi
Alat tidak muncul	Verifikasi server MCP diaktifkan di daftar ekstensi klien Anda.
SkipTracing mengembalikan 403	SkipTracing v3 harus diaktifkan untuk tim Anda oleh admin, dan token Anda memerlukan izin tersebut.
Respons lambat	Periksa koneksi internet Anda. Server meneruskan permintaan ke API BatchData.

Mendapatkan Bantuan

• Masalah Token API: Masuk ke Aplikasi Web BatchData untuk mengelola token sisi server Anda
• Masalah Izin: Hubungi administrator tim BatchData Anda
• Masalah Teknis: Hubungi tim dukungan BatchData

---

© BatchData 2025