BatchData MCP (Real Estate & Contact Data)

Guia de Configuração do Servidor MCP Remoto BatchData

• 1 Introdução
• 2 Métodos de Autenticação
  • 2.1 [Autenticação OAuth (Recomendada)](#OAuth-Authentication-(Recommended)
  • 2.2 [Autenticação por Token de API (Alternativa)](#API-Token-Authentication-(Alternative)
• 3 [Aprimoramento Futuro: Controle de Acesso OAuth (Em Breve)](#Future-Enhancement%3A-OAuth-Access-Control-(Coming-Soon)
• 4 [Configuração OAuth (Recomendada)](#OAuth-Setup-(Recommended)
  • 4.1 Pré-requisitos
  • 4.2 [Configuração do Claude (Desktop, Web e Mobile)](#Claude-Setup-(Desktop%2C-Web-%26-Mobile)
    • 4.2.1 Passo 1: Adicionar o Conector BatchData
    • 4.2.2 Passo 2: Autenticar
    • 4.2.3 Passo 3: Habilitar o Conector
    • 4.2.4 Passo 4: Aprovar o Uso Inicial da Ferramenta
    • 4.2.5 Usando no Mobile
    • 4.2.6 Conexões Subsequentes
  • 4.3 Configuração do Cursor
  • 4.4 Configuração do Claude Code
  • 4.5 [Configuração do ChatGPT (Modo Desenvolvedor)](#ChatGPT-Setup-(Developer-Mode)
    • 4.5.1 Pré-requisitos
    • 4.5.2 Passo 1: Habilitar o Modo Desenvolvedor
    • 4.5.3 Passo 2: Criar o Conector BatchData
    • 4.5.4 Passo 3: Autenticar
    • 4.5.5 Usando as Ferramentas BatchData no ChatGPT
    • 4.5.6 Gerenciando a Conexão
  • 4.6 Verificação
• 5 [Configuração de Token de API (Alternativa)](#API-Token-Setup-(Alternative)
  • 5.1 Pré-requisitos
  • 5.2 Configuração do Claude Desktop com Token de API
    • 5.2.1 Passo 1: Instalar Node.js 22
    • 5.2.2 Passo 2: Configurar o Claude Desktop
  • 5.3 Configuração de Cliente MCP Personalizado
• 6 Migrando de Token de API para OAuth
  • 6.1 Claude Desktop
  • 6.2 Claude Code
  • 6.3 ChatGPT
  • 6.4 Benefícios da Migração
• 7 Ferramentas Disponíveis
  • 7.1 Consulta e Detalhes de Imóveis
  • 7.2 Análise de Imóveis Comparáveis
  • 7.3 Busca de Imóveis
  • 7.4 Informações de Contato
  • 7.5 Verificação de Telefone
  • 7.6 Processamento de Endereço
• 8 Solução de Problemas
  • 8.1 Problemas com OAuth
  • 8.2 Problemas com ChatGPT
  • 8.3 Problemas com Token de API
  • 8.4 Problemas Gerais
  • 8.5 Obtendo Ajuda

Introdução

Este guia documenta como conectar-se ao Servidor MCP Remoto BatchData usando seu cliente compatível com MCP.

Métodos de Autenticação

O Servidor MCP BatchData suporta dois métodos de autenticação:

Método	Complexidade de Configuração	Segurança	Recomendado Para
OAuth (Recomendado)	Simples	Alta	A maioria dos usuários
Token de API	Configuração manual	Moderada	Clientes MCP personalizados, depuração

Autenticação OAuth (Recomendada)

OAuth oferece uma experiência de conexão simplificada:

• Sem necessidade de configurar token de API — Basta fornecer a URL do servidor
• Login pelo navegador — Autentique-se com as credenciais da sua conta BatchData
• Gerenciamento automático de tokens — Tokens de acesso são renovados automaticamente
• Experiência de login familiar — Use e-mail/senha ou Google Sign-In

Autenticação por Token de API (Alternativa)

Para usuários que preferem a configuração direta do token de API ou estão usando clientes MCP personalizados que não suportam OAuth:

• Requer obter e configurar seu token de API BatchData manualmente
• O token deve ser gerenciado e protegido como uma credencial sensível
• Útil para depuração, scripts de automação ou clientes sem suporte a OAuth

Aprimoramento Futuro: Controle de Acesso OAuth (Em Breve)

Estamos desenvolvendo recursos aprimorados de controle de acesso para autenticação OAuth:

• Verificação de permissão — O login OAuth verificará automaticamente se sua conta tem permissão para usar o servidor MCP
• Gerenciamento de acesso centralizado — Proprietários de equipe poderão conceder ou revogar o acesso ao servidor MCP para membros da equipe através da plataforma BatchData

---

Configuração OAuth (Recomendada)

Pré-requisitos

• Uma conta BatchData com credenciais válidas
• Um cliente compatível com MCP (Claude Desktop/Web/Mobile, ChatGPT, Cursor, Claude Code ou similar)

Configuração do Claude (Desktop, Web e Mobile)

O Claude suporta servidores MCP através do aplicativo desktop, interface web e aplicativo mobile.

Nota para Mobile: Conectores não podem ser adicionados pelo aplicativo mobile. Adicione o conector primeiro no Desktop ou Web, e ele estará automaticamente disponível no mobile para a mesma conta.

Nota para Equipes/Enterprise: Administradores do espaço de trabalho devem primeiro adicionar o conector BatchData à lista de conectores disponíveis antes que os membros da equipe possam configurá-lo. Entre em contato com seu administrador se não encontrar o conector na sua lista.

Passo 1: Adicionar o Conector BatchData

1. Abra o Claude (Desktop ou Web)
2. Vá para Configurações → Conectores (ou Configurações → Servidores MCP)
3. Clique em Adicionar Conector (ou Adicionar Servidor)
4. Insira a URL do servidor:

https://mcp.batchdata.com

5. Clique em Adicionar ou Conectar

Passo 2: Autenticar

1. Seu navegador abrirá a página de login do BatchData
2. Faça login usando:

• E-mail e senha — Insira as credenciais da sua conta BatchData
• Google Sign-In — Clique no botão do Google para autenticar

3. Após o login bem-sucedido, você será redirecionado de volta para o Claude

Passo 3: Habilitar o Conector

Os conectores não são habilitados por padrão após serem adicionados. Habilite-o uma vez e a configuração será salva:

1. Abra qualquer chat
2. Clique no botão + (ou ícone de conectores) na área de entrada do chat
3. Encontre BatchData na lista de conectores disponíveis
4. Alterne para ligado para habilitá-lo

O conector agora estará disponível em todas as suas conversas.

Passo 4: Aprovar o Uso Inicial da Ferramenta

Na primeira vez que o Claude usar qualquer ferramenta BatchData, você será solicitado a aprová-la:

1. Quando o Claude tentar usar uma ferramenta, um aviso de permissão aparecerá
2. Revise a ferramenta e a ação solicitada
3. Clique em Permitir para aprovar
4. Selecione "Sempre permitir" se quiser pular a aprovação para usos futuros dessa ferramenta

Nota: Após a aprovação inicial (ou selecionar "Sempre permitir"), os usos subsequentes da ferramenta não exigirão confirmação adicional.

Usando no Mobile

Depois de adicionar e autenticar o conector no Desktop ou Web:

• Abra o aplicativo mobile do Claude com a mesma conta
• O conector BatchData estará disponível na sua lista de conectores
• Se ainda não estiver habilitado, alterne para ligado através do botão + na entrada do chat (a configuração sincroniza entre dispositivos)
• As aprovações de ferramentas concedidas no Desktop/Web são transferidas para o mobile
• Todas as ferramentas funcionam da mesma forma que no Desktop/Web

Conexões Subsequentes

Após a autenticação inicial:

• Os tokens de acesso são armazenados em cache e renovados automaticamente em todos os dispositivos
• Você não precisará fazer login novamente, a menos que sua sessão expire (normalmente após 14 dias de inatividade)
• Se for solicitado a reautenticar, basta fazer login novamente pelo seu navegador (no Desktop ou Web)

Configuração do Cursor

1. Abra as Configurações do Cursor
2. Navegue até a seção de configuração MCP
3. Clique em Adicionar Servidor MCP
4. Insira a URL do servidor:

https://mcp.batchdata.com

5. No primeiro uso, autentique-se através do pop-up do navegador

Configuração do Claude Code

Adicione o servidor MCP BatchData diretamente via CLI:

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

No primeiro uso, você será solicitado a autenticar através do seu navegador.

Configuração do ChatGPT (Modo Desenvolvedor)

O ChatGPT suporta servidores MCP através do Modo Desenvolvedor, que fornece suporte completo ao cliente Model Context Protocol.

Pré-requisitos

• Uma assinatura ChatGPT Plus ou Pro
• Para Business/Enterprise: O administrador deve habilitar o modo desenvolvedor nas Configurações do Espaço de Trabalho

Passo 1: Habilitar o Modo Desenvolvedor

1. Abra o ChatGPT
2. Vá para Configurações → Aplicativos e Conectores → Configurações avançadas
3. Alterne Modo desenvolvedor para ligado

Para espaços de trabalho Business/Enterprise:

• Os administradores devem primeiro habilitar o modo desenvolvedor em Configurações do Espaço de Trabalho → Permissões e Funções → Dados Conectados → Modo desenvolvedor / Criar conectores MCP personalizados

Passo 2: Criar o Conector BatchData

1. No ChatGPT, vá para Configurações → Conectores
2. Clique em Criar
3. Insira os seguintes detalhes:

• Nome do conector: BatchData
• URL do Servidor MCP: https://mcp.batchdata.com

4. Clique em Criar

Passo 3: Autenticar

1. Após criar o conector, o ChatGPT solicitará que você autentique
2. Seu navegador abrirá a página de login do BatchData
3. Faça login usando:

• E-mail e senha — Insira as credenciais da sua conta BatchData
• Google Sign-In — Clique no botão do Google para autenticar

4. Após o login bem-sucedido, você será redirecionado de volta para o ChatGPT
5. O conector BatchData está pronto para uso

Usando as Ferramentas BatchData no ChatGPT

Uma vez conectado, você pode usar as ferramentas BatchData nas conversas:

1. Inicie um novo chat
2. Clique no botão + e selecione seu conector no menu Mais
3. Alternativamente, escolha Modo desenvolvedor no menu Plus e selecione BatchData
4. Faça perguntas relacionadas a imóveis — o ChatGPT usará as ferramentas apropriadas

Exemplos de prompts:

• "Consulte o imóvel em 123 Main Street, Los Angeles, CA"
• "Encontre imóveis comparáveis para 456 Oak Avenue"
• "Rastreie o proprietário de 789 Pine Road, Miami, FL"

Gerenciando a Conexão

• Para desconectar: Vá para Configurações → Conectores, clique em BatchData e desconecte
• Para reconectar: Clique no conector e reautentique
• Expiração da sessão: Se sua sessão expirar (normalmente após 14 dias), você será solicitado a reconectar

Verificação

Uma vez conectado, basta perguntar sobre dados de imóveis ou skip-tracing e o LLM usará automaticamente as ferramentas BatchData.

Exemplos de prompts:

• "Consulte o imóvel em 123 Main Street, Los Angeles, CA"
• "Rastreie o proprietário de 456 Oak Avenue, Miami, FL"
• "Encontre imóveis comparáveis para 789 Pine Road, Austin, TX"
• "Busque imóveis vagos em Miami, FL"
• "Verifique este número de telefone: 555-123-4567"
• "Verifique e padronize este endereço: 100 main st los angeles ca"
• "Obtenha as coordenadas para 200 Park Avenue, New York, NY"

O Claude ou ChatGPT reconhecerá a intenção e usará as ferramentas BatchData apropriadas para buscar as informações.

---

Configuração de Token de API (Alternativa)

Use este método se:

• Seu cliente MCP não suporta OAuth
• Você precisa depurar ou automatizar conexões com o servidor MCP
• Você prefere o gerenciamento explícito de tokens

Pré-requisitos

• Seu Token de API BatchData (obtenha no Aplicativo Web BatchData)
• Um cliente compatível com MCP
• Node.js 22+ (para Claude Desktop)

Configuração do Claude Desktop com Token de API

Passo 1: Instalar Node.js 22

O Node.js integrado do Claude Desktop está desatualizado. Instale o Node.js 22 separadamente:

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:

Baixe e instale o Node.js 22.x LTS de nodejs.org

Passo 2: Configurar o Claude Desktop

1. Abra o Claude Desktop
2. Vá para Configurações > Desenvolvedor > Editar Configuração
3. Adicione a seguinte configuração:

Configuração para 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" } } } }

Configuração para 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" } } } }

Configuração para 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. Substitua YOUR_USERNAME pelo seu nome de usuário real
5. Substitua YOUR_API_TOKEN_HERE pelo seu Token de API BatchData
6. Salve o arquivo e reinicie o Claude Desktop

Configuração de Cliente MCP Personalizado

Para implementações de cliente MCP personalizado:

Detalhes da Conexão:

Configuração	Valor
URL do Servidor	https://mcp.batchdata.com
Transporte	HTTP Transmissível
Autenticação	Token Bearer via cabeçalho Authorization

Exemplo de Configuração:

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

Usando npx:

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

---

Migrando de Token de API para OAuth

Se você configurou anteriormente o BatchData usando o método de token de API e deseja mudar para OAuth para uma experiência mais simples, siga estes passos:

Claude Desktop

1. Abra o Claude Desktop
2. Vá para Configurações → Desenvolvedor → Editar Configuração
3. Remova a configuração existente do BatchData (todo o bloco com command, args e env)
4. Salve e feche o arquivo de configuração
5. Siga as instruções de Configuração do Claude (Desktop, Web e Mobile) para adicionar o conector via IU
6. Autentique-se com sua conta BatchData quando solicitado

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

Depois (OAuth): Configurado via IU — sem necessidade de editar JSON.

Claude Code

1. Remova a configuração existente:

claude mcp remove BatchData

2. Adicione-a novamente usando OAuth:

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

3. Autentique-se através do seu navegador quando solicitado

ChatGPT

Se você estava usando uma solução alternativa com tokens de API, simplesmente:

1. Remova qualquer conector BatchData existente em Configurações → Conectores
2. Siga as instruções de Configuração do ChatGPT para criar um novo conector
3. Autentique-se com sua conta BatchData

Benefícios da Migração

Aspecto	Token de API	OAuth
Configuração	Edição manual de JSON	Fluxo de IU simples
Gerenciamento de token	Rotação manual	Renovação automática
Segurança	Token armazenado em arquivo de configuração	Tokens gerenciados pelo cliente
Multi-dispositivo	Configurar cada dispositivo	Sincroniza entre dispositivos

---

Ferramentas Disponíveis

Uma vez conectado, o Servidor MCP BatchData fornece as seguintes ferramentas:

Consulta e Detalhes de Imóveis

Ferramenta	Descrição
lookup_property	Obter informações detalhadas do imóvel por ID, endereço ou número de parcela

Análise de Imóveis Comparáveis

Ferramenta	Descrição
comparable_property_count	Obter contagem e métricas agregadas de imóveis comparáveis
comparable_property_preview	Pré-visualização rápida dos primeiros 10 comparáveis com campos de resumo
comparable_property_page	Acesso paginado aos detalhes completos dos imóveis comparáveis (suporta paginação por deslocamento e baseada em cursor)
comparable_property	⚠️ Obsoleto — Retorna todos os comparáveis de uma vez

Busca de Imóveis

Ferramenta	Descrição
search_properties_count	Obter contagem de imóveis que correspondem aos critérios de busca com detalhamentos de lista rápida
search_properties_preview	Pré-visualização rápida dos primeiros 10 imóveis correspondentes
search_properties_page	Busca paginada de imóveis com detalhes completos (suporta paginação por deslocamento e baseada em cursor)

Informações de Contato

Ferramenta	Descrição
skip_trace_property	Obter informações do proprietário e contato de um imóvel por endereço ou número de parcela

Verificação de Telefone

Ferramenta	Descrição
verify_phone	Detalhes completos da verificação, incluindo acessibilidade, status DNC, operadora, status de litigante TCPA
check_dnc_status	Verificar apenas o status de Não Perturbe
check_tcpa_status	Verificar apenas o status de litigante TCPA

Processamento de Endereço

Ferramenta	Descrição
verify_address	Formatar endereços para conformidade com USPS
geocode_address	Obter coordenadas de um endereço
reverse_geocode_address	Obter endereço a partir de coordenadas de latitude/longitude

---

Solução de Problemas

Problemas com OAuth

Problema	Solução
Navegador não abre para login	Certifique-se de que pop-ups são permitidos. Verifique se seu navegador padrão está definido corretamente.
Página de login mostra "Sessão expirada"	Remova e adicione novamente o conector e autentique-se novamente.
Erro "Muitas tentativas de login"	Aguarde 15 minutos antes de tentar novamente.
Google Sign-In não funciona	Certifique-se de que pop-ups são permitidos e tente usar e-mail/senha.
Conexão falha após o login	Verifique sua conexão com a internet. O redirecionamento de volta para o cliente MCP pode ter falhado. Tente remover e adicionar novamente o conector.

Problemas com ChatGPT

Problema	Solução
Não é possível criar conectores	Certifique-se de que o Modo Desenvolvedor está habilitado em Configurações → Aplicativos e Conectores → Configurações avançadas.
Opção Modo Desenvolvedor ausente	Para Business/Enterprise, o administrador do seu espaço de trabalho deve habilitá-lo primeiro nas Configurações do Espaço de Trabalho.
Falha na autenticação	Certifique-se de que pop-ups são permitidos para http://chatgpt.com . Tente desconectar e reconectar o conector.
Ferramentas não estão sendo usadas	Seja explícito no seu prompt: "Use o conector BatchData para...". Adicione o conector via botão + antes de perguntar.
Conector não está respondendo	Vá para Configurações → Conectores → BatchData → Atualizar para atualizar metadados. O servidor pode estar temporariamente indisponível.
Ferramentas erradas estão sendo chamadas	Especifique: "Não use navegação integrada ou outras ferramentas; use apenas o conector BatchData."

Problemas com Token de API

Problema	Solução
401 Não Autorizado	Verifique se seu token de API está correto e não expirou.
403 Proibido	Certifique-se de que seu token tem as permissões de endpoint necessárias no Aplicativo Web BatchData.
Erros de caminho do Node.js	Verifique se o caminho para o npx existe executando which npx (macOS/Linux) ou verificando o caminho de instalação (Windows).
Configuração não está carregando	Reinicie seu cliente MCP após salvar o arquivo de configuração.

Problemas Gerais

Problema	Solução
Ferramentas não aparecem	Verifique se o servidor MCP está habilitado na lista de extensões do seu cliente.
SkipTracing retorna 403	SkipTracing v3 deve ser habilitado para sua equipe por um administrador, e seu token precisa da permissão.
Respostas lentas	Verifique sua conexão com a internet. O servidor faz proxy das solicitações para as APIs BatchData.

Obtendo Ajuda

• Problemas com Token de API: Faça login no Aplicativo Web BatchData para gerenciar seus tokens do lado do servidor
• Problemas de permissão: Entre em contato com o administrador da sua equipe BatchData
• Problemas técnicos: Entre em contato com a equipe de suporte BatchData

---

© BatchData 2025