Fixatia
Para Desenvolvedores

Integração do Servidor MCP

Conecte Claude e outros assistentes de IA à base de dados de propriedades da Fixatia usando o Protocolo de Contexto de Modelo

O que é MCP?

O Protocolo de Contexto de Modelo (MCP) é um padrão aberto que permite que assistentes de IA como Claude acessem fontes de dados externas de forma segura. O servidor MCP da Fixatia fornece acesso em tempo real à nossa base de dados de leilão de propriedades europeias, permitindo que assistentes de IA pesquisem propriedades, recuperem detalhes e descubram filtros disponíveis.

Pesquise milhares de propriedades em leilão em 6 países europeus com filtros avançados

Obtenha detalhes abrangentes sobre propriedades, incluindo estimativas de renovação, cálculos de ROI e descrições multilíngues

Descubra opções de filtro disponíveis dinamicamente para construir consultas de pesquisa poderosas

Saiba mais sobre MCP

Início Rápido

1URL do Servidor

O servidor MCP da Fixatia está disponível em:

https://mcp.fixatia.com/api/mcp

2Configurar o Claude Desktop

Adicione o seguinte ao seu arquivo de configuração do Claude Desktop:

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fixatia": {
      "url": "https://mcp.fixatia.com/api/mcp"
    }
  }
}

3Comece a Usar

Reinicie o Claude Desktop e comece a perguntar sobre propriedades. Claude usará automaticamente as ferramentas da Fixatia para pesquisar e recuperar informações sobre propriedades.

Tente perguntar: "Encontre propriedades em Portugal abaixo de €150.000 com pelo menos 20% de potencial de ROI"

Ferramentas Disponíveis

O servidor Fixatia MCP fornece três ferramentas poderosas para interagir com nosso banco de dados de propriedades:

pesquisar_propriedades

Pesquise por propriedades de leilão imobiliário em toda a Europa. Filtre por país, cidade, preço, tipo de propriedade, potencial de ROI e mais. Retorna uma lista de propriedades correspondentes com detalhes chave, incluindo preços de leilão, valores de mercado e métricas de investimento.

Parâmetros

ParameterTypeRequiredDescription
querystringOpcionalPesquisa de texto para título da propriedade, cidade ou região
countrystringOpcionalCódigo do país: es (Espanha), pt (Portugal), it (Itália), fr (França), de (Alemanha), hr (Croácia)
regionstringOpcionalNome da região dentro do país
citystringOpcionalNome da cidade
propertyTypestringOpcionalTipo de propriedade: APARTAMENTO, CASA, VILA, TERRENO ou COMERCIAL
minPricenumberOpcionalPreço mínimo de leilão em EUR
maxPricenumberOpcionalPreço máximo de leilão em EUR
minRoinumberOpcionalPorcentagem mínima de ROI (por exemplo, 20 para 20%)
bedroomsnumberOpcionalNúmero mínimo de quartos
maxResultsnumberOpcionalNúmero máximo de resultados a retornar (padrão: 10, máximo: 50)
sortBystringOpcionalOrdem de classificação: mais recente, preço-baixo, preço-alto, roi-alto ou leilão-em-breve
localestringOpcionalIdioma para títulos/descrições (padrão: en). Suporta 18 idiomas.

Exemplo de Solicitação

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_properties",
    "arguments": {
      "country": "pt",
      "maxPrice": 150000,
      "minRoi": 20,
      "maxResults": 5
    }
  },
  "id": 1
}

Exemplo de Resposta

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "text",
      "text": {
        "totalCount": 12,
        "results": [
          {
            "id": "b45dc4fc14134da69e9f800f8",
            "title": "2-Bedroom Apartment · Lisbon",
            "country": "pt",
            "city": "Lisboa",
            "propertyType": "APARTMENT",
            "auctionPrice": 120000,
            "marketValue": 165000,
            "potentialRoi": 26.5,
            "bedrooms": 2,
            "squareMeters": 75
          }
        ]
      }
    }]
  }
}

obter_propriedade

Obtenha detalhes completos de uma propriedade específica pelo seu ID. Retorna informações abrangentes, incluindo descrições multilíngues, imagens, coordenadas de localização, estimativas de renovação, detalhes de leilão e métricas de investimento.

Parâmetros

ParameterTypeRequiredDescription
idstringObrigatórioO ID da propriedade (obtido dos resultados da pesquisa)
localestringOpcionalIdioma para título/descrição (padrão: en). Suporta 18 idiomas.

Exemplo de Solicitação

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_property",
    "arguments": {
      "id": "b45dc4fc14134da69e9f800f8",
      "locale": "en"
    }
  },
  "id": 2
}

obter_opções_de_filtro

Obtenha opções de filtro disponíveis, incluindo lista de países, regiões, cidades, tipos de propriedade e faixas de preço/ROI. Útil para entender quais parâmetros de pesquisa estão disponíveis e construir interfaces de filtro dinâmicas.

Esta ferramenta não aceita parâmetros.

