Fixatia
Pro vývojáře

Integrace MCP Serveru

Připojte Claude a další AI asistenty k databázi nemovitostí Fixatia pomocí Model Context Protocol

Co je MCP?

Model Context Protocol (MCP) je otevřený standard, který umožňuje AI asistentům jako Claude bezpečně přistupovat k externím datovým zdrojům. MCP server Fixatia poskytuje přístup v reálném čase k naší databázi evropských aukcí nemovitostí, což umožňuje AI asistentům vyhledávat nemovitosti, získávat podrobnosti a objevovat dostupné filtry.

Vyhledávejte tisíce aukčních nemovitostí napříč 6 evropskými zeměmi s pokročilými filtry

Získejte komplexní podrobnosti o nemovitostech včetně odhadů renovací, výpočtů ROI a vícejazyčných popisů

Dynamicky objevujte dostupné možnosti filtrů pro vytváření silných vyhledávacích dotazů

Zjistěte více o MCP

Rychlý start

1URL serveru

Server Fixatia MCP je k dispozici na:

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

2Nastavte Claude Desktop

Přidejte následující do konfiguračního souboru vašeho 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"
    }
  }
}

3Začněte používat

Restartujte Claude Desktop a začněte se ptát na nemovitosti. Claude automaticky použije nástroje Fixatia k vyhledávání a získávání informací o nemovitostech.

Zkuste se zeptat: "Najděte mi nemovitosti v Portugalsku pod 150 000 € s minimálním potenciálem ROI 20%"

Dostupné nástroje

Server Fixatia MCP poskytuje tři výkonné nástroje pro interakci s naší databází nemovitostí:

vyhledat_nemovitosti

Hledejte nemovitosti z aukcí po celé Evropě. Filtrujte podle země, města, ceny, typu nemovitosti, potenciálu ROI a dalších. Vrátí seznam odpovídajících nemovitostí s klíčovými detaily včetně aukčních cen, tržních hodnot a investičních metrik.

Parametry

ParameterTypeRequiredDescription
querystringVolitelnéTextové vyhledávání podle názvu nemovitosti, města nebo regionu
countrystringVolitelnéKód země: es (Španělsko), pt (Portugalsko), it (Itálie), fr (Francie), de (Německo), hr (Chorvatsko)
regionstringVolitelnéNázev regionu v rámci země
citystringVolitelnéNázev města
propertyTypestringVolitelnéTyp nemovitosti: BYT, DŮM, VILA, POZEMEK nebo KOMERČNÍ
minPricenumberVolitelnéMinimální aukční cena v EUR
maxPricenumberVolitelnéMaximální aukční cena v EUR
minRoinumberVolitelnéMinimální procento ROI (např. 20 pro 20%)
bedroomsnumberVolitelnéMinimální počet ložnic
maxResultsnumberVolitelnéMaximální počet výsledků k vrácení (výchozí: 10, max: 50)
sortBystringVolitelnéPořadí řazení: nejnovější, cena-nízká, cena-vysoká, roi-vysoká nebo aukce-najdříve
localestringVolitelnéJazyk pro názvy/ popisy (výchozí: en). Podporuje 18 jazyků.

Ukázkový požadavek

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

Ukázková odpověď

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

získat_nemovitost

Získejte podrobné informace o konkrétní nemovitosti podle jejího ID. Vrací komplexní informace včetně vícejazyčných popisů, obrázků, geografických souřadnic, odhadů renovací, detailů aukcí a investičních metrik.

Parametry

ParameterTypeRequiredDescription
idstringPovinnéID nemovitosti (získané z výsledků vyhledávání)
localestringVolitelnéJazyk pro název/popis (výchozí: en). Podporuje 18 jazyků.

Ukázkový požadavek

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

get_filter_options

