Casafari MCP no Claude, ChatGPT e Gemini CLI: dados imobiliários dentro do seu assistente de IA

Os servidores Casafari MCP ligam o grafo de imóveis da CASAFARI — que cobre 16 países (EUA: em fase de entrada, estados selecionados, apenas imobiliário comercial, através do Claro AI) com registos limpos e desduplicados — diretamente ao Claude, ChatGPT, Gemini CLI, Claude Code, Cursor e outros clientes MCP. Cada produto possui o seu servidor em https://platform.casafari.com/mcp/<produto>, com início de sessão por OAuth 2.1 no navegador e um plano Free com 1.000 tokens durante 30 dias sem cartão, segundo a documentação da CASAFARI (outubro de 2026).

O que é um servidor MCP e porque interessa a quem trabalha no imobiliário

Imagine uma consultora imobiliária em Lisboa numa sexta-feira à tarde. Está no escritório a preparar uma reunião de angariação para uma fração em Campo de Ourique e tem o Claude aberto. O assistente escreve textos com clareza e estrutura análises, mas não conhece os valores efetivos praticados no bairro no último mês nem o histórico de preços dos imóveis concorrentes.

O Model Context Protocol (MCP) resolve esta lacuna. Trata-se de um padrão aberto apresentado pela Anthropic no seu anúncio do Model Context Protocol em novembro de 2024, concebido para permitir que assistentes de inteligência artificial consultem fontes de dados externas através de ferramentas padronizadas.

Em vez de estimar valores ou depender de dados desatualizados, o seu assistente de IA passa a consultar diretamente o grafo de imóveis da CASAFARI (em inglês), que desduplica e organiza listagens do mercado residencial e comercial, para venda e para arrendamento. Não precisa de mudar de aplicação nem de adotar uma interface nova: continua no assistente que já utiliza no seu dia a dia, agora alimentado com informação fidedigna do mercado português.

A arquitetura assenta no protocolo Streamable HTTP, com um servidor dedicado por produto:

• locations: Location Lookup para resolução geográfica.
• area-insights: Area Insights para métricas de mercado.
• comparables: Comparables para procura de imóveis semelhantes e avaliações.
• agentgraph: AgentGraph para análise de agências e consultores na Alemanha (apenas para empresas verificadas).
• claro: Claro para imóveis comerciais na Alemanha e Espanha.

Como é uma sessão: de um nome de zona a comparáveis em quatro perguntas

Uma interação típica não exige que saiba identificadores técnicos. O processo começa pela conversão de nomes de lugares em referências geográficas exatas:

1. Resolução geográfica: Peça ao assistente: Resolve Campo de Ourique, Lisboa. O assistente aciona a ferramenta Location Lookup, que devolve o identificador de localização único. Esta operação consome 0 tokens.
2. Análise de zona: Em seguida, solicite Dá-me os Area Insights desta zona: preço médio por m² à venda e para arrendamento, stock e dias no mercado. O assistente transmite o identificador obtido no passo anterior ao servidor de Area Insights e apresenta o resumo analítico.
3. Procura de comparáveis: Pergunte Encontra Comparables para um T3 de 110 m² com elevador, vendidos nos últimos 12 meses nesta zona. O servidor Comparables devolve as frações correspondentes com o respetivo histórico de preços.
4. Imóveis comerciais (âmbito específico): Se o seu trabalho se estender ao mercado internacional, pode questionar Que lojas de rua estão disponíveis perto de Gran Vía, Madrid. O servidor Claro consulta o stock de espaço comercial em Espanha ou na Alemanha.

É importante salientar que a cobertura do produto Claro abrange exclusivamente instalações comerciais em Espanha e na Alemanha, bem como terrenos comerciais apenas na Alemanha. O mercado português não está incluído no Claro, sendo servido para habitação e comércio geral através dos restantes conectores da CASAFARI.

Paralelamente, o servidor AgentGraph permite identificar as agências e os consultores que operam numa determinada área da Alemanha e avaliar o seu desempenho, o que facilita a análise de parceiros e da concorrência.

