Voor Ontwikkelaars

MCP Server Integratie

Verbind Claude en andere AI-assistenten met Fixatia's vastgoeddatabase via het Model Context Protocol

Wat is MCP?

Het Model Context Protocol (MCP) is een open standaard die AI-assistenten zoals Claude in staat stelt om veilig toegang te krijgen tot externe gegevensbronnen. Fixatia's MCP-server biedt realtime toegang tot onze Europese vastgoedveilingdatabase, waardoor AI-assistenten vastgoed kunnen doorzoeken, details kunnen ophalen en beschikbare filters kunnen ontdekken.

Zoek duizenden veilingvastgoeden in 6 Europese landen met geavanceerde filters

Krijg uitgebreide vastgoeddetails, inclusief renovatieschattingen, ROI-berekeningen en meertalige beschrijvingen

Ontdek beschikbare filteropties dynamisch om krachtige zoekopdrachten te bouwen

Leer meer over MCP

Snelle Start

1Server URL

De Fixatia MCP-server is beschikbaar op:

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

2Configureer Claude Desktop

Voeg het volgende toe aan je Claude Desktop-configuratiebestand:

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

3Begin met Gebruik

Herstart Claude Desktop en begin vragen te stellen over vastgoed. Claude zal automatisch de Fixatia-tools gebruiken om vastgoedinformatie te zoeken en op te halen.

Probeer te vragen: "Vind vastgoed in Portugal onder €150.000 met ten minste 20% ROI-potentieel"

Beschikbare Tools

De Fixatia MCP-server biedt drie krachtige tools voor interactie met onze vastgoeddatabase:

zoek_onroerendgoed

Zoek naar onroerendgoed veilingobjecten in heel Europa. Filter op land, stad, prijs, type onroerend goed, ROI-potentieel en meer. Geeft een lijst van overeenkomende objecten met belangrijke details, waaronder veilingprijzen, marktwaarden en investeringsmetrics.

Parameters

Parameter	Type	Required	Description
query	string	Optioneel	Tekstzoekopdracht voor onroerend goed titel, stad of regio
country	string	Optioneel	Landcode: es (Spanje), pt (Portugal), it (Italië), fr (Frankrijk), de (Duitsland), hr (Kroatië)
region	string	Optioneel	Regio naam binnen het land
city	string	Optioneel	Stad naam
propertyType	string	Optioneel	Type onroerend goed: APPARTEMENT, HUIS, VILLA, GROND of COMMERCIËEL
minPrice	number	Optioneel	Minimale veilingprijs in EUR
maxPrice	number	Optioneel	Maximale veilingprijs in EUR
minRoi	number	Optioneel	Minimaal ROI-percentage (bijv. 20 voor 20%)
bedrooms	number	Optioneel	Minimaal aantal slaapkamers
maxResults	number	Optioneel	Maximaal aantal resultaten om terug te geven (standaard: 10, max: 50)
sortBy	string	Optioneel	Sorteervolgorde: nieuwste, prijs-laag, prijs-hoog, roi-hoog of veiling-het-eerst
locale	string	Optioneel	Taal voor titels/beschrijvingen (standaard: en). Ondersteunt 18 talen.

Voorbeeldverzoek

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

Voorbeeldantwoord

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

haal_onroerendgoed_op

Krijg volledige details van een specifiek onroerend goed op basis van zijn ID. Geeft uitgebreide informatie, waaronder meertalige beschrijvingen, afbeeldingen, locatiecoördinaten, renovatieschattingen, veilingdetails en investeringsmetrics.

Parameters

Parameter	Type	Required	Description
id	string	Verplicht	De onroerend goed ID (verkregen uit zoekresultaten)
locale	string	Optioneel	Taal voor titel/beschrijving (standaard: en). Ondersteunt 18 talen.

Voorbeeldverzoek

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

haal_filteropties_op

