Fixatia
Pentru Dezvoltatori

Integrarea Server MCP

Conectați Claude și alți asistenți AI la baza de date a imobilelor Fixatia folosind Protocolul Model Context

Ce este MCP?

Protocolul Model Context (MCP) este un standard deschis care permite asistenților AI precum Claude să acceseze în siguranță surse externe de date. Serverul MCP al Fixatia oferă acces în timp real la baza noastră de date a licitațiilor imobiliare europene, permițând asistenților AI să caute proprietăți, să recupereze detalii și să descopere filtre disponibile.

Căutați mii de proprietăți licitate în 6 țări europene cu filtre avansate

Obțineți detalii complete despre proprietăți, inclusiv estimări de renovare, calcule ROI și descrieri în mai multe limbi

Descoperiți opțiunile de filtrare disponibile dinamic pentru a construi interogări de căutare puternice

Aflați mai multe despre MCP

Începere rapidă

1URL-ul serverului

Serverul Fixatia MCP este disponibil la:

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

2Configurați Claude Desktop

Adăugați următoarele în fișierul de configurare 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"
    }
  }
}

3Începeți să folosiți

Reporniti Claude Desktop și începeți să întrebați despre proprietăți. Claude va folosi automat instrumentele Fixatia pentru a căuta și a obține informații despre proprietăți.

Încercați să întrebați: "Găsește-mi proprietăți în Portugalia sub 150.000 € cu un potențial ROI de cel puțin 20%"

Instrumente disponibile

Serverul Fixatia MCP oferă trei instrumente puternice pentru interacțiunea cu baza noastră de date despre proprietăți:

caută_proprietăți

Căutați proprietăți la licitație în întreaga Europă. Filtrați după țară, oraș, preț, tip de proprietate, potențial ROI și altele. Returnează o listă de proprietăți corespunzătoare cu detalii cheie, inclusiv prețuri de licitație, valori de piață și metrici de investiție.

Parametri

ParameterTypeRequiredDescription
querystringOpționalCăutare text pentru titlul proprietății, oraș sau regiune
countrystringOpționalCodul țării: es (Spania), pt (Portugalia), it (Italia), fr (Franța), de (Germania), hr (Croația)
regionstringOpționalNumele regiunii din cadrul țării
citystringOpționalNumele orașului
propertyTypestringOpționalTipul de proprietate: APARTAMENT, CASĂ, VILĂ, Teren sau COMERCIAL
minPricenumberOpționalPrețul minim de licitație în EUR
maxPricenumberOpționalPrețul maxim de licitație în EUR
minRoinumberOpționalProcentajul minim ROI (de exemplu, 20 pentru 20%)
bedroomsnumberOpționalNumărul minim de dormitoare
maxResultsnumberOpționalNumărul maxim de rezultate de returnat (implicit: 10, maxim: 50)
sortBystringOpționalOrdinea de sortare: cele mai noi, preț-mic, preț-mare, roi-mare, sau licitație-următoare
localestringOpționalLimba pentru titluri/descrieri (implicit: en). Suportă 18 limbi.

Cerere exemplu

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

Răspuns exemplu

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

get_property

Obține detalii complete ale unei proprietăți specifice după ID-ul său. Returnează informații cuprinzătoare, inclusiv descrieri multilingve, imagini, coordonate de locație, estimări de renovare, detalii despre licitație și metrici de investiție.

Parametri

ParameterTypeRequiredDescription
idstringNecesarID-ul proprietății (obținut din rezultatele căutării)
localestringOpționalLimba pentru titlu/descriere (implicit: en). Suportă 18 limbi.

Cerere exemplu

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

get_filter_options

Obține opțiunile de filtrare disponibile, inclusiv lista țărilor, regiunilor, orașelor, tipurilor de proprietăți și intervalelor de preț/ROI. Util pentru a înțelege ce parametri de căutare sunt disponibili și pentru a construi interfețe dinamice de filtrare.

Acest instrument nu necesită parametri.

Cerere exemplu

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

Răspuns exemplu

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

Trimite o cerere despre o proprietate pentru a-ți exprima interesul. Acest instrument necesită autentificare OAuth 2.1 cu PKCE.

Autentificare necesară (OAuth 2.1)

Acest instrument folosește OAuth 2.1 cu PKCE pentru autentificare sigură. Fluxul este:

  • Utilizatorul face clic pe 'Autorizare' și se conectează prin browser
  • Codul de autorizare este schimbat pentru token de acces (protejat PKCE)
  • mcp.tools.sendPropertyInquiry.oauthStep3

Parametri

ParameterTypeRequiredDescription
propertyIdstringNecesarID-ul proprietății despre care întrebi
messagestringNecesarMesajul tău de cerere, minimum 10 caractere

Cerere exemplu

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

Răspuns exemplu

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

Referință API HTTP

Serverul MCP expune de asemenea un API HTTP direct pentru acces programatic. Toate cererile folosesc protocolul JSON-RPC 2.0.

Endpoint-uri

GET
/api/mcp

Verificare a stării și informații despre server. Returnează numele serverului, versiunea, versiunea protocolului și instrumentele disponibile.

POST
/api/mcp

Cereri JSON-RPC 2.0 pentru execuția instrumentelor. Suportă metodele initialize, tools/list, tools/call și ping.

Metode suportate

  • initialize - Inițializează sesiunea MCP și obține capabilitățile serverului
  • tools/list - Listează toate instrumentele disponibile cu schemele lor
  • tools/call - Execută un instrument specific cu argumente
  • ping - Verificare a stării ping

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

Încearcă-l

Testați serverul MCP direct din browser. Selectați un instrument și configurați parametrii.

Selectați un instrument

Gestionarea erorilor

Serverul returnează răspunsuri de eroare standard JSON-RPC 2.0. Iată codurile de eroare comune:

CodeMessageDescription
-32600Cerere invalidăJSON-ul trimis nu este un obiect Request valid
-32601Metodă negăsităMetoda solicitată nu există sau nu este disponibilă
-32602Parametri invaliziParametru(i) de metodă invalizi - verificați câmpurile și tipurile necesare
-32603Eroare internăEroare internă JSON-RPC sau problemă pe partea serverului

Exemplu de răspuns cu eroare

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

Limbi acceptate

Titlurile și descrierile proprietăților sunt disponibile în 18 limbi. Folosiți parametrul locale pentru a obține conținut în limba preferată:

Engleză (en), Germană (de), Franceză (fr), Spaniolă (es), Italiană (it), Portugheză (pt), Olandeză (nl), Poloneză (pl), Greacă (el), Română (ro), Cehă (cs), Maghiară (hu), Chineză (zh), Arabă (ar), Rusă (ru), Japoneză (ja), Coreeană (ko), Croată (hr)

Documentație citibilă de mașini

Pentru asistenți AI și instrumente automatizate, oferim fișiere de documentație text simplu conform standardului llms.txt:

llms.txt

Documentație concisă cu URL-ul serverului, configurare și rezumate ale instrumentelor

llms-full.txt

Documentație completă incluzând toți parametrii, exemple de cereri/răspunsuri și coduri de eroare

Aflați mai multe despre standardul llms.txt pe llmstxt.org

Ai nevoie de ajutor?

Dacă ai întrebări despre integrarea cu serverul Fixatia MCP sau întâmpini probleme, echipa noastră de suport pentru dezvoltatori este aici să te ajute.

Contactează suportul pentru dezvoltatoriRaportează o problemă pe GitHub