BatchData MCP (Real Estate & Contact Data) Server

BatchData Remote MCP Sunucu Kurulum Kılavuzu

• 1 Giriş
• 2 Kimlik Doğrulama Yöntemleri
  • 2.1 OAuth Kimlik Doğrulaması (Önerilen)
  • 2.2 API Token Kimlik Doğrulaması (Alternatif)
• 3 Gelecek Geliştirme: OAuth Erişim Kontrolü (Çok Yakında)
• 4 OAuth Kurulumu (Önerilen)
  • 4.1 Ön Koşullar
  • 4.2 Claude Kurulumu (Masaüstü, Web ve Mobil)
    • 4.2.1 Adım 1: BatchData Bağlayıcısını Ekleme
    • 4.2.2 Adım 2: Kimlik Doğrulama
    • 4.2.3 Adım 3: Bağlayıcıyı Etkinleştirme
    • 4.2.4 Adım 4: İlk Araç Kullanımını Onaylama
    • 4.2.5 Mobilde Kullanım
    • 4.2.6 Sonraki Bağlantılar
  • 4.3 Cursor Kurulumu
  • 4.4 Claude Code Kurulumu
  • 4.5 ChatGPT Kurulumu (Geliştirici Modu)
    • 4.5.1 Ön Koşullar
    • 4.5.2 Adım 1: Geliştirici Modunu Etkinleştirme
    • 4.5.3 Adım 2: BatchData Bağlayıcısını Oluşturma
    • 4.5.4 Adım 3: Kimlik Doğrulama
    • 4.5.5 ChatGPT'de BatchData Araçlarını Kullanma
    • 4.5.6 Bağlantıyı Yönetme
  • 4.6 Doğrulama
• 5 API Token Kurulumu (Alternatif)
  • 5.1 Ön Koşullar
  • 5.2 API Token ile Claude Masaüstü Kurulumu
    • 5.2.1 Adım 1: Node.js 22'yi Yükleme
    • 5.2.2 Adım 2: Claude Masaüstünü Yapılandırma
  • 5.3 Özel MCP İstemci Kurulumu
• 6 API Token'dan OAuth'a Geçiş
  • 6.1 Claude Masaüstü
  • 6.2 Claude Code
  • 6.3 ChatGPT
  • 6.4 Geçişin Faydaları
• 7 Kullanılabilir Araçlar
  • 7.1 Mülk Sorgulama ve Detaylar
  • 7.2 Karşılaştırılabilir Mülk Analizi
  • 7.3 Mülk Arama
  • 7.4 İletişim Bilgileri
  • 7.5 Telefon Doğrulama
  • 7.6 Adres İşleme
• 8 Sorun Giderme
  • 8.1 OAuth Sorunları
  • 8.2 ChatGPT Sorunları
  • 8.3 API Token Sorunları
  • 8.4 Genel Sorunlar
  • 8.5 Yardım Alma

Giriş

Bu kılavuz, MCP uyumlu istemcinizi kullanarak BatchData Remote MCP Sunucusuna nasıl bağlanacağınızı belgelemektedir.

Kimlik Doğrulama Yöntemleri

BatchData MCP Sunucusu iki kimlik doğrulama yöntemini destekler:

Yöntem	Kurulum Karmaşıklığı	Güvenlik	Şunlar İçin Önerilir
OAuth (Önerilen)	Basit	Yüksek	Çoğu kullanıcı
API Token	Manuel yapılandırma	Orta	Özel MCP istemcileri, hata ayıklama

OAuth Kimlik Doğrulaması (Önerilen)

OAuth, akıcı bir bağlantı deneyimi sunar:

• API token yapılandırması gerekmez — Sadece sunucu URL'sini sağlayın
• Tarayıcı tabanlı giriş — BatchData hesap bilgilerinizle kimlik doğrulayın
• Otomatik token yönetimi — Erişim token'ları otomatik olarak yenilenir
• Tanıdık giriş deneyimi — E-posta/şifre veya Google ile Giriş kullanın

