ربط تطبيقات الذكاء الاصطناعي (MCP)

يتيح MonoChat MCP Server لتطبيق ذكاء اصطناعي يدعم بروتوكول سياق النموذج (MCP)، مثل Claude Code أو Cursor، العمل مع حسابك في MonoChat. يطلب تطبيق الذكاء الاصطناعي البيانات من MonoChat عبر مجموعة أدوات ثابتة، ولا يرى إلا ما تراه أنت.

يتوفر MonoChat MCP Server في جميع الباقات، دون حدود حسب الباقة.

الاتصال يعمل باسمك

يعمل تطبيق الذكاء الاصطناعي المتصل بمفتاح الوصول الخاص بك باسم مستخدمك. يصل إلى مساحات العمل (tenants) التي يمكنك الوصول إليها فقط ولا شيء غيرها. ألغِ الاتصالات التي لم تعد تستخدمها.

ما الذي يستطيع تطبيق الذكاء الاصطناعي فعله

هذه الأدوات متاحة لكل اتصال:

الأداة	ما تفعله
list_tenants	تعرض مساحات العمل (tenants) التي يمكن للاتصال الوصول إليها.
list_sessions	تعرض جلسات المحادثة لمساحة عمل، الأحدث أولًا، ويمكن حصرها في الجلسات opened أو assigned أو closed.
get_session	تعيد جلسة محادثة واحدة.
list_messages	تعرض رسائل جلسة، الأحدث أولًا.
search_customers	تبحث في عملاء مساحة عمل بكلمة مفتاحية.
list_message_templates	تعرض قوالب الرسائل لقناة واحدة من مساحة عمل.

نص الرسائل يأتي من العملاء والموظفين. هو بيانات يقرأها تطبيق الذكاء الاصطناعي وليس تعليمات.

لكل اتصال نطاق: للقراءة فقط أو القراءة والكتابة. الاتصال للقراءة فقط لا يرى أبدًا الأدوات التي تغيّر البيانات. جميع الأدوات المذكورة أعلاه للقراءة فقط.

إنشاء اتصال

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

1. افتح إعدادات الملف الشخصي واختر تبويب اتصالات MCP ثم انقر إنشاء.
2. أدخل اسمًا واختر النطاق (للقراءة فقط افتراضيًا) وفترة الصلاحية بالأيام (90 افتراضيًا و365 كحد أقصى).
3. أدخل رمز التأكيد المكوّن من 6 أرقام من طريقة التحقق بخطوتين. إذا كنت تستخدم التحقق عبر البريد الإلكتروني فانقر إرسال رمز التأكيد أولًا.
4. انسخ مفتاح الوصول. يظهر مرة واحدة فقط، ويبدأ بـ mcp_sk_.

يمكنك امتلاك 10 اتصالات نشطة كحد أقصى.

ربط تطبيق ذكاء اصطناعي

الخادم على العنوان https://app.monochat.ai/api/mcp-server (استخدم عنوان MonoChat الخاص بك إذا كنت تشغّل MonoChat على خوادمك) ويتوقع مفتاح الوصول كرمز Bearer في ترويسة Authorization.

Claude Code

claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
  --header "Authorization: Bearer <access key>"

Cursor

أضف الخادم إلى الملف ~/.cursor/mcp.json:

{
  "mcpServers": {
    "monochat": {
      "url": "https://app.monochat.ai/api/mcp-server",
      "headers": { "Authorization": "Bearer <access key>" }
    }
  }
}

أي عميل MCP آخر يدعم نقل HTTP المتدفق (streamable HTTP) والترويسات المخصصة يتصل بالطريقة نفسها.

الحدود

تُحتسب الاستدعاءات في الدقيقة: 60 لكل اتصال و300 لكل حساب و600 لكل مساحة عمل (tenant)، و4 استدعاءات كحد أقصى في الوقت نفسه لكل اتصال. بعض الأدوات تُحتسب كأكثر من استدعاء واحد. عند بلوغ أحد الحدود يردّ الخادم بالحالة 429 وترويسة Retry-After؛ وعلى تطبيق الذكاء الاصطناعي الانتظار هذا العدد من الثواني.

إلغاء اتصال

يعرض كل اتصال في تبويب اتصالات MCP حالته ونطاقه وانتهاء صلاحيته وآخر استخدام. انقر إلغاء لقطع وصول تطبيق الذكاء الاصطناعي فورًا. الاتصال الملغى أو المنتهي لا يمكن استخدامه مجددًا؛ أنشئ اتصالًا جديدًا بدلًا منه.

إدارة وصول MCP للمؤسسة

يدير المستخدمون الذين يمكنهم تغيير إعدادات المؤسسة وصول MCP الخاص بها من الإعدادات › المؤسسة › خادم MCP.

• إيقاف وصول MCP لهذه المؤسسة: فعّله وانقر على حفظ لرفض كل استدعاء MCP لهذه المؤسسة، من كل اتصال لكل مستخدم. لن تظهر المؤسسة بعد ذلك في list_tenants. أوقفه واحفظ للسماح بوصول MCP من جديد.
• استدعاءات MCP: كل استدعاء لأداة تحدد هذه المؤسسة، من الأحدث إلى الأقدم، بما في ذلك الاستدعاءات المرفوضة. يعرض كل صف المستخدم والاتصال والأداة والحالة (تم بنجاح أو فشل) وعنوان IP والوقت. لا تُعرض الاستدعاءات من المستخدمين الذين ليسوا أعضاء في هذه المؤسسة.