Como adicionar o conector em cada cliente

No Claude (claude.ai, Desktop e telemóvel)

Aceda a Definições → Conectores (Connectors) → Adicionar conector personalizado (Add custom connector). Cole o URL do produto desejado, como https://platform.casafari.com/mcp/area-insights, e conclua o início de sessão no navegador. Não há qualquer chave de API para copiar manualmente.

No ChatGPT (modo Developer)

Em Definições (Settings) → Conectores (Connectors), ative o modo Developer. Selecione Criar (Create), insira o URL do servidor Casafari MCP pretendido e conclua a autenticação na janela do navegador que se abre automaticamente.

No Gemini CLI

Na sua linha de comandos, execute o comando de adição e proceda à autenticação interna:

gemini mcp add --transport http casafari-area-insights https://platform.casafari.com/mcp/area-insights
/mcp auth casafari-area-insights

No Claude Code, Cursor, VS Code e outros

O processo é idêntico em ambientes de desenvolvimento como Claude Code, Cursor, VS Code, Codex CLI, Devin Desktop (anteriormente Windsurf), Visual Studio, Zed, Cline, JetBrains Junie, Kiro, Warp ou goose. Basta registar o URL do servidor e concluir a autenticação OAuth 2.1. Pode consultar as instruções específicas no guia de ligação para cada cliente MCP (em inglês). O repositório GitHub casafari/casafari-mcp (em inglês) inclui um plugin para o Claude Code, uma extensão para o Gemini CLI e exemplos de código.

Ao realizar a primeira autenticação, a sua conta é criada automaticamente no plano Free, sem necessidade de introduzir dados de cartão de crédito.

Quanto custa: tokens, planos e o que é gratuito

O consumo da integração é medido estritamente em tokens, aplicando-se as seguintes condições detalhadas nas perguntas frequentes do developers.casafari.com (em inglês) (outubro de 2026):

• Plano Free: atribui 1.000 tokens válidos por 30 dias na criação da conta, sem cartão de crédito.
• Plano Agent: custa 49 € por mês com faturação anual ou 70 € mês a mês, sem IVA. A opção anual representa 588 € por ano, face aos 840 € da modalidade mensal sem fidelização, o que representa uma diferença de 252 € por ano.
• Plano Custom: contratado sob medida para volumes elevados ou equipas alargadas.
• Consumo extra: suportado através da aquisição de créditos pré-pagos.
• Resolução de zonas: as pesquisas no Location Lookup consomem 0 tokens, o que permite identificar localizações sem impacto no saldo.

Para esclarecer dúvidas sobre faturas, IVA ou métodos de pagamento, pode consultar a secção de faturação e subscrição no centro de ajuda. Se já utiliza a plataforma web e pretende explorar esta integração, basta iniciar sessão na plataforma CASAFARI.

Segurança: OAuth 2.1, sessão no navegador e ferramentas só de leitura

O processo de autenticação cumpre a especificação de autorização do MCP, baseada em OAuth 2.1. Quando associa um servidor, o navegador abre a página oficial da CASAFARI para validação das credenciais. O assistente de IA recebe unicamente um access token de autorização, nunca tendo acesso à sua palavra-passe.

Convém distinguir claramente o access token de OAuth — que garante a segurança da ligação — dos tokens de utilização, que correspondem ao saldo de consumo da conta.

As ferramentas disponibilizadas nos servidores Casafari MCP funcionam essencialmente em modo de leitura (a única exceção é a lista de acompanhamento do AgentGraph): efetuam consultas ao grafo de imóveis e aos indicadores de área sem alterar definições da conta nem realizar modificações contratuais. Se pretender interromper a ligação a um assistente, pode revogar o acesso a qualquer momento na gestão da sua conta na plataforma.

Para quem é: consultores, analistas e programadores em Portugal

Esta integração adapta-se a diferentes perfis profissionais do setor imobiliário em Portugal:

