Serwer MCP MDRealty

Jak się połączyć

Adres serwera

https://mdrealty.me/api/mcp/mcp

Transport: Streamable HTTP. Obsługiwane są wersje protokołu do 2025-11-25.

Autoryzacja

OAuth 2.1 z dynamiczną rejestracją klienta i PKCE. Klient rejestruje się sam, otwiera naszą stronę zgody, a Ty klikasz „Zezwól” — konto ani hasło nie są potrzebne. Następnie klient otrzymuje własny klucz.

Klienci

• Claude (web i aplikacja): otwórz Ustawienia → Łączniki, dodaj własny łącznik i wklej adres serwera.
• ChatGPT: włącz tryb dewelopera w ustawieniach łączników, utwórz łącznik z adresem serwera i wybierz OAuth.
• Claude Code: uruchom poniższe polecenie w terminalu.

  claude mcp add --transport http mdrealty https://mdrealty.me/api/mcp/mcp

• Cursor i inni klienci: dodaj serwer do pliku konfiguracyjnego MCP.

  {
    "mcpServers": {
      "mdrealty": {
        "url": "https://mdrealty.me/api/mcp/mcp"
      }
    }
  }

Narzędzia

Lista jest generowana przez sam serwer, więc zawsze odpowiada temu, co widzi Twój klient.

Klucze partnerskie i służbowe odblokowują dodatkowe narzędzia, takie jak wyszukiwanie po zdjęciu i weryfikacja duplikatów. Aby otrzymać klucz partnerski, napisz do nas.

JSON API bez MCP

Agenci, którzy nie obsługują MCP — GPT Actions, narzędzia LangChain, zwykli klienci HTTP — mogą czytać ten sam katalog przez JSON API. Bez klucza i rejestracji; odpowiedzi są takie same jak z narzędzi MCP.

• GET /api/ai/properties — wyszukiwanie ofert z tymi samymi filtrami co search_properties
• GET /api/ai/properties/{slug} — jedna oferta po slugu, jak get_property
• GET /api/ai/cities — miasta z ofertami, jak list_cities

Przykład

curl "https://mdrealty.me/api/ai/properties?citySlug=budva&query=sea%20view&limit=5"

Opis OpenAPI 3.1/api/ai/openapi.json

Limity

• 60 zapytań na minutę na klucz. Powyżej tego serwer odpowiada 429 z nagłówkiem Retry-After.
• Wszystkie klucze publiczne używane z jednego adresu IP dzielą wspólny limit 300 zapytań na minutę.
• Podłączanie klientów jest ograniczone na adres IP: 20 rejestracji i 20 żądań tokenu na godzinę.
• JSON API bez klucza: 60 zapytań na minutę z jednego adresu IP, do 20 ofert na stronę (większy limit jest przycinany), offset najwyżej 200.
• Do 20 ofert na stronę; kolejne strony pobieraj przez offset.
• Ceny podane są w euro. Oferty zmieniają się codziennie — zanim oprzesz się na cenie, potwierdź dostępność u agenta.

Warunki korzystania

• Używaj danych, aby odpowiadać na pytania swoich użytkowników o nieruchomości w Czarnogórze.
• Podawaj MDRealty jako źródło i linkuj do oferty: pokazuj użytkownikowi pole url, a cytując — canonicalUrl.
• Nie kopiuj katalogu masowo, nie odsprzedawaj danych i nie buduj na ich podstawie konkurencyjnej bazy.
• Treści nie mogą być używane do trenowania modeli AI (robots.txt: Content-Signal ai-train=no).
• Możemy ograniczyć lub unieważnić klucze używane w sposób nadużywający.
• Wywołania narzędzi są zapisywane w dzienniku przez 90 dni w celu działania i ochrony usługi: nazwa narzędzia, parametry z ukrytymi adresami e-mail i numerami telefonów oraz skrócony adres IP. Klucze, których nigdy nie użyto, są usuwane po 30 dniach.

Opis do odczytu maszynowego

Agenci mogą znaleźć i skonfigurować serwer także bez tej strony:

• Karta serwera MCP/.well-known/mcp/server-card.json
• Metadane OAuth chronionego zasobu/.well-known/oauth-protected-resource
• Indeks umiejętności dla agentów/.well-known/agent-skills/index.json
• llms.txt/llms.txt
• OpenAPI dla JSON API/api/ai/openapi.json

Kontakt

Pytania, klucz partnerski lub brakujące narzędzie — napisz na sales@mdrealty.me.