Claro: app, servidor MCP ou API? Qual a porta certa para a sua equipa de expansão

O Claro é o agente de pesquisa de expansão de negócio da CASAFARI para encontrar lojas, espaços de restauração, escritórios e armazéns em Espanha e na Alemanha, e terrenos comerciais na Alemanha. A mesma pesquisa disponibiliza três portas de acesso: a app Claro em expansion.casafari.com para o gestor de expansão, o servidor Casafari MCP para quem trabalha no Claude ou no ChatGPT, e a API REST para o programador que alimenta o CRM da empresa. A app serve quem decide hoje; o servidor MCP atende a equipa que prefere pesquisar em linguagem corrente; a API REST executa os processos que têm de correr todas as noites.

Imagine um grupo de restauração sediado em Lisboa que acaba de aprovar a entrada no mercado espanhol, e planeia abrir as duas primeiras unidades em Madrid. Espanha manteve-se como o principal destino das exportações portuguesas de mercadorias em 2025, de acordo com o destaque do INE sobre o comércio internacional em 2025 publicado em dezembro de 2025, enquanto a Alemanha figurou entre os três principais clientes comerciais de Portugal (dados do INE de 2024, divulgados em fevereiro de 2025). Quando uma marca portuguesa decide cruzar a fronteira para estes dois mercados, a escolha do imóvel comercial certo exige rapidez e rigor analítico.

O que o Claro procura, e onde

O Claro pesquisa imóveis comerciais (lojas de rua, espaços de restauração, escritórios e armazéns) para arrendamento ou venda em Espanha e na Alemanha, além de terrenos comerciais exclusivamente no mercado alemão. Importa referir com clareza: o Claro não cobre o mercado português. Para a prospeção e avaliação em território nacional, a CASAFARI disponibiliza soluções dedicadas como o Area Insights, o Comparables e o Property Sourcing. O Claro foi concebido especificamente para apoiar as empresas portuguesas na sua expansão para Espanha e Alemanha.

Nas suas respostas, o Claro apresenta contagens exatas de imóveis compatíveis. Cada critério do caderno de encargos é categorizado de forma inequívoca como cumprido, não cumprido ou não indicado, acompanhado da citação textual do anúncio em que assenta a decisão, sem qualquer tipo de inferência. Os dados de contexto geográfico são fornecidos pela Location Intelligence — tecnologia integrada após a aquisição da Targomo e os dados de localização —, disponibilizando o índice de fluxo pedonal num raio de 5 minutos a pé (um índice comparativo, não uma contagem de transeuntes), o número de residentes e o poder de compra da zona, indicando sempre a fonte e o ano dos dados.

Toda esta análise assenta na base de dados imobiliária da CASAFARI, que organiza e limpa registos residenciais e comerciais em 16 países (EUA: em fase de entrada, estados selecionados, apenas imobiliário comercial, através do Claro AI), atribuindo a cada imóvel um perfil único com o seu histórico completo de preços e estados.

Três portas para a mesma pesquisa: app, servidor MCP ou API REST

Para responder às diferentes rotinas de trabalho de uma empresa, o Claro oferece três interfaces distintas que acedem exatamente ao mesmo motor de pesquisa:

• A app Claro: a interface web pronta a usar, ideal para o gestor de expansão que necessita de analisar um caderno de encargos sem instalar software.
• O servidor MCP: a ligação direta para consultores e analistas que trabalham habitualmente em assistentes de IA como o Claude ou o ChatGPT.
• A API REST: o ponto de acesso técnico para programadores que pretendem automatizar pesquisas, criar ferramentas internas ou alimentar o CRM.

As três portas partilham a mesma conta, os mesmos tokens de utilização e a mesma precisão de dados. A escolha da porta altera apenas a forma como a equipa interage com a informação.

Quando usar a app Claro em expansion.casafari.com

A app web do Claro é a escolha certa quando um gestor de expansão dispõe de um documento com os requisitos de localização e precisa de apresentar uma seleção inicial ao comité de direção no próprio dia. Não exige qualquer configuração técnica nem intervenção do departamento de informática.

O processo na app decorre em quatro passos simples:

1. Carregar o caderno de encargos com brief_from_file: o utilizador faz o carregamento do ficheiro PDF com as especificações (por exemplo: “loja de rua, 80 a 150 m², centro de Madrid, fachada mínima de 6 metros, renda máxima de 6.000 €/mês”). O Claro converte o documento numa pesquisa e devolve o número exato de espaços encontrados, identificando os critérios cumpridos, não cumpridos ou omissos.
2. Ajustar os resultados com refine_search em linguagem natural: basta escrever instruções como “elimina os imóveis sem licença de restauração e restringe a pesquisa aos bairros de Chamberí e Salamanca”. A contagem é atualizada instantaneamente com base estrita nos dados verificados.
3. Comparar os finalistas com compare_premises: a app gera uma tabela comparativa detalhada com os imóveis selecionados para a shortlist.
4. Analisar a localização com explain_location: para o espaço escolhido, o Claro apresenta o índice de fluxo pedonal, a população residente e o poder de compra envolvente.

