نقطة نهاية MCP

FlatFlash عبر MCP

نقطة نهاية واحدة لأي عميل MCP: ابحث في الإعلانات، واقرأ بحثك المحفوظ، واسحب ملخّصاً بأفضل جهد ممكن. إضافة ChatGPT هي مسار المستهلك؛ وهذه الصفحة لعميلك الخاص.

نقطة النهاية

POSThttps://mcp.flatflash.com/mcp

Streamable HTTP، طلب POST واحد، مصادقة bearer. لا بث GET ولا جلسات ولا استئناف.

افتح التطبيقات المتصلة

بيانان اعتماديان وحساب واحد

البابان يصلان إلى المشترك نفسه، والبحث المحفوظ نفسه، وسجل الملخّصات نفسه. اختر ما يدعمه عميلك.

OAuth 2.1 لإضافة ChatGPT

تتصل الإضافة المنشورة عبر خادم تفويض FlatFlash باستخدام OAuth 2.1 وPKCE. التثبيت والموافقة خطوتان يدويتان في ChatGPT، ولا يستطيع أي أمر تنفيذهما.

اقرأ دليل الإضافة

رمز وصول شخصي لعميل MCP عام

أنشئ رمزاً في «التطبيقات المتصلة» وأرسله كرمز bearer. يُعرض النص الصريح مرة واحدة، ولا يحفظ FlatFlash سوى تجزئته.

أنشئ رمزاً

خصائص رمز الوصول الشخصي

  • ينتهي بعد ٩٠ يوماً من الإنشاء؛ والخادم هو من يحدد المدة.
  • يُحفظ كتجزئة SHA-256. يُعرض النص الصريح مرة واحدة ولا يمكن استرجاعه لاحقاً.
  • قابل للإلغاء في أي وقت لكل رمز على حدة.
  • كل استدعاء ناجح يسجل last_used_at، فتعرض «التطبيقات المتصلة» آخر استخدام.

ما يستطيعه رمز الوصول وما لا يستطيعه

قراءة الإعلانات، وقراءة بحثك المحفوظ وإنشاؤه أو تحديثه، وقراءة استحقاقك وسحب ملخّص.

لا حذف أو إيقاف مؤقت لبحث محفوظ، ولا إلغاء اشتراك، ولا تغيير في الفوترة، ولا وصول إلى حساب آخر.

لا توجد أداة لأي شيء أبعد من ذلك: نقطة النهاية لا تقدم مثل هذه العملية.

الأدوات

سبع أدوات ونطاقان. لا تأخذ أي أداة معرّف مستخدم: الهوية تأتي من رمز bearer.

search_listings
قراءة listings:read

يبحث في الإعلانات الحالية حسب المدينة والأحياء والميزانية والغرف وWBS والمزايا. يعيد نتائج مختصرة مع روابط FlatFlash والإعلان الأصلي.

get_listing
قراءة listings:read

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

get_saved_searches
قراءة alerts:write

يسرد عمليات البحث المحفوظة لديك.

create_saved_search
كتابة alerts:write

ينشئ بحثك المحفوظ، ويبدأ التجربة المجانية لـ ١٠ أيام إن كانت ما تزال متاحة. متكرر بأمان: الاستدعاء التالي يعيد البحث القائم.

update_saved_search
كتابة alerts:write

يحدّث المعايير أو حجم الدفعة أو أقصى مدة انتظار. متكرر بأمان.

get_entitlement
قراءة alerts:write

حالة الاشتراك وتوفر الميزات ورابط معلومات الخطة.

get_digest
قراءة alerts:write

المطابقات الجديدة منذ آخر ملخّص، بحد أقصى؛ ولا يتقدم المؤشر إلا بعد استدعاء ناجح.

النطاقات

يُفحص النطاق في كل طلب؛ فإن لم يحمله الاعتماد تُرفض الطلب ولا تعمل أي أداة.

listings:read

يبحث في الإعلانات ويقرأ إعلاناً واحداً. لا تحتاج هذه الأدوات إلى استحقاق اشتراك.

alerts:write

يقرأ ويكتب عمليات البحث المحفوظة والاستحقاق والملخّص.

الأدوات العامة لا تحتاج استحقاق اشتراك، لكنها تحتاج رمزاً: كل POST /mcp يحمل رمز bearer.

استدعِه من الطرفية

صدّر نقطة النهاية ورمزك الشخصي ثم أرسل طلب JSON-RPC واحداً. العنصر النائب يمثل رمزك؛ لا تضع الرمز أبداً في أمر أو وسيط أداة أو عنوان URL.

export FLATFLASH_MCP_ENDPOINT="https://mcp.flatflash.com/mcp"
export FLATFLASH_PAT="<your-personal-access-token>"

curl -sS "$FLATFLASH_MCP_ENDPOINT" \
  -H "Authorization: Bearer $FLATFLASH_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_listings",
      "arguments": {"city": "berlin", "max_budget_eur": 1200, "min_rooms": 2}
    }
  }'

الاستجابة نتيجة JSON-RPC تحوي كتلة نصية للنموذج وstructuredContent لعميلك.

الإنشاء والإلغاء

تعرض «التطبيقات المتصلة» كل منحة MCP وكل رمز مع نطاقاته وآخر استخدام.

إلغاء رمز أو اتصال OAuth ينهي الوصول في الطلب التالي: تجيب نقطة النهاية بالرمز 401 ولا تعمل أي أداة. وتبقى جلسة الويب وبحثك المحفوظ.

افتح التطبيقات المتصلة

إزالة الإضافة أو فصلها في ChatGPT تلغي منحة OAuth بالطريقة نفسها.

ملاحظات الأمان

رموز مرتبطة بالجمهور: رمز الوصول صالح لهذا المورد MCP فقط، وليس اعتماداً عاماً لـ FlatFlash.

ترويسة bearer فقط: لا تُقبل الرموز في أمر أو وسيط أداة أو سلسلة استعلام أو سجل.

لا تمرير: لا يمرر FlatFlash رمزك أبداً إلى خدمة أخرى.

بيانات إعلانات عامة فقط: مخرجات الأدوات لا تحوي بيانات اتصال المالك ولا معرّفات داخلية ولا معرّفات جلسة.

أفضل جهد، وسحب فقط

عميلك يقرر متى يُستدعى الملخّص. لا يجدول FlatFlash الاستدعاء ولا يدفع إلى عميلك؛ ويبقى تليجرام وتطبيق الويب قناتي التنبيه الموثوقتين.

احتفظ بالتنبيهات الموثوقة

ملخّص MCP بأفضل جهد ويعتمد على عميلك. ويوصل تليجرام وتطبيق الويب التنبيهات بمعزل عن أي عميل ذكاء اصطناعي.

اقرأ دليل إضافة ChatGPT
ابدأ الآن