Για Προγραμματιστές

Ενοποίηση Διακομιστή MCP

Συνδέστε τον Claude και άλλους AI βοηθούς με τη βάση δεδομένων ακινήτων της Fixatia χρησιμοποιώντας το Πρωτόκολλο Συμφραζομένων Μοντέλου

Τι είναι το MCP;

Το Πρωτόκολλο Συμφραζομένων Μοντέλου (MCP) είναι ένα ανοιχτό πρότυπο που επιτρέπει στους AI βοηθούς όπως ο Claude να έχουν ασφαλή πρόσβαση σε εξωτερικές πηγές δεδομένων. Ο διακομιστής MCP της Fixatia παρέχει πρόσβαση σε πραγματικό χρόνο στη βάση δεδομένων δημοπρασιών ακινήτων μας στην Ευρώπη, επιτρέποντας στους AI βοηθούς να αναζητούν ακίνητα, να ανακτούν λεπτομέρειες και να ανακαλύπτουν διαθέσιμα φίλτρα.

Αναζητήστε χιλιάδες ακίνητα δημοπρασιών σε 6 ευρωπαϊκές χώρες με προηγμένα φίλτρα

Αποκτήστε λεπτομερείς πληροφορίες για τα ακίνητα, συμπεριλαμβανομένων εκτιμήσεων ανακαίνισης, υπολογισμών ROI και πολυγλωσσικών περιγραφών

Ανακαλύψτε διαθέσιμες επιλογές φίλτρων δυναμικά για να δημιουργήσετε ισχυρές ερωτήσεις αναζήτησης

Μάθετε περισσότερα για το MCP

Γρήγορη Εκκίνηση

1Διεύθυνση URL Διακομιστή

Ο διακομιστής MCP της Fixatia είναι διαθέσιμος στη διεύθυνση:

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

2Ρύθμιση του Claude Desktop

Προσθέστε τα παρακάτω στο αρχείο ρύθμισης του 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Αρχίστε να Χρησιμοποιείτε

Επανεκκινήστε το Claude Desktop και αρχίστε να ρωτάτε για ακίνητα. Ο Claude θα χρησιμοποιήσει αυτόματα τα εργαλεία Fixatia για να αναζητήσει και να ανακτήσει πληροφορίες για ακίνητα.

Δοκιμάστε να ρωτήσετε: "Βρείτε μου ακίνητα στην Πορτογαλία κάτω από 150.000 € με τουλάχιστον 20% δυναμικό ROI"

Διαθέσιμα Εργαλεία

Ο διακομιστής Fixatia MCP παρέχει τρία ισχυρά εργαλεία για την αλληλεπίδραση με τη βάση δεδομένων ακινήτων μας:

αναζήτηση_ακινήτων

Αναζητήστε ακίνητα σε δημοπρασία σε όλη την Ευρώπη. Φιλτράρετε κατά χώρα, πόλη, τιμή, τύπο ακινήτου, δυναμικό ROI και άλλα. Επιστρέφει μια λίστα με τα αντίστοιχα ακίνητα με βασικές λεπτομέρειες, συμπεριλαμβανομένων των τιμών δημοπρασίας, των αγοραίων αξιών και των μετρήσεων επένδυσης.

Παράμετροι

