Fixatia
Fejlesztőknek

MCP Szerver Integráció

Csatlakoztassa Claude-ot és más AI asszisztenseket a Fixatia ingatlan adatbázisához a Model Context Protocol használatával

Mi az MCP?

A Model Context Protocol (MCP) egy nyílt szabvány, amely lehetővé teszi az AI asszisztensek, mint Claude, számára, hogy biztonságosan hozzáférjenek külső adatforrásokhoz. A Fixatia MCP szerver valós idejű hozzáférést biztosít európai ingatlanaukciós adatbázisunkhoz, lehetővé téve az AI asszisztensek számára, hogy ingatlanokat keressenek, részleteket kérjenek le és felfedezzék a rendelkezésre álló szűrőket.

Keresés ezer aukciós ingatlan között 6 európai országban fejlett szűrőkkel

Átfogó ingatlan részletek beszerzése, beleértve a felújítási becsléseket, ROI számításokat és többnyelvű leírásokat

Fedezze fel a dinamikusan elérhető szűrőopciókat, hogy erőteljes keresési lekérdezéseket építhessen

Tudj meg többet az MCP-ről

Gyors kezdés

1Szerver URL

A Fixatia MCP szerver elérhető itt:

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

2Claude Desktop konfigurálása

Add hozzá a következőket a Claude Desktop konfigurációs fájlhoz:

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

3Használat megkezdése

Indítsd újra a Claude Desktopot, és kezdj el érdeklődni az ingatlanokról. Claude automatikusan használni fogja a Fixatia eszközöket az ingatlaninformációk keresésére és lekérésére.

Próbáld meg kérdezni: "Keress nekem ingatlanokat Portugáliában 150,000 € alatt, legalább 20% ROI potenciállal"

Elérhető eszközök

A Fixatia MCP szerver három erőteljes eszközt biztosít az ingatlan adatbázisunkkal való interakcióhoz:

keresés_ingatlanok

Keresés ingatlan árverési ingatlanok után Európában. Szűrj ország, város, ár, ingatlantípus, ROI potenciál és egyebek szerint. Visszaad egy listát a megfelelő ingatlanokról kulcsfontosságú részletekkel, beleértve az árverési árakat, piaci értékeket és befektetési mutatókat.

Paraméterek

ParameterTypeRequiredDescription
querystringOpcionálisSzöveges keresés ingatlan címére, városára vagy régiójára
countrystringOpcionálisOrszágkód: es (Spanyolország), pt (Portugália), it (Olaszország), fr (Franciaország), de (Németország), hr (Horvátország)
regionstringOpcionálisRégió neve az országon belül
citystringOpcionálisVáros neve
propertyTypestringOpcionálisIngatlantípus: LAKÁS, HÁZ, VILLA, TELEK vagy KERESKEDELMI
minPricenumberOpcionálisMinimum árverési ár EUR-ban
maxPricenumberOpcionálisMaximum árverési ár EUR-ban
minRoinumberOpcionálisMinimum ROI százalék (pl. 20 a 20%-hoz)
bedroomsnumberOpcionálisMinimum hálószobák száma
maxResultsnumberOpcionálisMaximum számú eredmény visszaadása (alapértelmezett: 10, maximum: 50)
sortBystringOpcionálisRendezési sorrend: legújabb, ár-alacsony, ár-magas, ROI-magas, vagy aukció-legkorábban
localestringOpcionálisNyelv a címekhez/leírásokhoz (alapértelmezett: en). 18 nyelvet támogat.

Példa kérés

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

Példa válasz

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

ingatlan_lekérdezés

Teljes részletek lekérése egy adott ingatlanról az ID-ja alapján. Átfogó információkat ad vissza, beleértve a többnyelvű leírásokat, képeket, helyszín koordinátákat, felújítási becsléseket, aukciós részleteket és befektetési mutatókat.

Paraméterek

ParameterTypeRequiredDescription
idstringKötelezőAz ingatlan ID (a keresési eredményekből származik)
localestringOpcionálisNyelv a címhez/leíráshoz (alapértelmezett: en). 18 nyelvet támogat.

Példa kérés

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

szűrő_opciók_lekérdezése

