Fixatia
Für Entwickler

MCP-Serverintegration

Verbinden Sie Claude und andere KI-Assistenten mit Fixatias Immobiliendatenbank über das Model Context Protocol

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der KI-Assistenten wie Claude den sicheren Zugriff auf externe Datenquellen ermöglicht. Der MCP-Server von Fixatia bietet Echtzeitzugriff auf unsere europäische Immobilienauktion-Datenbank, sodass KI-Assistenten Immobilien suchen, Details abrufen und verfügbare Filter entdecken können.

Durchsuchen Sie Tausende von Auktionsimmobilien in 6 europäischen Ländern mit erweiterten Filtern

Erhalten Sie umfassende Immobilieninformationen, einschließlich Renovierungsschätzungen, ROI-Berechnungen und mehrsprachigen Beschreibungen

Entdecken Sie dynamisch verfügbare Filteroptionen, um leistungsstarke Suchanfragen zu erstellen

Erfahren Sie mehr über MCP

Schnellstart

1Server-URL

Der Fixatia MCP-Server ist verfügbar unter:

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

2Claude Desktop konfigurieren

Fügen Sie Folgendes zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:

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

3Beginnen Sie zu verwenden

Starten Sie Claude Desktop neu und beginnen Sie, nach Immobilien zu fragen. Claude wird automatisch die Fixatia-Tools verwenden, um Immobilieninformationen zu suchen und abzurufen.

Versuchen Sie zu fragen: "Finde mir Immobilien in Portugal unter 150.000 € mit mindestens 20 % ROI-Potenzial"

Verfügbare Tools

Der Fixatia MCP-Server bietet drei leistungsstarke Tools zur Interaktion mit unserer Immobiliendatenbank:

immobilien_suchen

Suchen Sie nach Immobilienauktionen in ganz Europa. Filtern Sie nach Land, Stadt, Preis, Immobilientyp, ROI-Potenzial und mehr. Gibt eine Liste passender Immobilien mit wichtigen Details, einschließlich Auktionspreise, Marktwerte und Investitionskennzahlen, zurück.

Parameter

ParameterTypeRequiredDescription
querystringOptionalTextsuche nach Immobilientitel, Stadt oder Region
countrystringOptionalLändercode: es (Spanien), pt (Portugal), it (Italien), fr (Frankreich), de (Deutschland), hr (Kroatien)
regionstringOptionalRegionsname innerhalb des Landes
citystringOptionalStadtname
propertyTypestringOptionalArt der Immobilie: WOHNUNG, HAUS, VILLA, GRUNDSTÜCK oder GEWERBLICH
minPricenumberOptionalMindestgebotspreis in EUR
maxPricenumberOptionalHöchstgebotspreis in EUR
minRoinumberOptionalMindest-ROI-Prozentsatz (z.B. 20 für 20%)
bedroomsnumberOptionalMindestanzahl an Schlafzimmern
maxResultsnumberOptionalMaximale Anzahl an Ergebnissen, die zurückgegeben werden sollen (Standard: 10, maximal: 50)
sortBystringOptionalSortierreihenfolge: neueste, preis-niedrig, preis-hoch, roi-hoch oder auktion-bald
localestringOptionalSprache für Titel/Beschreibungen (Standard: en). Unterstützt 18 Sprachen.

Beispielanfrage

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

Beispielantwort

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

Erhalten Sie vollständige Details zu einer bestimmten Immobilie anhand ihrer ID. Gibt umfassende Informationen einschließlich mehrsprachiger Beschreibungen, Bilder, Standortkoordinaten, Renovierungsschätzungen, Auktionsdetails und Investitionskennzahlen zurück.

Parameter

ParameterTypeRequiredDescription
idstringErforderlichDie Immobilien-ID (aus den Suchergebnissen erhalten)
localestringOptionalSprache für Titel/Beschreibung (Standard: en). Unterstützt 18 Sprachen.

Beispielanfrage

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

get_filter_options

Erhalten Sie verfügbare Filteroptionen einschließlich einer Liste von Ländern, Regionen, Städten, Immobilientypen und Preis-/ROI-Bereichen. Nützlich, um zu verstehen, welche Suchparameter verfügbar sind und um dynamische Filteroberflächen zu erstellen.

