للمطورين

تكامل خادم MCP

قم بتوصيل كلود ومساعدين ذكيين آخرين بقاعدة بيانات العقارات الخاصة بـ Fixatia باستخدام بروتوكول سياق النموذج

ما هو MCP؟

بروتوكول سياق النموذج (MCP) هو معيار مفتوح يسمح للمساعدين الذكيين مثل كلود بالوصول بشكل آمن إلى مصادر البيانات الخارجية. يوفر خادم MCP الخاص بـ Fixatia وصولاً في الوقت الحقيقي إلى قاعدة بيانات مزادات العقارات الأوروبية لدينا، مما يمكّن المساعدين الذكيين من البحث عن العقارات، واسترجاع التفاصيل، واكتشاف الفلاتر المتاحة.

ابحث عن آلاف العقارات في المزادات عبر 6 دول أوروبية مع فلاتر متقدمة

احصل على تفاصيل شاملة عن العقارات بما في ذلك تقديرات التجديد، وحسابات العائد على الاستثمار، ووصف متعدد اللغات

اكتشف خيارات الفلترة المتاحة ديناميكيًا لبناء استعلامات بحث قوية

تعرف على المزيد حول MCP

بدء سريع

1عنوان الخادم

خادم MCP الخاص بـ Fixatia متاح على:

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

2تكوين كلود ديسكتوب

أضف ما يلي إلى ملف تكوين كلود ديسكتوب الخاص بك:

ويندوز: %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ابدأ الاستخدام

أعد تشغيل كلود ديسكتوب وابدأ في السؤال عن العقارات. سيستخدم كلود أدوات Fixatia تلقائيًا للبحث واسترجاع معلومات العقارات.

جرّب أن تسأل: "ابحث لي عن عقارات في البرتغال تحت 150,000 يورو مع إمكانية عائد على الاستثمار لا تقل عن 20%"

الأدوات المتاحة

يوفر خادم MCP الخاص بـ Fixatia ثلاث أدوات قوية للتفاعل مع قاعدة بيانات العقارات الخاصة بنا:

البحث عن العقارات

ابحث عن عقارات المزادات العقارية في جميع أنحاء أوروبا. قم بتصفية النتائج حسب البلد، المدينة، السعر، نوع العقار، إمكانية العائد على الاستثمار، والمزيد. تعيد قائمة بالعقارات المتطابقة مع التفاصيل الرئيسية بما في ذلك أسعار المزادات، القيم السوقية، ومقاييس الاستثمار.

المعلمات

Parameter	Type	Required	Description
query	string	اختياري	بحث نصي عن عنوان العقار، المدينة، أو المنطقة
country	string	اختياري	رمز الدولة: es (إسبانيا)، pt (البرتغال)، it (إيطاليا)، fr (فرنسا)، de (ألمانيا)، hr (كرواتيا)
region	string	اختياري	اسم المنطقة داخل الدولة
city	string	اختياري	اسم المدينة
propertyType	string	اختياري	نوع العقار: شقة، منزل، فيلا، أرض، أو تجاري
minPrice	number	اختياري	أدنى سعر مزاد باليورو
maxPrice	number	اختياري	أعلى سعر مزاد باليورو
minRoi	number	اختياري	أدنى نسبة عائد على الاستثمار (مثل، 20 لـ 20%)
bedrooms	number	اختياري	أدنى عدد من غرف النوم
maxResults	number	اختياري	أقصى عدد من النتائج للعودة (افتراضي: 10، أقصى: 50)
sortBy	string	اختياري	ترتيب الفرز: الأحدث، السعر-الأدنى، السعر-الأعلى، العائد-الأعلى، أو المزاد-الأقرب
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
          }
        ]
      }
    }]
  }
}

الحصول على العقار

احصل على تفاصيل كاملة لعقار معين من خلال معرفه. تعيد معلومات شاملة بما في ذلك أوصاف متعددة اللغات، صور، إحداثيات الموقع، تقديرات التجديد، تفاصيل المزاد، ومقاييس الاستثمار.

المعلمات

Parameter	Type	Required	Description
id	string	مطلوب	معرف العقار (المستخرج من نتائج البحث)
locale	string	اختياري	اللغة للعناوين/الوصف (افتراضي: en). يدعم 18 لغة.

طلب مثال

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

الحصول على خيارات التصفية

احصل على خيارات التصفية المتاحة بما في ذلك قائمة بالدول، المناطق، المدن، أنواع العقارات، ونطاقات الأسعار/العائد على الاستثمار. مفيد لفهم ما هي معلمات البحث المتاحة وبناء واجهات تصفية ديناميكية.

هذه الأداة لا تأخذ أي معلمات.

طلب مثال

{
  "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 للمصادقة الآمنة. الخطوات هي:

ينقر المستخدم على 'تفويض' ويسجل الدخول عبر المتصفح
يتم استبدال رمز التفويض برمز الوصول (محمي بـ PKCE)
mcp.tools.sendPropertyInquiry.oauthStep3

المعلمات

Parameter	Type	Required	Description
propertyId	string	مطلوب	معرف العقار للاستفسار عنه
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

يقدم خادم MCP أيضًا واجهة برمجة تطبيقات HTTP مباشرة للوصول البرمجي. جميع الطلبات تستخدم بروتوكول JSON-RPC 2.0.

نقاط النهاية

GET

/api/mcp

فحص الصحة ومعلومات الخادم. تعيد اسم الخادم، الإصدار، إصدار البروتوكول، والأدوات المتاحة.

POST

/api/mcp

طلبات JSON-RPC 2.0 لتنفيذ الأدوات. يدعم طرق التهيئة، tools/list، tools/call، و ping.

الطرق المدعومة

initialize - تهيئة جلسة MCP والحصول على قدرات الخادم
tools/list - قائمة بجميع الأدوات المتاحة مع مخططاتها
tools/call - تنفيذ أداة معينة مع المعاملات
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 مباشرة من متصفحك. حدد أداة وقم بتكوين المعلمات.

حدد أداة

معالجة الأخطاء

يعيد الخادم استجابات أخطاء 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)

وثائق قابلة للقراءة الآلية

لمساعدي الذكاء الاصطناعي والأدوات الآلية، نوفر ملفات وثائق نصية بسيطة وفقًا لمعيار llms.txt:

llms.txt

وثائق موجزة تتضمن عنوان URL للخادم والتكوين وملخصات الأدوات

llms-full.txt

وثائق كاملة تشمل جميع المعلمات وأمثلة الطلبات/الاستجابات ورموز الأخطاء

تعرف على المزيد حول معيار llms.txt على llmstxt.org

تحتاج إلى مساعدة؟

إذا كانت لديك أسئلة حول التكامل مع خادم Fixatia MCP أو واجهت أي مشاكل، فإن فريق دعم المطورين لدينا هنا للمساعدة.

اتصل بدعم المطورين الإبلاغ عن مشكلة على GitHub