Fixatia
Dla Deweloperów

Integracja Serwera MCP

Połącz Claude'a i innych asystentów AI z bazą danych nieruchomości Fixatia, korzystając z Model Context Protocol

Czym jest MCP?

Model Context Protocol (MCP) to otstandaryzowany protokół, który pozwala asystentom AI, takim jak Claude, na bezpieczny dostęp do zewnętrznych źródeł danych. Serwer MCP Fixatia zapewnia dostęp w czasie rzeczywistym do naszej europejskiej bazy danych aukcji nieruchomości, umożliwiając asystentom AI wyszukiwanie nieruchomości, pobieranie szczegółów i odkrywanie dostępnych filtrów.

Wyszukuj tysiące nieruchomości aukcyjnych w 6 europejskich krajach z zaawansowanymi filtrami

Uzyskaj szczegółowe informacje o nieruchomościach, w tym szacunkowe koszty renowacji, obliczenia ROI i opisy w wielu językach

Odkryj dostępne opcje filtrów dynamicznie, aby tworzyć potężne zapytania wyszukiwania

Dowiedz się więcej o MCP

Szybki Start

1Adres URL serwera

Serwer Fixatia MCP jest dostępny pod adresem:

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

2Skonfiguruj Claude Desktop

Dodaj poniższe do swojego pliku konfiguracyjnego 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"
    }
  }
}

3Zacznij używać

Uruchom ponownie Claude Desktop i zacznij pytać o nieruchomości. Claude automatycznie użyje narzędzi Fixatia do wyszukiwania i pobierania informacji o nieruchomościach.

Spróbuj zapytać: "Znajdź mi nieruchomości w Portugalii poniżej 150 000 € z co najmniej 20% potencjałem ROI"

Dostępne Narzędzia

Serwer Fixatia MCP oferuje trzy potężne narzędzia do interakcji z naszą bazą danych nieruchomości:

wyszukaj_nieruchomości

Wyszukaj nieruchomości z aukcji w całej Europie. Filtruj według kraju, miasta, ceny, typu nieruchomości, potencjału ROI i innych. Zwraca listę pasujących nieruchomości z kluczowymi szczegółami, w tym cenami aukcyjnymi, wartościami rynkowymi i wskaźnikami inwestycyjnymi.

Parametry

ParameterTypeRequiredDescription
querystringOpcjonalneWyszukiwanie tekstowe tytułu nieruchomości, miasta lub regionu
countrystringOpcjonalneKod kraju: es (Hiszpania), pt (Portugalia), it (Włochy), fr (Francja), de (Niemcy), hr (Chorwacja)
regionstringOpcjonalneNazwa regionu w kraju
citystringOpcjonalneNazwa miasta
propertyTypestringOpcjonalneTyp nieruchomości: MIESZKANIE, DOM, WILLA, DZIAŁKA, lub KOMERCYJNA
minPricenumberOpcjonalneMinimalna cena aukcyjna w EUR
maxPricenumberOpcjonalneMaksymalna cena aukcyjna w EUR
minRoinumberOpcjonalneMinimalny procent ROI (np. 20 dla 20%)
bedroomsnumberOpcjonalneMinimalna liczba sypialni
maxResultsnumberOpcjonalneMaksymalna liczba wyników do zwrócenia (domyślnie: 10, maks: 50)
sortBystringOpcjonalneKolejność sortowania: najnowsze, cena-niska, cena-wysoka, roi-wysoki lub aukcja-najbliższa
localestringOpcjonalneJęzyk dla tytułów/opisów (domyślnie: en). Obsługuje 18 języków.

Przykładowe Zapytanie

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

Przykładowa Odpowiedź

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

pobierz_nieruchomość

Uzyskaj pełne szczegóły konkretnej nieruchomości według jej ID. Zwraca kompleksowe informacje, w tym opisy w wielu językach, zdjęcia, współrzędne lokalizacji, szacunkowe koszty remontu, szczegóły aukcji oraz metryki inwestycyjne.

Parametry

ParameterTypeRequiredDescription
idstringWymaganeID nieruchomości (uzyskane z wyników wyszukiwania)
localestringOpcjonalneJęzyk dla tytułu/opisu (domyślnie: en). Obsługuje 18 języków.

Przykładowe Zapytanie

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

pobierz_opcje_filtru