API Token Kimlik Doğrulaması (Alternatif)

Doğrudan API token yapılandırmasını tercih eden veya OAuth'u desteklemeyen özel MCP istemcileri kullanan kullanıcılar için:

• BatchData API token'ınızı manuel olarak edinmenizi ve yapılandırmanızı gerektirir
• Token hassas bir kimlik bilgisi olarak yönetilmeli ve korunmalıdır
• Hata ayıklama, otomasyon betikleri veya OAuth desteği olmayan istemciler için kullanışlıdır

Gelecek Geliştirme: OAuth Erişim Kontrolü (Çok Yakında)

OAuth kimlik doğrulaması için gelişmiş erişim kontrolü özellikleri geliştiriyoruz:

• İzin doğrulama — OAuth girişi, hesabınızın MCP sunucusunu kullanma iznine sahip olup olmadığını otomatik olarak doğrulayacaktır
• Merkezi erişim yönetimi — Ekip sahipleri, BatchData platformu üzerinden ekip üyeleri için MCP sunucusu erişimini verebilecek veya iptal edebilecektir

---

OAuth Kurulumu (Önerilen)

Ön Koşullar

• Geçerli kimlik bilgilerine sahip bir BatchData hesabı
• MCP uyumlu bir istemci (Claude Masaüstü/Web/Mobil, ChatGPT, Cursor, Claude Code veya benzeri)

Claude Kurulumu (Masaüstü, Web ve Mobil)

Claude, MCP sunucularını masaüstü uygulaması, web arayüzü ve mobil uygulama aracılığıyla destekler.

Mobil Not: Bağlayıcılar mobil uygulamadan eklenemez. Bağlayıcıyı önce Masaüstü veya Web'de ekleyin, aynı hesap için mobilde otomatik olarak kullanılabilir olacaktır.

Ekipler/Kurumsal Not: Çalışma alanı yöneticileri, ekip üyeleri yapılandırmadan önce BatchData bağlayıcısını kullanılabilir bağlayıcılar listesine eklemelidir. Bağlayıcıyı listenizde görmüyorsanız yöneticinizle iletişime geçin.

Adım 1: BatchData Bağlayıcısını Ekleme

1. Claude'u açın (Masaüstü veya Web)
2. Ayarlar → Bağlayıcılar'a (veya Ayarlar → MCP Sunucuları'na) gidin
3. Bağlayıcı Ekle'ye (veya Sunucu Ekle'ye) tıklayın
4. Sunucu URL'sini girin:

https://mcp.batchdata.com

5. Ekle veya Bağlan'a tıklayın

Adım 2: Kimlik Doğrulama

1. Tarayıcınız BatchData giriş sayfasını açacaktır
2. Aşağıdakilerden birini kullanarak giriş yapın:

• E-posta ve şifre — BatchData hesap bilgilerinizi girin
• Google ile Giriş — Kimlik doğrulamak için Google düğmesine tıklayın

3. Başarılı girişten sonra Claude'a geri yönlendirileceksiniz

Adım 3: Bağlayıcıyı Etkinleştirme

Bağlayıcılar eklendikten sonra varsayılan olarak etkin değildir. Bir kez etkinleştirin, ayar kaydedilir:

1. Herhangi bir sohbeti açın
2. Sohbet giriş alanındaki + düğmesine (veya bağlayıcılar simgesine) tıklayın
3. Kullanılabilir bağlayıcılar listesinde BatchData'yı bulun
4. Etkinleştirmek için açık konuma getirin

Bağlayıcı artık tüm konuşmalarınızda kullanılabilir olacaktır.

Adım 4: İlk Araç Kullanımını Onaylama

Claude herhangi bir BatchData aracını ilk kez kullandığında, onaylamanız istenecektir:

