خادم MCP
اربط عميل ذكاء اصطناعي بمساحة عمل عبر Model Context Protocol بصلاحيات الشخص نفسه.
POST https://<workspace>.zmle.com/api/mcp
نقطة النهاية
POST https://<workspace>.zmle.com/api/mcp: Streamable HTTP وJSON-RPC 2.0، إصدارات البروتوكول 2025-11-25, 2025-06-18, 2025-03-26. الخادم بلا حالة ومتوقف حتى تفعّله مساحة العمل.
OAuth 2.1 مع PKCE وتسجيل العملاء الديناميكي، يُكتشف من /.well-known/oauth-protected-resource. كل اتصال يعمل كشخص واحد بصلاحياته وفروعه. النطاق mcp:read للقراءة؛ وmcp:write لإنشاء المسودات فقط.
أدوات القراءة
sales_summarybusiness_metriclist_recordsreceivablespayablesprofit_and_losscash_positiontax_summarystock_statusemployee_summarypayroll_summaryteam_todaytill_sessionspurchases_summarycustomer_summarystays_summaryrentals_summaryforecastsearch_recordsget_recordأدوات المسودات (تحتاج نطاق الكتابة وإذن مساحة العمل)
create_draft_quotationcreate_draft_invoicecreate_taskالحدود: 60 استدعاء لكل اتصال في الدقيقة، و3000 لكل مساحة عمل في الساعة، و30 مسودة في الساعة، و64 كيلوبايت لكل طلب.
ربط عميل
- يشغّل مسؤول اتصالات الذكاء الاصطناعي من الإدارة ← التكاملات والواجهة البرمجية ← اتصالات الذكاء الاصطناعي (MCP)
- في عميل الذكاء الاصطناعي أضف موصّل MCP مخصصًا بالعنوان https://<workspace>.zmle.com/api/mcp
- يفتح العميل صفحة تسجيل الدخول لمساحة العمل: سجّل الدخول واسمح بالاتصال
- العملاء الذين لا يدعمون OAuth يمكنهم استخدام رمز شخصي يُنشأ من الصفحة نفسها ويُرسل في ترويسة Bearer
إنهاء اتصال
في صفحة اتصالات الذكاء الاصطناعي يوقف «إنهاء الاتصال» العميل فورًا. وإيقاف اتصالات الذكاء الاصطناعي يرفض كل استدعاء في الحال.
التالي: مفاتيح API والنطاقات
ما يمكن للمفتاح قراءته وكتابته، والحدود التي يحملها من الشخص الذي أنشأه.