Uzyskaj dostępne opcje filtrów, w tym listę krajów, regionów, miast, typów nieruchomości oraz zakresów cen/ROI. Przydatne do zrozumienia, jakie parametry wyszukiwania są dostępne i budowania dynamicznych interfejsów filtrów.

To narzędzie nie przyjmuje żadnych parametrów.

Przykładowe Zapytanie

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

Przykładowa Odpowiedź

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

Wyślij zapytanie o nieruchomość, aby wyrazić zainteresowanie. To narzędzie wymaga uwierzytelnienia OAuth 2.1 z PKCE.

Wymagane uwierzytelnienie (OAuth 2.1)

To narzędzie używa OAuth 2.1 z PKCE do bezpiecznego uwierzytelnienia. Przebieg to:

  • Użytkownik klika 'Autoryzuj' i loguje się przez przeglądarkę
  • Kod autoryzacji jest wymieniany na token dostępu (chroniony PKCE)
  • mcp.tools.sendPropertyInquiry.oauthStep3

Parametry

ParameterTypeRequiredDescription
propertyIdstringWymaganeID nieruchomości do zapytania
messagestringWymaganeTwoja wiadomość zapytania, minimum 10 znaków

Przykładowe Zapytanie

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

Przykładowa Odpowiedź

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

Dokumentacja HTTP API

Serwer MCP udostępnia również bezpośrednie HTTP API do programatycznego dostępu. Wszystkie żądania używają protokołu JSON-RPC 2.0.

Punkty końcowe

GET
/api/mcp

Sprawdzenie stanu i informacje o serwerze. Zwraca nazwę serwera, wersję, wersję protokołu oraz dostępne narzędzia.

POST
/api/mcp

Żądania JSON-RPC 2.0 do wykonania narzędzia. Obsługuje metody initialize, tools/list, tools/call oraz ping.

Obsługiwane metody

  • initialize - Zainicjuj sesję MCP i uzyskaj możliwości serwera
  • tools/list - Wyświetl wszystkie dostępne narzędzia z ich schematami
  • tools/call - Wykonaj konkretne narzędzie z argumentami
  • ping - Sprawdzenie stanu ping

Przykład 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
  }'

Wypróbuj

Przetestuj serwer MCP bezpośrednio z przeglądarki. Wybierz narzędzie i skonfiguruj parametry.

Wybierz narzędzie

Obsługa błędów

Serwer zwraca standardowe odpowiedzi błędów JSON-RPC 2.0. Oto najczęstsze kody błędów:

CodeMessageDescription
-32600Nieprawidłowe żądanieWysłany JSON nie jest prawidłowym obiektem żądania
-32601Metoda nie znalezionaŻądana metoda nie istnieje lub nie jest dostępna
-32602Nieprawidłowe parametryNieprawidłowy(a) parametr(y) metody - sprawdź wymagane pola i typy
-32603Błąd wewnętrznyWewnętrzny błąd JSON-RPC lub problem po stronie serwera

Przykładowa odpowiedź błędu

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

Obsługiwane języki

Tytuły i opisy nieruchomości są dostępne w 18 językach. Użyj parametru locale, aby uzyskać treści w preferowanym języku:

Angielski (en), Niemiecki (de), Francuski (fr), Hiszpański (es), Włoski (it), Portugalski (pt), Niderlandzki (nl), Polski (pl), Grecki (el), Rumuński (ro), Czeski (cs), Węgierski (hu), Chiński (zh), Arabski (ar), Rosyjski (ru), Japoński (ja), Koreański (ko), Chorwacki (hr)

Dokumentacja czytelna maszynowo

Dla asystentów AI i narzędzi automatycznych udostępniamy pliki dokumentacji w formacie tekstowym zgodne ze standardem llms.txt:

llms.txt

Zwięzła dokumentacja z adresem URL serwera, konfiguracją i podsumowaniami narzędzi

llms-full.txt

Pełna dokumentacja zawierająca wszystkie parametry, przykładowe żądania/odpowiedzi i kody błędów

Dowiedz się więcej o standardzie llms.txt na llmstxt.org

Potrzebujesz pomocy?

Jeśli masz pytania dotyczące integracji z serwerem Fixatia MCP lub napotkałeś jakiekolwiek problemy, nasz zespół wsparcia dla deweloperów jest tutaj, aby pomóc.

Skontaktuj się z wsparciem dla deweloperówZgłoś problem na GitHubie