1. Claude bir araç kullanmaya çalıştığında bir izin istemi görünecektir
2. İstenen aracı ve eylemi inceleyin
3. Onaylamak için İzin Ver'e tıklayın
4. Gelecekteki kullanımlar için onayı atlamak istiyorsanız "Her zaman izin ver" seçeneğini belirleyin

Not: İlk onaydan sonra (veya "Her zaman izin ver" seçildikten sonra), sonraki araç kullanımları ek onay gerektirmeyecektir.

Mobilde Kullanım

Bağlayıcıyı Masaüstü veya Web'de ekleyip kimlik doğruladıktan sonra:

• Aynı hesapla Claude mobil uygulamasını açın
• BatchData bağlayıcısı bağlayıcı listenizde mevcut olacaktır
• Henüz etkin değilse, sohbet girişindeki + düğmesi aracılığıyla açık konuma getirin (ayar cihazlar arasında senkronize edilir)
• Masaüstü/Web'de verilen araç onayları mobile taşınır
• Tüm araçlar Masaüstü/Web'deki gibi çalışır

Sonraki Bağlantılar

İlk kimlik doğrulamadan sonra:

• Erişim token'ları önbelleğe alınır ve tüm cihazlarda otomatik olarak yenilenir
• Oturumunuz sona ermediği sürece (genellikle 14 günlük hareketsizlikten sonra) tekrar giriş yapmanız gerekmez
• Yeniden kimlik doğrulamanız istenirse, tarayıcınız üzerinden (Masaüstü veya Web'de) tekrar giriş yapmanız yeterlidir

Cursor Kurulumu

1. Cursor Ayarlarını açın
2. MCP yapılandırma bölümüne gidin
3. MCP Sunucusu Ekle'ye tıklayın
4. Sunucu URL'sini girin:

https://mcp.batchdata.com

5. İlk kullanımda, tarayıcı açılır penceresi aracılığıyla kimlik doğrulayın

Claude Code Kurulumu

BatchData MCP sunucusunu doğrudan CLI üzerinden ekleyin:

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

İlk kullanımda, tarayıcınız üzerinden kimlik doğrulamanız istenecektir.

ChatGPT Kurulumu (Geliştirici Modu)

ChatGPT, tam Model Bağlam Protokolü istemci desteği sağlayan Geliştirici Modu aracılığıyla MCP sunucularını destekler.

Ön Koşullar

• ChatGPT Plus veya Pro aboneliği
• İşletme/Kurumsal için: Yönetici, Çalışma Alanı Ayarlarında geliştirici modunu etkinleştirmelidir

Adım 1: Geliştirici Modunu Etkinleştirme

1. ChatGPT'yi açın
2. Ayarlar → Uygulamalar ve Bağlayıcılar → Gelişmiş ayarlar'a gidin
3. Geliştirici modu'nu açık konuma getirin

İşletme/Kurumsal çalışma alanları için:

• Yöneticiler önce Çalışma Alanı Ayarları → İzinler ve Roller → Bağlı Veriler → Geliştirici modu / Özel MCP bağlayıcıları oluştur'dan geliştirici modunu etkinleştirmelidir

Adım 2: BatchData Bağlayıcısını Oluşturma

1. ChatGPT'de Ayarlar → Bağlayıcılar'a gidin
2. Oluştur'a tıklayın
3. Aşağıdaki detayları girin:

• Bağlayıcı adı: BatchData
• MCP Sunucu URL'si: https://mcp.batchdata.com

4. Oluştur'a tıklayın

Adım 3: Kimlik Doğrulama

1. Bağlayıcıyı oluşturduktan sonra ChatGPT sizden kimlik doğrulamanızı isteyecektir
2. Tarayıcınız BatchData giriş sayfasını açacaktır
3. Aşağıdakilerden birini kullanarak giriş yapın:

• E-posta ve şifre — BatchData hesap bilgilerinizi girin
• Google ile Giriş — Kimlik doğrulamak için Google düğmesine tıklayın

4. Başarılı girişten sonra ChatGPT'ye geri yönlendirileceksiniz
5. BatchData bağlayıcısı artık kullanıma hazırdır

ChatGPT'de BatchData Araçlarını Kullanma

Bağlandıktan sonra, konuşmalarda BatchData araçlarını kullanabilirsiniz:

1. Yeni bir sohbet başlatın
2. + düğmesine tıklayın, ardından Diğer menüsünden bağlayıcınızı seçin
3. Alternatif olarak, Artı menüsünden Geliştirici modu'nu seçin ve BatchData'yı seçin
4. Mülkle ilgili sorular sorun — ChatGPT uygun araçları kullanacaktır

Örnek istemler:

• "123 Main Street, Los Angeles, CA adresindeki mülkü sorgula"
• "456 Oak Avenue için karşılaştırılabilir mülkler bul"
• "789 Pine Road, Miami, FL adresindeki mal sahibini atla izle"

Bağlantıyı Yönetme

• Bağlantıyı kesmek için: Ayarlar → Bağlayıcılar'a gidin, BatchData'ya tıklayın ve bağlantıyı kesin
• Yeniden bağlanmak için: Bağlayıcıya tıklayın ve yeniden kimlik doğrulayın
• Oturum sona ermesi: Oturumunuz sona ererse (genellikle 14 gün sonra), yeniden bağlanmanız istenecektir

Doğrulama

Bağlandıktan sonra, mülk verileri veya atlamalı izleme hakkında soru sormanız yeterlidir, LLM BatchData araçlarını otomatik olarak kullanacaktır.

Örnek istemler:

• "123 Main Street, Los Angeles, CA adresindeki mülkü sorgula"
• "456 Oak Avenue, Miami, FL adresindeki mal sahibini atla izle"
• "789 Pine Road, Austin, TX için karşılaştırılabilir mülkler bul"
• "Miami, FL'deki boş mülkleri ara"
• "Bu telefon numarasını doğrula: 555-123-4567"
• "Bu adresi doğrula ve standartlaştır: 100 main st los angeles ca"
• "200 Park Avenue, New York, NY için koordinatları al"

Claude veya ChatGPT, amacı tanıyacak ve bilgileri almak için uygun BatchData araçlarını kullanacaktır.

---

API Token Kurulumu (Alternatif)

Aşağıdaki durumlarda bu yöntemi kullanın:

• MCP istemciniz OAuth'u desteklemiyorsa
• MCP sunucu bağlantılarında hata ayıklamanız veya otomatikleştirmeniz gerekiyorsa
• Açık token yönetimini tercih ediyorsanız

Ön Koşullar

• BatchData API Token'ınız (BatchData Web Uygulamasından edinin)
• MCP uyumlu bir istemci
• Node.js 22+ (Claude Masaüstü için)

API Token ile Claude Masaüstü Kurulumu

Adım 1: Node.js 22'yi Yükleme

Claude Masaüstü'nün dahili Node.js'i güncel değildir. Node.js 22'yi ayrıca yükleyin:

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:

Node.js 22.x LTS'yi nodejs.org adresinden indirip yükleyin

Adım 2: Claude Masaüstünü Yapılandırma

1. Claude Masaüstü'nü açın
2. Ayarlar > Geliştirici > Yapılandırmayı Düzenle'ye gidin
3. Aşağıdaki yapılandırmayı ekleyin:

macOS Yapılandırması:

{ "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 Yapılandırması:

{ "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 Yapılandırması:

{ "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 yerine gerçek kullanıcı adınızı yazın
5. YOUR_API_TOKEN_HERE yerine BatchData API Token'ınızı yazın
6. Dosyayı kaydedin ve Claude Masaüstü'nü yeniden başlatın

Özel MCP İstemci Kurulumu

Özel MCP istemci uygulamaları için:

Bağlantı Detayları:

Ayar	Değer
Sunucu URL'si	https://mcp.batchdata.com
Aktarım	Akışlı HTTP
Kimlik Doğrulama	Authorization başlığı aracılığıyla Taşıyıcı token

Yapılandırma Örneği:

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

npx kullanarak:

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

---

API Token'dan OAuth'a Geçiş

BatchData'yı daha önce API token yöntemiyle kurduysanız ve daha basit bir deneyim için OAuth'a geçmek istiyorsanız, şu adımları izleyin:

Claude Masaüstü

1. Claude Desktop'ı açın
2. Ayarlar → Geliştirici → Yapılandırmayı Düzenle yoluna gidin
3. Mevcut BatchData yapılandırmasını kaldırın (command, args ve env içeren tüm blok)
4. Yapılandırma dosyasını kaydedip kapatın
5. Bağlayıcıyı kullanıcı arayüzü üzerinden eklemek için Claude Kurulumu (Masaüstü, Web ve Mobil) talimatlarını izleyin
6. İstendiğinde BatchData hesabınızla kimlik doğrulaması yapın

Önce (API Token):

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

Sonra (OAuth): Kullanıcı arayüzü üzerinden yapılandırıldı — JSON düzenlemesi gerekmez.

Claude Code

1. Mevcut yapılandırmayı kaldırın:

claude mcp remove BatchData

2. OAuth kullanarak geri ekleyin:

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

3. İstendiğinde tarayıcınız üzerinden kimlik doğrulaması yapın

ChatGPT

API token'ları ile bir geçici çözüm kullanıyorsanız, basitçe:

1. Ayarlar → Bağlayıcılar bölümünden mevcut BatchData bağlayıcısını kaldırın
2. Yeni bir bağlayıcı oluşturmak için ChatGPT Kurulumu talimatlarını izleyin
3. BatchData hesabınızla kimlik doğrulaması yapın

Geçişin Faydaları

Özellik	API Token	OAuth
Kurulum	Manuel JSON düzenlemesi	Basit kullanıcı arayüzü akışı
Token yönetimi	Manuel yenileme	Otomatik yenileme
Güvenlik	Token yapılandırma dosyasında saklanır	Token'lar istemci tarafından yönetilir
Çoklu cihaz	Her cihazı yapılandırın	Cihazlar arasında senkronize olur

---

Kullanılabilir Araçlar

Bağlandıktan sonra, BatchData MCP Sunucusu aşağıdaki araçları sağlar:

Mülk Sorgulama ve Detaylar

Araç	Açıklama
lookup_property	Kimlik, adres veya parsel numarasına göre detaylı mülk bilgisi alın

Karşılaştırılabilir Mülk Analizi

Araç	Açıklama
comparable_property_count	Karşılaştırılabilir mülklerin sayısını ve toplu metriklerini alın
comparable_property_preview	Özet alanlarla ilk 10 karşılaştırılabilir mülkün hızlı önizlemesi
comparable_property_page	Tam karşılaştırılabilir mülk detaylarına sayfalı erişim (hem ofset hem de imleç tabanlı sayfalamayı destekler)
comparable_property	⚠️ Kullanımdan kaldırıldı — Tüm karşılaştırılabilir mülkleri tek seferde döndürür

Mülk Arama

Araç	Açıklama
search_properties_count	Hızlı liste dökümleriyle arama kriterlerine uyan mülklerin sayısını alın
search_properties_preview	Eşleşen ilk 10 mülkün hızlı önizlemesi
search_properties_page	Tam detaylarla sayfalı mülk araması (ofset ve imleç tabanlı sayfalamayı destekler)

İletişim Bilgileri

Araç	Açıklama
skip_trace_property	Adres veya parsel numarasına göre bir mülk için sahip ve iletişim bilgilerini alın

Telefon Doğrulama

Araç	Açıklama
verify_phone	Erişilebilirlik, DNC durumu, operatör, TCPA davacı durumu dahil tam doğrulama detayları
check_dnc_status	Yalnızca Arama Yasağı durumunu kontrol edin
check_tcpa_status	Yalnızca TCPA davacı durumunu kontrol edin

Adres İşleme

Araç	Açıklama
verify_address	Adresleri USPS uyumluluğuna göre biçimlendirin
geocode_address	Bir adresten koordinatları alın
reverse_geocode_address	Enlem/boylam koordinatlarından adres alın

---

Sorun Giderme

OAuth Sorunları

Sorun	Çözüm
Tarayıcı giriş için açılmıyor	Açılır pencerelere izin verildiğinden emin olun. Varsayılan tarayıcınızın doğru ayarlandığını kontrol edin.
Giriş sayfası "Oturum süresi doldu" gösteriyor	Bağlayıcıyı kaldırıp yeniden ekleyin, ardından tekrar kimlik doğrulaması yapın.
"Çok fazla giriş denemesi" hatası	Tekrar denemeden önce 15 dakika bekleyin.
Google ile Giriş çalışmıyor	Açılır pencerelere izin verildiğinden emin olun ve bunun yerine e-posta/şifre kullanmayı deneyin.
Giriş sonrası bağlantı başarısız	İnternet bağlantınızı kontrol edin. MCP istemcisine geri yönlendirme başarısız olmuş olabilir. Bağlayıcıyı kaldırıp yeniden eklemeyi deneyin.

ChatGPT Sorunları

Sorun	Çözüm
Bağlayıcı oluşturulamıyor	Ayarlar → Uygulamalar ve Bağlayıcılar → Gelişmiş ayarlar bölümünde Geliştirici Modu'nun etkin olduğundan emin olun.
Geliştirici Modu seçeneği eksik	Business/Enterprise için, çalışma alanı yöneticinizin önce Çalışma Alanı Ayarları'nda etkinleştirmesi gerekir.
Kimlik doğrulama başarısız	http://chatgpt.com için açılır pencerelere izin verildiğinden emin olun. Bağlayıcıyı kesip yeniden bağlamayı deneyin.
Araçlar kullanılmıyor	İsteminizde açık olun: "BatchData bağlayıcısını kullanarak...". İstem göndermeden önce + düğmesiyle bağlayıcıyı ekleyin.
Bağlayıcı yanıt vermiyor	Meta verileri güncellemek için Ayarlar → Bağlayıcılar → BatchData → Yenile yoluna gidin. Sunucu geçici olarak kullanılamıyor olabilir.
Yanlış araçlar çağrılıyor	Belirtin: "Yerleşik tarama veya diğer araçları kullanmayın; yalnızca BatchData bağlayıcısını kullanın."

API Token Sorunları

Sorun	Çözüm
401 Yetkisiz	API token'ınızın doğru olduğunu ve süresinin dolmadığını doğrulayın.
403 Yasak	Token'ınızın BatchData Web Uygulaması'nda gerekli uç nokta izinlerine sahip olduğundan emin olun.
Node.js yol hataları	which npx (macOS/Linux) çalıştırarak veya kurulum yolunu (Windows) kontrol ederek npx yolunun var olduğunu doğrulayın.
Yapılandırma yüklenmiyor	Yapılandırma dosyasını kaydettikten sonra MCP istemcinizi yeniden başlatın.

Genel Sorunlar

Sorun	Çözüm
Araçlar görünmüyor	MCP sunucusunun istemcinizin eklentiler listesinde etkin olduğunu doğrulayın.
SkipTracing 403 döndürüyor	SkipTracing v3'ün bir yönetici tarafından ekibiniz için etkinleştirilmesi ve token'ınızın izne sahip olması gerekir.
Yavaş yanıtlar	İnternet bağlantınızı kontrol edin. Sunucu, istekleri BatchData API'lerine vekalet eder.

Yardım Alma

• API Token sorunları: Sunucu tarafı token'larınızı yönetmek için BatchData Web Uygulaması'na giriş yapın
• İzin sorunları: BatchData ekip yöneticinizle iletişime geçin
• Teknik sorunlar: BatchData destek ekibiyle iletişime geçin

---

© BatchData 2025