Parameter	Type	Required	Description
query	string	Προαιρετικό	Κείμενο αναζήτησης για τίτλο ακινήτου, πόλη ή περιοχή
country	string	Προαιρετικό	Κωδικός χώρας: es (Ισπανία), pt (Πορτογαλία), it (Ιταλία), fr (Γαλλία), de (Γερμανία), hr (Κροατία)
region	string	Προαιρετικό	Όνομα περιοχής εντός της χώρας
city	string	Προαιρετικό	Όνομα πόλης
propertyType	string	Προαιρετικό	Τύπος ακινήτου: ΔΙΑΜΕΡΙΣΜΑ, ΣΠΙΤΙ, ΒΙΛΑ, ΓΗ ή ΕΜΠΟΡΙΚΟ
minPrice	number	Προαιρετικό	Ελάχιστη τιμή δημοπρασίας σε EUR
maxPrice	number	Προαιρετικό	Μέγιστη τιμή δημοπρασίας σε EUR
minRoi	number	Προαιρετικό	Ελάχιστο ποσοστό ROI (π.χ., 20 για 20%)
bedrooms	number	Προαιρετικό	Ελάχιστος αριθμός υπνοδωματίων
maxResults	number	Προαιρετικό	Μέγιστος αριθμός αποτελεσμάτων που θα επιστραφούν (προεπιλογή: 10, μέγιστο: 50)
sortBy	string	Προαιρετικό	Διαταγή ταξινόμησης: νεότερα, τιμή-χαμηλή, τιμή-υψηλή, roi-υψηλό ή δημοπρασία-σύντομα
locale	string	Προαιρετικό	Γλώσσα για τίτλους/περιγραφές (προεπιλογή: en). Υποστηρίζει 18 γλώσσες.

Παράδειγμα Αίτησης

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

Παράδειγμα Απόκρισης

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

πάρε_ακίνητο

Αποκτήστε πλήρεις λεπτομέρειες ενός συγκεκριμένου ακινήτου με βάση το ID του. Επιστρέφει εκτενή πληροφορίες, συμπεριλαμβανομένων πολυγλωσσικών περιγραφών, εικόνων, συντεταγμένων τοποθεσίας, εκτιμήσεων ανακαίνισης, λεπτομερειών δημοπρασίας και μετρήσεων επένδυσης.

Παράμετροι

Parameter	Type	Required	Description
id	string	Απαιτείται	Το ID της ιδιοκτησίας (που αποκτήθηκε από τα αποτελέσματα αναζήτησης)
locale	string	Προαιρετικό	Γλώσσα για τίτλο/περιγραφή (προεπιλογή: en). Υποστηρίζει 18 γλώσσες.

Παράδειγμα Αίτησης

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

get_filter_options

Αποκτήστε διαθέσιμες επιλογές φίλτρου, συμπεριλαμβανομένων των λιστών χωρών, περιοχών, πόλεων, τύπων ακινήτων και εύρους τιμών/ROI. Χρήσιμο για την κατανόηση των διαθέσιμων παραμέτρων αναζήτησης και την κατασκευή δυναμικών διεπαφών φίλτρου.

Αυτό το εργαλείο δεν δέχεται παραμέτρους.

Παράδειγμα Αίτησης

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

Παράδειγμα Απόκρισης

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

Στείλτε ερώτημα για ένα ακίνητο για να εκφράσετε ενδιαφέρον. Αυτό το εργαλείο απαιτεί πιστοποίηση OAuth 2.1 με PKCE.

Απαιτείται πιστοποίηση (OAuth 2.1)

Αυτό το εργαλείο χρησιμοποιεί OAuth 2.1 με PKCE για ασφαλή πιστοποίηση. Η διαδικασία είναι:

Ο χρήστης κάνει κλικ στο 'Εξουσιοδότηση' και συνδέεται μέσω προγράμματος περιήγησης
Ο κωδικός εξουσιοδότησης ανταλλάσσεται με token πρόσβασης (προστατεύεται με PKCE)
mcp.tools.sendPropertyInquiry.oauthStep3

Παράμετροι

Parameter	Type	Required	Description
propertyId	string	Απαιτείται	Το ID του ακινήτου για ερώτημα
message	string	Απαιτείται	Το μήνυμα ερώτησής σας, τουλάχιστον 10 χαρακτήρες

Παράδειγμα Αίτησης

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

Παράδειγμα Απόκρισης

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

Ο διακομιστής MCP παρέχει επίσης μια άμεση HTTP API για προγραμματιστική πρόσβαση. Όλες οι αιτήσεις χρησιμοποιούν το πρωτόκολλο JSON-RPC 2.0.

Τέλη

GET

/api/mcp

