Fixatia
Za programere

MCP Server Integracija

Povežite Claudea i druge AI asistente s Fixatia bazom podataka o nekretninama koristeći Model Context Protocol

Što je MCP?

Model Context Protocol (MCP) je otvoreni standard koji omogućava AI asistentima poput Claudea da sigurno pristupaju vanjskim izvorima podataka. Fixatia MCP poslužitelj omogućava pristup našoj bazi podataka o europskim aukcijama nekretnina u stvarnom vremenu, omogućujući AI asistentima da pretražuju nekretnine, dobiju detalje i otkriju dostupne filtre.

Pretražujte tisuće aukcijskih nekretnina u 6 europskih zemalja s naprednim filtrima

Dobijte sveobuhvatne detalje o nekretninama uključujući procjene renovacija, proračune ROI-a i višelingvalne opise

Otkrijte dostupne opcije filtriranja dinamički kako biste izgradili moćne upite za pretraživanje

Saznajte više o MCP-u

Brzi početak

1URL poslužitelja

Fixatia MCP poslužitelj dostupan je na:

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

2Konfigurirajte Claude Desktop

Dodajte sljedeće u konfiguracijsku datoteku Claude Desktop-a:

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

3Počnite koristiti

Ponovno pokrenite Claude Desktop i počnite pitati o nekretninama. Claude će automatski koristiti Fixatia alate za pretraživanje i dobivanje informacija o nekretninama.

Pokušajte pitati: "Pronađi mi nekretnine u Portugalu ispod 150.000 € s potencijalom ROI-a od najmanje 20%"

Dostupni alati

Fixatia MCP poslužitelj pruža tri moćna alata za interakciju s našom bazom podataka o nekretninama:

pretraži_nekretnine

Pretražujte aukcijske nekretnine širom Europe. Filtrirajte prema zemlji, gradu, cijeni, vrsti nekretnine, potencijalu ROI-a i još mnogo toga. Vraća popis odgovarajućih nekretnina s ključnim detaljima uključujući aukcijske cijene, tržišne vrijednosti i investicijske metrike.

Parametri

ParameterTypeRequiredDescription
querystringOpcionalnoTekstualno pretraživanje naslova nekretnine, grada ili regije
countrystringOpcionalnoKod zemlje: es (Španija), pt (Portugal), it (Italija), fr (Francuska), de (Njemačka), hr (Hrvatska)
regionstringOpcionalnoIme regije unutar zemlje
citystringOpcionalnoIme grada
propertyTypestringOpcionalnoVrsta nekretnine: STAN, KUĆA, VILA, ZEMLJIŠTE ili KOMERCIJALNO
minPricenumberOpcionalnoMinimalna aukcijska cijena u EUR
maxPricenumberOpcionalnoMaksimalna cijena na aukciji u EUR
minRoinumberOpcionalnoMinimalni postotak ROI (npr., 20 za 20%)
bedroomsnumberOpcionalnoMinimalni broj spavaćih soba
maxResultsnumberOpcionalnoMaksimalni broj rezultata za prikaz (zadano: 10, max: 50)
sortBystringOpcionalnoRedoslijed sortiranja: najnovije, cijena-najniža, cijena-najviša, roi-najviši ili aukcija-najbliža
localestringOpcionalnoJezik za naslove/opise (zadano: en). Podržava 18 jezika.

Primjer zahtjeva

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

Primjer odgovora

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

dohvati_nekretninu

Dohvati potpune detalje o specifičnoj nekretnini prema njenom ID-u. Vraća sveobuhvatne informacije uključujući višejezične opise, slike, koordinate lokacije, procjene renovacije, detalje aukcije i investicijske metrike.

Parametri

ParameterTypeRequiredDescription
idstringObaveznoID nekretnine (dobiven iz rezultata pretraživanja)
localestringOpcionalnoJezik za naslov/opis (zadano: en). Podržava 18 jezika.

Primjer zahtjeva

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

dohvati_mogućnosti_filtra