• Consultores e brokers imobiliários: fundamentam reuniões de angariação e propostas de serviço com números reais retirados do mercado em tempo real, combinando a fluência do Claude ou do ChatGPT com o Area Insights na plataforma CASAFARI. Pode também aprender mais sobre comandos de ChatGPT para agentes imobiliários e ver como melhorar o trabalho imobiliário com IA.
• Analistas e investidores: examinam múltiplos concelhos e freguesias de forma consecutiva, estruturando comparações entre Lisboa, Porto e Algarve diretamente na janela do assistente antes de exportar conclusões.
• Programadores e equipas de produto: utilizam os servidores MCP no Cursor ou Claude Code enquanto constroem ferramentas internas, passando facilmente para a API de dados imobiliários da CASAFARI caso necessitem de integrações diretas via API. Encontre exemplos de perguntas e sessões no developers.casafari.com (em inglês).

Para começar a utilizar, visite a página do produto CASAFARI MCP, aceda à plataforma e adicione o URL do servidor ao seu assistente de preferência. Caso necessite de uma solução para toda a sua equipa, pode pedir um plano Custom a partir da plataforma (como funcionam os planos, em inglês).

Perguntas frequentes

O que é o Casafari MCP e o que posso perguntar-lhe?

O Casafari MCP é um conjunto de servidores baseados no protocolo Model Context Protocol que ligam assistentes como o Claude ou o ChatGPT ao grafo de imóveis da CASAFARI. Através dele, pode pedir dados de mercado de uma zona, comparáveis para uma avaliação ou informações sobre agências ativas numa região. Por exemplo, pode perguntar ‘Dá-me o preço médio por m² e stock em Paranhos, Porto’ ou ‘Encontra comparáveis para um T2 em Alvalade, Lisboa’, segundo a documentação no developers.casafari.com (outubro de 2026).

Como ligo o Claude ou o ChatGPT aos dados da Casafari?

No Claude, aceda a Definições → Conectores, selecione a opção para adicionar um conector personalizado, cole o URL do produto (por exemplo, https://platform.casafari.com/mcp/area-insights) e inicie sessão no navegador. No ChatGPT, ative o modo Developer em Conectores, crie o conector com o mesmo URL e conclua a autenticação OAuth 2.1. Não é necessário copiar chaves manuais e a primeira autenticação ativa automaticamente o plano Free sem cartão de crédito.

Quanto custa usar o Casafari MCP?

O plano Free atribui 1.000 tokens durante 30 dias sem necessidade de cartão de crédito. O plano Agent custa 49 € por mês na faturação anual ou 70 € mês a mês, sem IVA, existindo também o plano Custom sob contrato e créditos pré-pagos para consumo adicional. A resolução de zonas no Location Lookup tem um custo de 0 tokens, conforme indicado na tabela de preços oficial de outubro de 2026.

É seguro ligar um assistente de IA à minha conta Casafari?

A autenticação é efetuada no navegador via OAuth 2.1, pelo que o assistente de IA recebe um access token e nunca a sua palavra-passe. As ferramentas de dados funcionam em modo de leitura para consultar dados de mercado; apenas as ferramentas de lista de acompanhamento do AgentGraph AI guardam ou removem entradas na lista de acompanhamento da sua organização. O acesso pode ser revogado a qualquer instante nas definições da sua conta na plataforma CASAFARI. Relembra-se que este access token de segurança difere dos tokens de consumo da conta.

O Casafari MCP cobre Portugal e que outros países?

O grafo de imóveis da CASAFARI cobre Portugal e mais 15 países, abrangendo imóveis residenciais e comerciais, para venda e arrendamento, com histórico de preços e estado do anúncio. Para verificar a lista completa de coberturas, consulte a página sobre em que países está disponível a CASAFARI. Exceção feita ao servidor Claro, que se destina a imóveis comerciais em Espanha e na Alemanha, e ao servidor AgentGraph, que cobre apenas a Alemanha.