Elérhető szűrőopciók lekérése, beleértve az országok, régiók, városok, ingatlantípusok és ár/ROI tartományok listáját. Hasznos a keresési paraméterek megértéséhez és dinamikus szűrőfelületek létrehozásához.

Ez az eszköz nem igényel paramétereket.

Példa kérés

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

Példa válasz

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

Küldjön érdeklődést egy ingatlanról az érdeklődés kifejezéséhez. Ez az eszköz OAuth 2.1 hitelesítést igényel PKCE-vel.

Hitelesítés szükséges (OAuth 2.1)

Ez az eszköz OAuth 2.1-et használ PKCE-vel a biztonságos hitelesítéshez. A folyamat:

  • A felhasználó rákattint az 'Engedélyezés' gombra és bejelentkezik a böngészőben
  • Az engedélyezési kód hozzáférési tokenre cserélődik (PKCE-védett)
  • mcp.tools.sendPropertyInquiry.oauthStep3

Paraméterek

ParameterTypeRequiredDescription
propertyIdstringKötelezőAz ingatlan azonosítója az érdeklődéshez
messagestringKötelezőAz Ön érdeklődő üzenete, minimum 10 karakter

Példa kérés

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

Példa válasz

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

Az MCP szerver közvetlen HTTP API-t is biztosít programozott hozzáféréshez. Minden kérés JSON-RPC 2.0 protokollt használ.

Végpontok

GET
/api/mcp

Egészségügyi ellenőrzés és szerverinformáció. Visszaadja a szerver nevét, verzióját, protokoll verzióját és elérhető eszközöket.

POST
/api/mcp

JSON-RPC 2.0 kérések az eszköz végrehajtásához. Támogatja az inicializálás, eszközök/lista, eszközök/hívás és ping módszereket.

Támogatott Módszerek

  • initialize - Inicializálja az MCP munkamenetet és lekéri a szerver képességeit
  • tools/list - Listázza az összes elérhető eszközt a sémaikkal
  • tools/call - Végezzen el egy adott eszközt argumentumokkal
  • ping - Egészségügyi ellenőrzés ping

cURL Példa

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

Próbálja ki

Tesztelje az MCP szervert közvetlenül a böngészőjéből. Válasszon egy eszközt és konfigurálja a paramétereket.

Válasszon eszközt

Hiba Kezelés

A szerver standard JSON-RPC 2.0 hiba válaszokat ad vissza. Íme a gyakori hiba kódok:

CodeMessageDescription
-32600Érvénytelen KérésA küldött JSON nem érvényes Kérés objektum
-32601A módszer nem találhatóA kért módszer nem létezik vagy nem elérhető
-32602Érvénytelen paraméterekÉrvénytelen módszerparaméter(ek) - ellenőrizze a kötelező mezőket és típusokat
-32603Belső hibaBelső JSON-RPC hiba vagy szerveroldali probléma

Példa Hiba Válasz

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

Támogatott Nyelvek

A tulajdoni címek és leírások 18 nyelven érhetők el. Használja a locale paramétert, hogy a kívánt nyelven kapjon tartalmat:

Angol (en), Német (de), Francia (fr), Spanyol (es), Olasz (it), Portugál (pt), Holland (nl), Lengyel (pl), Görög (el), Román (ro), Cseh (cs), Magyar (hu), Kínai (zh), Arab (ar), Orosz (ru), Japán (ja), Koreai (ko), Horvát (hr)

Géppel olvasható dokumentáció

AI asszisztensek és automatizált eszközök számára sima szöveges dokumentációs fájlokat biztosítunk az llms.txt szabvány szerint:

llms.txt

Tömör dokumentáció a szerver URL-jével, konfigurációval és eszköz-összefoglalókkal

llms-full.txt

Teljes dokumentáció az összes paraméterrel, példa kérésekkel/válaszokkal és hibakódokkal

Tudjon meg többet az llms.txt szabványról itt: llmstxt.org

Szüksége van segítségre?

Ha kérdése van a Fixatia MCP szerver integrálásával kapcsolatban, vagy bármilyen problémát tapasztal, fejlesztői támogatói csapatunk itt van, hogy segítsen.

Kapcsolatfelvétel a Fejlesztői TámogatássalJelentse a problémát a GitHub-on