Dohvati dostupne opcije filtra uključujući popis zemalja, regija, gradova, tipova nekretnina i raspona cijena/ROI. Korisno za razumijevanje dostupnih parametara pretraživanja i izgradnju dinamičkih sučelja za filtriranje.

Ovaj alat ne zahtijeva parametre.

Primjer zahtjeva

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

Primjer odgovora

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

Pošaljite upit o nekretnini kako biste izrazili interes. Ovaj alat zahtijeva OAuth 2.1 autentifikaciju s PKCE.

Potrebna autentifikacija (OAuth 2.1)

Ovaj alat koristi OAuth 2.1 s PKCE za sigurnu autentifikaciju. Postupak je:

  • Korisnik klikne 'Autoriziraj' i prijavi se putem preglednika
  • Autorizacijski kod se zamjenjuje za pristupni token (PKCE-zaštićeno)
  • mcp.tools.sendPropertyInquiry.oauthStep3

Parametri

ParameterTypeRequiredDescription
propertyIdstringObaveznoID nekretnine o kojoj se raspitujete
messagestringObaveznoVaša poruka upita, minimalno 10 znakova

Primjer zahtjeva

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

Primjer odgovora

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

MCP server također nudi izravni HTTP API za programski pristup. Svi zahtjevi koriste JSON-RPC 2.0 protokol.

Endpointi

GET
/api/mcp

Provjera zdravlja i informacije o serveru. Vraća naziv servera, verziju, verziju protokola i dostupne alate.

POST
/api/mcp

JSON-RPC 2.0 zahtjevi za izvršavanje alata. Podržava metode initialize, tools/list, tools/call i ping.

Podržane metode

  • initialize - Inicijalizirajte MCP sesiju i dobijte mogućnosti servera
  • tools/list - Popis svih dostupnih alata s njihovim shemama
  • tools/call - Izvršite specifičan alat s argumentima
  • ping - Provjera zdravlja ping

cURL primjer

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

Isprobajte

Testirajte MCP poslužitelj direktno iz preglednika. Odaberite alat i konfigurirajte parametre.

Odaberite alat

Upravljanje pogreškama

Server vraća standardne JSON-RPC 2.0 odgovore na pogreške. Evo uobičajenih kodova pogrešaka:

CodeMessageDescription
-32600Nevažeći zahtjevPoslani JSON nije valjani objekt zahtjeva
-32601Metoda nije pronađenaZatražena metoda ne postoji ili nije dostupna
-32602Nevažeći parametriNevažeći parametar(i) metode - provjerite obavezna polja i tipove
-32603Interna greškaInterna JSON-RPC greška ili problem na strani poslužitelja

Primjer odgovora na grešku

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

Podržani jezici

Naslovi i opisi nekretnina dostupni su na 18 jezika. Koristite parametar locale za dobivanje sadržaja na vašem preferiranom jeziku:

Engleski (en), Njemački (de), Francuski (fr), Španjolski (es), Talijanski (it), Portugalski (pt), Nizozemski (nl), Poljski (pl), Grčki (el), Rumunjski (ro), Češki (cs), Mađarski (hu), Kineski (zh), Arapski (ar), Ruski (ru), Japanski (ja), Korejski (ko), Hrvatski (hr)

Strojno čitljiva dokumentacija

Za AI asistente i automatizirane alate pružamo tekstualne dokumentacijske datoteke prema llms.txt standardu:

llms.txt

Sažeta dokumentacija s URL-om poslužitelja, konfiguracijom i sažetcima alata

llms-full.txt

Potpuna dokumentacija uključujući sve parametre, primjere zahtjeva/odgovora i kodove grešaka

Saznajte više o llms.txt standardu na llmstxt.org

Trebate pomoć?

Ako imate pitanja o integraciji s Fixatia MCP poslužiteljem ili naiđete na bilo kakve probleme, naš tim za podršku programerima je ovdje da pomogne.

Kontaktirajte podršku za programerePrijavite problem na GitHubu