Krijg beschikbare filteropties, inclusief lijsten van landen, regio's, steden, onroerend goed types en prijs/ROI-reeksen. Nuttig voor het begrijpen van welke zoekparameters beschikbaar zijn en het bouwen van dynamische filterinterfaces.

Deze tool vereist geen parameters.

Voorbeeldverzoek

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

Voorbeeldantwoord

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

Stuur een aanvraag over een onroerend goed om interesse te tonen. Deze tool vereist OAuth 2.1 authenticatie met PKCE.

Authenticatie vereist (OAuth 2.1)

Deze tool gebruikt OAuth 2.1 met PKCE voor veilige authenticatie. De stroom is:

Gebruiker klikt op 'Autoriseren' en logt in via browser
Autorisatiecode wordt ingewisseld voor toegangstoken (PKCE-beveiligd)
mcp.tools.sendPropertyInquiry.oauthStep3

Parameters

Parameter	Type	Required	Description
propertyId	string	Verplicht	De ID van het onroerend goed om naar te vragen
message	string	Verplicht	Uw aanvraagbericht, minimaal 10 tekens

Voorbeeldverzoek

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

Voorbeeldantwoord

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

HTTP API Referentie

De MCP-server biedt ook een directe HTTP API voor programmatic toegang. Alle verzoeken gebruiken het JSON-RPC 2.0-protocol.

Eindpunten

GET

/api/mcp

Gezondheidscontrole en serverinformatie. Geeft servernaam, versie, protocolversie en beschikbare tools.

POST

/api/mcp

JSON-RPC 2.0 verzoeken voor tooluitvoering. Ondersteunt initialiseren, tools/lijst, tools/aanroep en ping-methoden.

Ondersteunde Methoden

initialize - Initialiseer de MCP-sessie en verkrijg servercapaciteiten
tools/list - Lijst van alle beschikbare tools met hun schema's
tools/call - Voer een specifieke tool uit met argumenten
ping - Gezondheidscontrole ping

cURL Voorbeeld

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

Probeer het

Test de MCP-server rechtstreeks vanuit uw browser. Selecteer een tool en configureer de parameters.

Selecteer een tool

Foutafhandeling

De server retourneert standaard JSON-RPC 2.0 foutresponsen. Hier zijn de veelvoorkomende foutcodes:

Code	Message	Description
-32600	Ongeldig Verzoek	De verzonden JSON is geen geldig Verzoekobject
-32601	Methode niet gevonden	De aangevraagde methode bestaat niet of is niet beschikbaar
-32602	Ongeldige parameters	Ongeldige methodeparameter(s) - controleer vereiste velden en types
-32603	Interne fout	Interne JSON-RPC fout of serverzijde probleem

Voorbeeld Foutrespons

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

Ondersteunde Talen

Eigendomstitels en beschrijvingen zijn beschikbaar in 18 talen. Gebruik de locale-parameter om inhoud in uw voorkeurstaal te verkrijgen:

Engels (en), Duits (de), Frans (fr), Spaans (es), Italiaans (it), Portugees (pt), Nederlands (nl), Pools (pl), Grieks (el), Roemeens (ro), Tsjechisch (cs), Hongaars (hu), Chinees (zh), Arabisch (ar), Russisch (ru), Japans (ja), Koreaans (ko), Kroatisch (hr)

Machineleesbare Documentatie

Voor AI-assistenten en geautomatiseerde tools bieden we platte-tekstdocumentatiebestanden volgens de llms.txt-standaard:

llms.txt

Beknopte documentatie met server-URL, configuratie en tooloverzichten

llms-full.txt

Volledige documentatie met alle parameters, voorbeeldverzoeken/-antwoorden en foutcodes

Meer informatie over de llms.txt-standaard op llmstxt.org

Hulp Nodig?

Als u vragen heeft over de integratie met de Fixatia MCP-server of problemen ondervindt, staat ons ontwikkelaarsupportteam voor u klaar.

Neem Contact Op met Ontwikkelaarsupport Rapporteer een Probleem op GitHub