Voltando ao exemplo do grupo de restauração lisboeta, o responsável de expansão consegue transformar um documento de requisitos numa shortlist fundamentada para Madrid em poucos minutos.

Quando ligar o Claro ao Claude ou ao ChatGPT (servidor MCP)

O servidor MCP (Model Context Protocol) destina-se aos analistas e consultores que preparam relatórios e dossiês de oportunidade diretamente no Claude ou no ChatGPT e preferem receber os dados imobiliários integrados na sua conversa habitual.

A configuração do conector faz-se de forma direta:

1. No assistente de IA escolhido, adiciona-se um conector personalizado que aponta para o endereço https://platform.casafari.com/mcp/claro (que utiliza o transporte Streamable HTTP).
2. O utilizador autentica-se no navegador através do protocolo OAuth 2.1, sem necessidade de copiar chaves de API. De acordo com a especificação técnica definida em como ligar o servidor MCP do Claro ao Claude ou ao ChatGPT (em inglês) (outubro de 2026), a conta é criada no primeiro acesso no plano Free, com 1.000 tokens válidos por 30 dias, sem pedir cartão de crédito. É importante notar que estes “access tokens” de autenticação OAuth não se confundem com os tokens de consumo de utilização da plataforma.

Através deste conector, o assistente passa a executar as ferramentas do Claro diretamente no chat: brief_from_file, refine_search, compare_premises, market_snapshot, explain_location e search_plots (para terrenos na Alemanha).

Em testes documentados em os relatórios de exemplo escritos pelo Claude com o Claro (em inglês) (outubro de 2026), o Claude utilizou o conector do Claro para realizar triagens complexas:

• Café de especialidade em Valência: análise de 546 imóveis comerciais, resultando numa shortlist ordenada de 6 candidatos.
• Rede de smash burgers em Madrid e Barcelona: triagem de 2.296 espaços disponíveis, terminando em 6 finalistas com explicação detalhada dos valores de trespasse (key money ou traspaso).
• Clube de fitness: triagem de 483 imóveis em 45 municípios, selecionando 7 localizações viáveis.
• Ginásio de grande formato (1.200 a 3.000 m²): identificação de 4 candidatos principais num universo de 197 hipóteses.
• Centros de inspeção automóvel na Alemanha (Kfz-Prüfstellen): avaliação de 1.279 terrenos comerciais através da ferramenta search_plots, classificando os 6 melhores com uma pontuação de 0 a 100.

Esta funcionalidade é compatível com múltiplos clientes MCP, incluindo Claude (web, aplicação de ambiente de trabalho e telemóvel), ChatGPT (modo Developer), Claude Code, Cursor, VS Code e Gemini CLI. Para consultar o código e capturas de ecrã públicas de sessões reais, pode visitar o repositório público casafari-mcp no GitHub ou saber mais em a página do CASAFARI MCP para agentes de IA.

Quando construir com a API REST do Claro

A API REST do Claro foi desenhada para as equipas de engenharia de software que precisam de integrar a prospeção comercial nos sistemas internos da empresa, sem depender da intervenção manual de um utilizador. Se deseja aprofundar os conceitos de integração imobiliária, consulte a plataforma de integração de dados da CASAFARI e leia o artigo explicativo sobre o que é uma API imobiliária.

A API disponibiliza 12 operações REST que permitem criar quatro fluxos automatizados fundamentais:

1. Pipeline de prospeção diário: um processo agendado executa automaticamente o caderno de encargos guardado todas as noites, inserindo as novas oportunidades no CRM da empresa com os respetivos comprovativos de cada critério.
2. Caixa de pesquisa na intranet: o gestor de expansão digita na ferramenta interna da empresa (“armazém de 2.000 m² perto de Saragoça com acesso a veículos pesados”) e o sistema executa a operação refine_search em segundo plano.
3. Processamento automático de PDFs: a equipa envia o documento do comité para a operação brief_from_file, disponibilizando os resultados numa pasta partilhada.
4. Relatórios formatados para o comité: a API executa compare_premises e explain_location para os finalistas, devolvendo os dados prontos a preencher no modelo de apresentação interno.

