سرور MCP
دستیارهای هوش مصنوعی از طریق سرور Model Context Protocol(در زبانه جدید باز می‌شود) در https://api.birlesa.com/mcp از Birlesa استفاده می‌کنند. این سرور از HTTP جریانی (streamable HTTP) به‌صورت بی‌حالت (stateless) و با پاسخ‌های JSON کار می‌کند. ابزارها همتای REST API هستند و از قواعد آن پیروی می‌کنند.
| ابزار | کار | چه می‌خواهد |
|---|---|---|
search_companies | جست‌وجوی شرکت‌ها با متن، محصول یا مکان | هیچ (کلید، محدودیت نرخ را بالاتر می‌برد) |
get_company | نمایهٔ عمومی یک شرکت | هیچ |
list_opportunities | فرصت‌های خرید عمومی باز | هیچ |
submit_need | ثبت آنچه سازمانتان می‌خواهد بخرد، همراه با destination_country وقتی برای صادرات خریده می‌شود | کلید با needs:write |
request_quotes | استعلام قیمت از حداکثر ۲۰ شرکت برای یک فرصت باز | کلید با rfqs:send |
کلید API سازمان را در اتصال MCP به شکل Authorization: Bearer brl_api_... بفرستید. ابزارهایی که از طرف سازمان اقدام می‌کنند، کلید را در هر فراخوانی دوباره بررسی می‌کنند، پس ابطال آن بی‌درنگ متوقفشان می‌کند. این ابزارها با اختیارات کسی کار می‌کنند که کلید را صادر کرده است و اگر آن شخص دیگر سازمان را مدیریت نکند، از کار می‌افتند.
متن‌هایی که یک دستیار ثبت می‌کند از قواعد داشبورد پیروی می‌کنند: بدون شمارهٔ تلفن، نشانی ایمیل یا شمارهٔ هویتی (تأمین‌کنندگان از طریق Birlesa به خریدار می‌رسند). نخستین فرصت‌های یک خریدار تازه، پیش از آنکه کسی آن‌ها را ببیند، به دست یک نفر بررسی می‌شوند. محدودیت‌های نرخ همان محدودیت‌های API است.