خادم MCP
يستخدم وكلاء الذكاء الاصطناعي Birlesa عبر خادم بروتوكول سياق النموذج (Model Context Protocol)(يُفتح في علامة تبويب جديدة) على https://api.birlesa.com/mcp. يعمل بنقل HTTP القابل للبث (streamable HTTP)، دون حفظ للحالة، وباستجابات JSON. وتحاكي الأدوات واجهة REST البرمجية وتتبع قواعدها.
| الأداة | ما تفعله | ما تحتاجه |
|---|---|---|
search_companies | البحث عن الشركات بالنص أو المنتج أو المكان | لا شيء (المفتاح يرفع حد المعدل) |
get_company | الملف العام لشركة واحدة | لا شيء |
list_opportunities | فرص الشراء العامة المفتوحة | لا شيء |
submit_need | نشر ما تريد مؤسستك شراءه، مع destination_country حين يكون الشراء بغرض التصدير | مفتاح بصلاحية needs:write |
request_quotes | طلب عروض أسعار من 20 شركة كحد أقصى على احتياج مفتوح | مفتاح بصلاحية rfqs:send |
أرسل مفتاح API الخاص بالمؤسسة بصيغة Authorization: Bearer brl_api_... على اتصال MCP. وتتحقق الأدوات التي تعمل باسم المؤسسة من المفتاح مجددًا في كل استدعاء، لذا فإن إلغاءه يوقفها فورًا. وهي تعمل بصلاحيات الشخص الذي أصدر المفتاح، وتتوقف عن العمل إذا لم يعد ذلك الشخص يدير المؤسسة.
تتبع النصوص التي ينشرها الوكيل قواعد لوحة التحكم: لا أرقام هواتف ولا عناوين بريد إلكتروني ولا أرقام هويات (يصل الموردون إلى المشتري عبر Birlesa). وتُراجَع الاحتياجات الأولى لأي مشترٍ جديد على يد شخص قبل أن يراها أحد. وحدود المعدل هي حدود الواجهة البرمجية.