Získejte dostupné možnosti filtrování včetně seznamu zemí, regionů, měst, typů nemovitostí a cenových/ROI rozsahů. Užitečné pro pochopení dostupných parametrů vyhledávání a vytváření dynamických rozhraní pro filtrování.

Tento nástroj nevyžaduje žádné parametry.

Ukázkový požadavek

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

Ukázková odpověď

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

Odešlete dotaz o nemovitosti pro vyjádření zájmu. Tento nástroj vyžaduje OAuth 2.1 ověření s PKCE.

Vyžadováno ověření (OAuth 2.1)

Tento nástroj používá OAuth 2.1 s PKCE pro bezpečné ověření. Postup je:

  • Uživatel klikne na 'Autorizovat' a přihlásí se přes prohlížeč
  • Autorizační kód je vyměněn za přístupový token (chráněno PKCE)
  • mcp.tools.sendPropertyInquiry.oauthStep3

Parametry

ParameterTypeRequiredDescription
propertyIdstringPovinnéID nemovitosti pro dotaz
messagestringPovinnéVaše zpráva s dotazem, minimálně 10 znaků

Ukázkový požadavek

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

Ukázková odpověď

{
  "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 Referenční příručka

Server MCP také poskytuje přímé HTTP API pro programatický přístup. Všechny požadavky používají protokol JSON-RPC 2.0.

Koncové body

GET
/api/mcp

Kontrola zdraví a informace o serveru. Vrací název serveru, verzi, verzi protokolu a dostupné nástroje.

POST
/api/mcp

JSON-RPC 2.0 požadavky pro provedení nástroje. Podporuje metody initialize, tools/list, tools/call a ping.

Podporované metody

  • initialize - Inicializujte relaci MCP a získejte schopnosti serveru
  • tools/list - Seznam všech dostupných nástrojů s jejich schématy
  • tools/call - Proveďte konkrétní nástroj s argumenty
  • ping - Kontrola zdraví ping

cURL Příklad

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

Vyzkoušejte

Otestujte MCP server přímo ve vašem prohlížeči. Vyberte nástroj a nakonfigurujte parametry.

Vyberte nástroj

Zpracování chyb

Server vrací standardní JSON-RPC 2.0 chybové odpovědi. Zde jsou běžné chybové kódy:

CodeMessageDescription
-32600Neplatný požadavekOdeslaný JSON není platný objekt požadavku
-32601Metoda nebyla nalezenaPožadovaná metoda neexistuje nebo není dostupná
-32602Neplatné parametryNeplatný parametr metody - zkontrolujte požadovaná pole a typy
-32603Interní chybaInterní chyba JSON-RPC nebo problém na straně serveru

Příklad chybové odpovědi

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

Podporované jazyky

Názvy a popisy nemovitostí jsou k dispozici ve 18 jazycích. Použijte parametr locale pro získání obsahu ve vašem preferovaném jazyce:

Angličtina (en), Němčina (de), Francouzština (fr), Španělština (es), Italština (it), Portugalština (pt), Nizozemština (nl), Polština (pl), Řečtina (el), Rumunština (ro), Čeština (cs), Maďarština (hu), Čínština (zh), Arabština (ar), Ruština (ru), Japonština (ja), Korejština (ko), Chorvatština (hr)

Strojově čitelná dokumentace

Pro AI asistenty a automatizované nástroje poskytujeme dokumentační soubory v prostém textu podle standardu llms.txt:

llms.txt

Stručná dokumentace s URL serveru, konfigurací a přehledy nástrojů

llms-full.txt

Kompletní dokumentace zahrnující všechny parametry, příklady požadavků/odpovědí a chybové kódy

Více o standardu llms.txt na llmstxt.org

Potřebujete pomoc?

Pokud máte dotazy ohledně integrace se serverem Fixatia MCP nebo narazíte na nějaké problémy, náš tým podpory pro vývojáře je tu, aby vám pomohl.

Kontaktujte podporu pro vývojářeNahlásit problém na GitHubu