Fixatia
Per Sviluppatori

Integrazione Server MCP

Collega Claude e altri assistenti AI al database immobiliare di Fixatia utilizzando il Protocollo di Contesto del Modello

Cos'è il MCP?

Il Protocollo di Contesto del Modello (MCP) è uno standard aperto che consente agli assistenti AI come Claude di accedere in modo sicuro a fonti di dati esterne. Il server MCP di Fixatia fornisce accesso in tempo reale al nostro database delle aste immobiliari europee, consentendo agli assistenti AI di cercare proprietà, recuperare dettagli e scoprire filtri disponibili.

Cerca migliaia di proprietà all'asta in 6 paesi europei con filtri avanzati

Ottieni dettagli completi sulla proprietà, inclusi stime di ristrutturazione, calcoli del ROI e descrizioni multilingue

Scopri le opzioni di filtro disponibili in modo dinamico per costruire query di ricerca potenti

Scopri di più su MCP

Avvio Rapido

1URL del Server

Il server Fixatia MCP è disponibile su:

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

2Configura Claude Desktop

Aggiungi quanto segue al tuo file di configurazione di 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"
    }
  }
}

3Inizia a Usare

Riavvia Claude Desktop e inizia a chiedere informazioni sulle proprietà. Claude utilizzerà automaticamente gli strumenti Fixatia per cercare e recuperare informazioni sulle proprietà.

Prova a chiedere: "Trova proprietà in Portogallo sotto €150.000 con almeno il 20% di potenziale ROI"

Strumenti Disponibili

Il server Fixatia MCP fornisce tre potenti strumenti per interagire con il nostro database di proprietà:

cerca_proprietà

Cerca proprietà all'asta immobiliari in tutta Europa. Filtra per paese, città, prezzo, tipo di proprietà, potenziale ROI e altro. Restituisce un elenco di proprietà corrispondenti con dettagli chiave, inclusi prezzi d'asta, valori di mercato e metriche di investimento.

Parametri

ParameterTypeRequiredDescription
querystringFacoltativoRicerca testuale per titolo della proprietà, città o regione
countrystringFacoltativoCodice paese: es (Spagna), pt (Portogallo), it (Italia), fr (Francia), de (Germania), hr (Croazia)
regionstringFacoltativoNome della regione all'interno del paese
citystringFacoltativoNome della città
propertyTypestringFacoltativoTipo di proprietà: APPARTAMENTO, CASA, VILLA, TERRENO o COMMERCIALE
minPricenumberFacoltativoPrezzo d'asta minimo in EUR
maxPricenumberFacoltativoPrezzo d'asta massimo in EUR
minRoinumberFacoltativoPercentuale ROI minima (es. 20 per 20%)
bedroomsnumberFacoltativoNumero minimo di camere da letto
maxResultsnumberFacoltativoNumero massimo di risultati da restituire (predefinito: 10, massimo: 50)
sortBystringFacoltativoOrdine di ordinamento: più recente, prezzo-basso, prezzo-alto, roi-alto, o asta-presto
localestringFacoltativoLingua per titoli/descrizioni (predefinito: en). Supporta 18 lingue.

Richiesta Esempio

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

Risposta Esempio

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

ottieni_proprietà

Ottieni dettagli completi di una specifica proprietà tramite il suo ID. Restituisce informazioni complete, comprese descrizioni multilingue, immagini, coordinate di posizione, stime di ristrutturazione, dettagli dell'asta e metriche di investimento.

Parametri

ParameterTypeRequiredDescription
idstringObbligatorioL'ID della proprietà (ottenuto dai risultati di ricerca)
localestringFacoltativoLingua per titolo/descrizione (predefinito: en). Supporta 18 lingue.

Richiesta Esempio

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

ottieni_opzioni_filtro

Ottieni le opzioni di filtro disponibili, comprese le liste di paesi, regioni, città, tipi di proprietà e fasce di prezzo/ROI. Utile per comprendere quali parametri di ricerca sono disponibili e costruire interfacce di filtro dinamiche.

Questo strumento non richiede parametri.

Richiesta Esempio

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

Risposta Esempio

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

Invia una richiesta riguardo una proprietà per esprimere interesse. Questo strumento richiede autenticazione OAuth 2.1 con PKCE.

Autenticazione richiesta (OAuth 2.1)

Questo strumento usa OAuth 2.1 con PKCE per autenticazione sicura. Il flusso è:

  • L'utente clicca 'Autorizza' e accede tramite browser
  • Il codice di autorizzazione viene scambiato con token di accesso (protetto da PKCE)
  • mcp.tools.sendPropertyInquiry.oauthStep3

Parametri

ParameterTypeRequiredDescription
propertyIdstringObbligatorioL'ID della proprietà per cui fare richiesta
messagestringObbligatorioIl tuo messaggio di richiesta, minimo 10 caratteri

Richiesta Esempio

// 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
}

Risposta Esempio

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

Riferimento API HTTP

Il server MCP espone anche un'API HTTP diretta per accesso programmatico. Tutte le richieste utilizzano il protocollo JSON-RPC 2.0.

Endpoint

GET
/api/mcp

Controllo dello stato e informazioni sul server. Restituisce nome del server, versione, versione del protocollo e strumenti disponibili.

POST
/api/mcp

Richieste JSON-RPC 2.0 per l'esecuzione degli strumenti. Supporta metodi initialize, tools/list, tools/call e ping.

Metodi Supportati

  • initialize - Inizializza la sessione MCP e ottieni le capacità del server
  • tools/list - Elenca tutti gli strumenti disponibili con i loro schemi
  • tools/call - Esegui uno specifico strumento con argomenti
  • ping - Ping di controllo dello stato

Esempio 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
  }'

Provalo

Testa il server MCP direttamente dal tuo browser. Seleziona uno strumento e configura i parametri.

Seleziona uno strumento

Gestione degli Errori

Il server restituisce risposte di errore standard JSON-RPC 2.0. Ecco i codici di errore comuni:

CodeMessageDescription
-32600Richiesta non validaIl JSON inviato non è un oggetto Richiesta valido
-32601Metodo non trovatoIl metodo richiesto non esiste o non è disponibile
-32602Parametri non validiParametri del metodo non validi - controlla i campi e i tipi richiesti
-32603Errore internoErrore JSON-RPC interno o problema lato server

Esempio di risposta errore

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

Lingue supportate

I titoli e le descrizioni delle proprietà sono disponibili in 18 lingue. Usa il parametro locale per ottenere contenuti nella tua lingua preferita:

Inglese (en), Tedesco (de), Francese (fr), Spagnolo (es), Italiano (it), Portoghese (pt), Olandese (nl), Polacco (pl), Greco (el), Rumeno (ro), Ceco (cs), Ungherese (hu), Cinese (zh), Arabo (ar), Russo (ru), Giapponese (ja), Coreano (ko), Croato (hr)

Documentazione leggibile dalle macchine

Per assistenti IA e strumenti automatizzati, forniamo file di documentazione in testo semplice seguendo lo standard llms.txt:

llms.txt

Documentazione concisa con URL del server, configurazione e riassunti degli strumenti

llms-full.txt

Documentazione completa con tutti i parametri, esempi di richieste/risposte e codici di errore

Scopri di più sullo standard llms.txt su llmstxt.org

Hai bisogno di aiuto?

Se hai domande sull'integrazione con il server Fixatia MCP o incontri problemi, il nostro team di supporto per sviluppatori è qui per aiutarti.

Contatta il supporto per sviluppatoriSegnala un problema su GitHub