Um detalhe de eficiência operacional: o Claro aceita os nomes das cidades e dos bairros, como “Chamberí” ou “Kreuzberg”, diretamente nos critérios da pesquisa, sem passo prévio de conversão; e, quando a equipa combina o Claro com outros produtos da plataforma, como o Area Insights, a resolução de nomes de locais em identificadores através do Location Lookup consome 0 tokens. Para documentação técnica completa, consulte a documentação do Claro em developers.casafari.com (em inglês) e os casos de uso do Claro para programadores (em inglês).

Quanto custa: planos e tokens

O consumo de informação no Claro é medido de forma uniforme em tokens, independentemente de utilizar a app web, o servidor MCP ou a API REST:

• Plano Free: inclui 1.000 tokens válidos por 30 dias, sem necessidade de introduzir cartão de crédito.
• Plano Agent: 49 € por mês na subscrição anual (ou 70 € por mês na subscrição mensal), valores acrescidos de IVA.
• Plano Custom: ajustado por contrato para grande volume, pedido a partir da plataforma (como funcionam os planos, em inglês).
• Consumo adicional: efetuado através de créditos pré-pagos.

Estes valores correspondem aos dados publicados em os planos e os tokens, na FAQ para programadores (em inglês) em outubro de 2026. A disponibilização do plano Free permite testar um caderno de encargos real através do servidor MCP ou da app antes de escolher a porta definitiva para a sua equipa.

Qual é a porta certa para a sua equipa?

A escolha da interface ideal depende do perfil da sua operação:

• Escolha a app Claro se tem uma pessoa responsável por um caderno de encargos específico e precisa de levar uma shortlist a uma reunião esta semana.
• Escolha o servidor MCP se a sua equipa já utiliza o Claude ou o ChatGPT para elaborar relatórios e prefere receber as pesquisas estruturadas em texto corrente.
• Escolha a API REST se necessita de alimentar o CRM todas as noites, integrar a pesquisa na intranet ou preencher automaticamente os relatórios do comité.

As empresas em crescimento utilizam frequentemente mais do que uma porta na mesma conta. Regressando ao exemplo do grupo de restauração lisboeta: o gestor testa o caderno de encargos na app à segunda-feira, o analista elabora o relatório no Claude na quarta-feira e a equipa de TI agenda a atualização diária do CRM via API a partir dessa semana. Para começar a explorar as três portas, basta iniciar sessão em platform.casafari.com.

Perguntas frequentes

O Claro encontra lojas e escritórios em Portugal?

Não, o Claro não cobre o mercado português. O Claro é especializado na pesquisa de imóveis comerciais (lojas, restauração, escritórios e armazéns) para arrendamento ou venda em Espanha e na Alemanha, além de terrenos comerciais na Alemanha (dados de outubro de 2026). Para a prospeção de imóveis e análise de mercado em Portugal, a CASAFARI disponibiliza ferramentas dedicadas como o Area Insights, o Comparables e o Property Sourcing.

O que é um servidor MCP e preciso de saber programar para o usar?

O MCP (Model Context Protocol) é um padrão aberto que permite aos assistentes de IA acederem a dados externos em tempo real. Não é necessário saber programar para utilizar o servidor MCP do Claro: basta adicionar a hiperligação do servidor (https://platform.casafari.com/mcp/claro) como um conector no Claude ou ChatGPT e autenticar-se no navegador através de OAuth 2.1. A conta é criada automaticamente no plano Free no primeiro acesso, sem pedir cartão de crédito.

Quanto custa o Claro e o que são os tokens?

O consumo do Claro é faturado em tokens, contados da mesma forma na app, no servidor MCP e na API REST. O plano Free oferece 1.000 tokens durante 30 dias sem cartão de crédito; o plano Agent custa 49 € por mês na opção anual ou 70 € por mês na opção mensal (acrescido de IVA). A resolução de nomes de localizações (Location Lookup) consome 0 tokens (dados de outubro de 2026).

Posso enviar o caderno de encargos em PDF e obter a pesquisa feita?

Sim, a funcionalidade brief_from_file lê ficheiros PDF com cadernos de encargos e converte-os automaticamente numa pesquisa estruturada na app, no servidor MCP ou na API REST. O Claro indica a contagem exata de imóveis encontrados e analisa cada critério como cumprido, não cumprido ou omisso com base no texto dos anúncios. Após o processamento inicial, pode ajustar a pesquisa em linguagem natural com a instrução refine_search.

Como ligar o Claro ao CRM da minha empresa?

A ligação ao CRM é realizada através da API REST do Claro, que disponibiliza 12 operações programáveis faturadas em tokens. O departamento de informática pode configurar uma tarefa agendada diária que executa os cadernos de encargos guardados e envia as novas oportunidades imobiliárias diretamente para o CRM com a verificação de critérios incluída. A documentação técnica detalhada está disponível em developers.casafari.com/docs/claro.