Exemplo de Solicitação

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_filter_options",
    "arguments": {}
  },
  "id": 3
}

Exemplo de Resposta

{
  "countries": [
    { "code": "pt", "name": "Portugal", "propertyCount": 45 },
    { "code": "es", "name": "Spain", "propertyCount": 120 },
    { "code": "it", "name": "Italy", "propertyCount": 89 }
  ],
  "propertyTypes": [
    { "type": "APARTMENT", "count": 156 },
    { "type": "HOUSE", "count": 78 }
  ],
  "priceRange": { "min": 5000, "max": 800000 },
  "roiRange": { "min": -5, "max": 45 }
}

send_property_inquiry

OAuth 2.1

Envie uma consulta sobre uma propriedade para expressar interesse. Esta ferramenta requer autenticação OAuth 2.1 com PKCE.

Autenticação necessária (OAuth 2.1)

Esta ferramenta usa OAuth 2.1 com PKCE para autenticação segura. O fluxo é:

  • O utilizador clica em 'Autorizar' e faz login através do navegador
  • O código de autorização é trocado por token de acesso (protegido por PKCE)
  • mcp.tools.sendPropertyInquiry.oauthStep3

Parâmetros

ParameterTypeRequiredDescription
propertyIdstringObrigatórioO ID da propriedade a consultar
messagestringObrigatórioA sua mensagem de consulta, mínimo 10 caracteres

Exemplo de Solicitação

// Requires Bearer token authentication
// curl -X POST https://mcp.fixatia.com/api/mcp \
//   -H "Authorization: Bearer YOUR_TOKEN" \
//   -H "Content-Type: application/json" \
//   -d '...'

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "send_property_inquiry",
    "arguments": {
      "propertyId": "b45dc4fc14134da69e9f800f8",
      "message": "I'm interested in this property. Is it still available?"
    }
  },
  "id": 4
}

Exemplo de Resposta

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "content": [{
      "type": "text",
      "text": "Inquiry sent successfully! The property owner will be notified and may contact you."
    }]
  }
}

Referência da API HTTP

O servidor MCP também expõe uma API HTTP direta para acesso programático. Todas as solicitações usam o protocolo JSON-RPC 2.0.

Endpoints

GET
/api/mcp

Verificação de saúde e informações do servidor. Retorna nome do servidor, versão, versão do protocolo e ferramentas disponíveis.

POST
/api/mcp

Solicitações JSON-RPC 2.0 para execução de ferramentas. Suporta métodos de inicialização, ferramentas/lista, ferramentas/chamada e ping.

Métodos Suportados

  • initialize - Inicializar a sessão MCP e obter capacidades do servidor
  • tools/list - Listar todas as ferramentas disponíveis com seus esquemas
  • tools/call - Executar uma ferramenta específica com argumentos
  • ping - Ping de verificação de saúde

Exemplo de cURL

curl -X POST https://mcp.fixatia.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "search_properties",
      "arguments": {
        "country": "pt",
        "maxPrice": 150000
      }
    },
    "id": 1
  }'

Experimente

Teste o servidor MCP diretamente do seu navegador. Selecione uma ferramenta e configure os parâmetros.

Selecione uma ferramenta

Tratamento de Erros

O servidor retorna respostas de erro padrão JSON-RPC 2.0. Aqui estão os códigos de erro comuns:

CodeMessageDescription
-32600Solicitação InválidaO JSON enviado não é um objeto de Solicitação válido
-32601Método não encontradoO método solicitado não existe ou não está disponível
-32602Parâmetros inválidosParâmetro(s) de método inválido(s) - verifique os campos e tipos obrigatórios
-32603Erro internoErro interno do JSON-RPC ou problema do lado do servidor

Exemplo de Resposta de Erro

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params: Property ID is required"
  }
}

Idiomas Suportados

Os títulos e descrições das propriedades estão disponíveis em 18 idiomas. Use o parâmetro locale para obter conteúdo no seu idioma preferido:

Inglês (en), Alemão (de), Francês (fr), Espanhol (es), Italiano (it), Português (pt), Holandês (nl), Polonês (pl), Grego (el), Romeno (ro), Tcheco (cs), Húngaro (hu), Chinês (zh), Árabe (ar), Russo (ru), Japonês (ja), Coreano (ko), Croata (hr)

Documentação Legível por Máquina

Para assistentes de IA e ferramentas automatizadas, fornecemos arquivos de documentação em texto simples seguindo o padrão llms.txt:

llms.txt

Documentação concisa com URL do servidor, configuração e resumos das ferramentas

llms-full.txt

Documentação completa incluindo todos os parâmetros, exemplos de requisições/respostas e códigos de erro

Saiba mais sobre o padrão llms.txt em llmstxt.org

Precisa de Ajuda?

Se você tiver perguntas sobre a integração com o servidor Fixatia MCP ou encontrar qualquer problema, nossa equipe de suporte para desenvolvedores está aqui para ajudar.

Contatar Suporte ao DesenvolvedorRelatar um Problema no GitHub