Έλεγχος υγείας και πληροφορίες διακομιστή. Επιστρέφει το όνομα του διακομιστή, την έκδοση, την έκδοση του πρωτοκόλλου και τα διαθέσιμα εργαλεία.

POST

/api/mcp

Αιτήσεις JSON-RPC 2.0 για εκτέλεση εργαλείων. Υποστηρίζει τις μεθόδους initialize, tools/list, tools/call και ping.

Υποστηριζόμενες Μέθοδοι

initialize - Αρχικοποίηση της συνεδρίας MCP και απόκτηση δυνατοτήτων διακομιστή
tools/list - Λίστα όλων των διαθέσιμων εργαλείων με τα σχήματά τους
tools/call - Εκτέλεση συγκεκριμένου εργαλείου με παραμέτρους
ping - Έλεγχος υγείας ping

Παράδειγμα 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
  }'

Δοκιμάστε το

Δοκιμάστε τον MCP server απευθείας από το πρόγραμμα περιήγησής σας. Επιλέξτε ένα εργαλείο και διαμορφώστε τις παραμέτρους.

Επιλέξτε εργαλείο

Διαχείριση Σφαλμάτων

Ο διακομιστής επιστρέφει τυπικές απαντήσεις σφαλμάτων JSON-RPC 2.0. Εδώ είναι οι κοινές κωδικοί σφαλμάτων:

Code	Message	Description
-32600	Μη έγκυρη Αίτηση	Το JSON που στάλθηκε δεν είναι έγκυρο αντικείμενο Αίτησης
-32601	Η μέθοδος δεν βρέθηκε	Η ζητούμενη μέθοδος δεν υπάρχει ή δεν είναι διαθέσιμη
-32602	Μη έγκυρες παράμετροι	Μη έγκυρη παράμετρος μεθόδου - ελέγξτε τα απαιτούμενα πεδία και τους τύπους
-32603	Εσωτερικό σφάλμα	Εσωτερικό σφάλμα JSON-RPC ή πρόβλημα πλευράς διακομιστή

Παράδειγμα Απόκρισης Σφάλματος

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

Υποστηριζόμενες Γλώσσες

Οι τίτλοι και οι περιγραφές ακινήτων είναι διαθέσιμοι σε 18 γλώσσες. Χρησιμοποιήστε την παράμετρο locale για να λάβετε περιεχόμενο στη προτιμώμενη γλώσσα σας:

Αγγλικά (en), Γερμανικά (de), Γαλλικά (fr), Ισπανικά (es), Ιταλικά (it), Πορτογαλικά (pt), Ολλανδικά (nl), Πολωνικά (pl), Ελληνικά (el), Ρουμανικά (ro), Τσέχικα (cs), Ουγγρικά (hu), Κινέζικα (zh), Αραβικά (ar), Ρωσικά (ru), Ιαπωνικά (ja), Κορεατικά (ko), Κροατικά (hr)

Αναγνώσιμη από Μηχανές Τεκμηρίωση

Για βοηθούς AI και αυτοματοποιημένα εργαλεία, παρέχουμε αρχεία τεκμηρίωσης απλού κειμένου σύμφωνα με το πρότυπο llms.txt:

llms.txt

Συνοπτική τεκμηρίωση με URL διακομιστή, διαμόρφωση και περιλήψεις εργαλείων

llms-full.txt

Πλήρης τεκμηρίωση με όλες τις παραμέτρους, παραδείγματα αιτημάτων/απαντήσεων και κωδικούς σφαλμάτων

Μάθετε περισσότερα για το πρότυπο llms.txt στο llmstxt.org

Χρειάζεστε Βοήθεια;

Εάν έχετε ερωτήσεις σχετικά με την ενσωμάτωση με τον διακομιστή Fixatia MCP ή αντιμετωπίζετε οποιαδήποτε προβλήματα, η ομάδα υποστήριξης προγραμματιστών μας είναι εδώ για να βοηθήσει.

Επικοινωνία με την Υποστήριξη Προγραμματιστών Αναφέρετε ένα Πρόβλημα στο GitHub