Dieses Tool benötigt keine Parameter.

Beispielanfrage

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

Beispielantwort

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

Senden Sie eine Anfrage zu einer Immobilie, um Interesse zu bekunden. Dieses Tool erfordert OAuth 2.1-Authentifizierung mit PKCE.

Authentifizierung erforderlich (OAuth 2.1)

Dieses Tool verwendet OAuth 2.1 mit PKCE für sichere Authentifizierung. Der Ablauf ist:

  • Benutzer klickt 'Autorisieren' und meldet sich über Browser an
  • Autorisierungscode wird gegen Zugriffstoken getauscht (PKCE-geschützt)
  • mcp.tools.sendPropertyInquiry.oauthStep3

Parameter

ParameterTypeRequiredDescription
propertyIdstringErforderlichDie Immobilien-ID für die Anfrage
messagestringErforderlichIhre Anfragenachricht, mindestens 10 Zeichen

Beispielanfrage

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

Beispielantwort

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

Der MCP-Server bietet auch eine direkte HTTP-API für programmgesteuerten Zugriff. Alle Anfragen verwenden das JSON-RPC 2.0-Protokoll.

Endpunkte

GET
/api/mcp

Gesundheitscheck und Serverinformationen. Gibt Servername, Version, Protokollversion und verfügbare Tools zurück.

POST
/api/mcp

JSON-RPC 2.0-Anfragen zur Ausführung von Tools. Unterstützt die Methoden initialize, tools/list, tools/call und ping.

Unterstützte Methoden

  • initialize - Initialisieren Sie die MCP-Sitzung und erhalten Sie die Serverfähigkeiten
  • tools/list - Listen Sie alle verfügbaren Tools mit ihren Schemata auf
  • tools/call - Führen Sie ein bestimmtes Tool mit Argumenten aus
  • ping - Gesundheitscheck-Ping

cURL-Beispiel

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

Ausprobieren

Testen Sie den MCP-Server direkt in Ihrem Browser. Wählen Sie ein Tool und konfigurieren Sie die Parameter.

Tool auswählen

Fehlerbehandlung

Der Server gibt standardmäßige JSON-RPC 2.0-Fehlerantworten zurück. Hier sind die häufigsten Fehlercodes:

CodeMessageDescription
-32600Ungültige AnfrageDas gesendete JSON ist kein gültiges Anfrageobjekt
-32601Methode nicht gefundenDie angeforderte Methode existiert nicht oder ist nicht verfügbar
-32602Ungültige ParameterUngültige Methodenparameter - überprüfen Sie die erforderlichen Felder und Typen
-32603Interner FehlerInterner JSON-RPC-Fehler oder serverseitiges Problem

Beispiel-Fehlerantwort

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

Unterstützte Sprachen

Immobilientitel und -beschreibungen sind in 18 Sprachen verfügbar. Verwenden Sie den Parameter 'locale', um Inhalte in Ihrer bevorzugten Sprache zu erhalten:

Englisch (en), Deutsch (de), Französisch (fr), Spanisch (es), Italienisch (it), Portugiesisch (pt), Niederländisch (nl), Polnisch (pl), Griechisch (el), Rumänisch (ro), Tschechisch (cs), Ungarisch (hu), Chinesisch (zh), Arabisch (ar), Russisch (ru), Japanisch (ja), Koreanisch (ko), Kroatisch (hr)

Maschinenlesbare Dokumentation

Für KI-Assistenten und automatisierte Tools stellen wir Klartext-Dokumentationsdateien nach dem llms.txt-Standard bereit:

llms.txt

Kompakte Dokumentation mit Server-URL, Konfiguration und Tool-Zusammenfassungen

llms-full.txt

Vollständige Dokumentation mit allen Parametern, Beispiel-Anfragen/-Antworten und Fehlercodes

Mehr über den llms.txt-Standard erfahren Sie auf llmstxt.org

Brauchen Sie Hilfe?

Wenn Sie Fragen zur Integration mit dem Fixatia MCP-Server haben oder auf Probleme stoßen, steht Ihnen unser Entwickler-Support-Team zur Verfügung.

Entwickler-Support kontaktierenEin Problem auf GitHub melden