ربط مساعد ذكاء اصطناعي (MCP)

يدعم سويتي بروتوكول سياق النماذج (MCP)، المعيار المفتوح الذي تستخدمه مساعدات الذكاء الاصطناعي للوصول إلى الأدوات التي يعمل بها الناس. اربط مساعدًا، ويمكنك أن تسأله مثلًا:

• "كيف كان أداء العليا 12 الشهر الماضي مقارنة بأغسطس؟"
• "أي شققي كانت الأقل إشغالًا هذا الربع، ولماذا؟"
• "هل توجد وحدة متاحة من 3 إلى 7 نوفمبر لأربعة ضيوف؟"
• "ماذا يحدث اليوم — من يصل ومن يغادر وأي الشقق ما زالت تحتاج تنظيفًا؟"
• "اكتب مسودة رسالة هذا الشهر لمالك وحدات الملقا."

يجيب المساعد من بياناتك الفعلية في سويتي — الأرقام نفسها التي في صفحتي التحليلات والتقارير — ويوضح متى يكون الرقم ناقصًا (حجوزات روابط التقويم لا تحمل سعرًا مثلًا) بدل أن يخمّن.

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

ما تحتاجه

• مساعد ذكاء اصطناعي يدعم MCP عبر HTTP: Claude Code أو Claude Desktop أو Codex أو Cursor أو VS Code أو ما يشبهها.
• لعضو في فريق المشغّل: صلاحية مساعدو الذكاء الاصطناعي في دورك (المالك يملكها دائمًا).

الربط

1. في سويتي، افتح الإعدادات ← مساعدو الذكاء الاصطناعي.
2. سمِّ الاتصال باسم تعرفه لاحقًا، مثل Claude على حاسوبي.
3. حدّد ما يمكنه قراءته:
   • الأداء والتقارير — الإشغال والإيراد ومتوسط السعر والتقييمات وتقارير التشغيل وكشوف الملاك.
   • الوحدات والتقويم والحجوزات — تفاصيل الوحدات والأسعار والتوفر والحجوزات وزيارات التنظيف والصيانة.
   • بيانات الضيوف — أسماء الضيوف وأرقامهم وبريدهم. غير محدد افتراضيًا: حدّده فقط إذا احتاج المساعد للتعرف على الضيوف.
4. اختر كل الوحدات، أو الوحدات التي تحددها فقط.
5. اختر إنشاء الاتصال وانسخ الرمز. يظهر مرة واحدة فقط.

تعرض الصفحة بعدها عنوان الخادم — https://suitiee.com/mcp — وإعدادًا جاهزًا للمساعدات الشائعة:

Claude Code

claude mcp add --transport http suitiee https://suitiee.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

Codex CLI (~/.codex/config.toml)

[mcp_servers.suitiee]
url = "https://suitiee.com/mcp"
http_headers = { "Authorization" = "Bearer YOUR_TOKEN" }

Cursor وClaude Desktop وغيرها من عملاء MCP

{
  "mcpServers": {
    "suitiee": {
      "url": "https://suitiee.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

الربط من claude.ai أو ChatGPT في المتصفح دون لصق رمز قادم قريبًا.

ما يمكن للمساعد الاطلاع عليه

من يرى ماذا

• يرى المساعد وحدات حسابك فقط — أو الوحدات التي اخترتها فقط.
• لفريق المشغّل، يقرأ الاتصال بصلاحيات منشئه: من لا يستطيع فتح التقارير في اللوحة لا يحصل على أدوات الأداء في مساعده أيضًا. ويحتاج العضو صلاحية مساعدو الذكاء الاصطناعي لربط مساعد أصلًا.
• يرى كل شخص اتصالاته فقط ويفصلها بنفسه. تعطيل عضو في الفريق يوقف كل المساعدين الذين ربطهم.
• كل سؤال يطرحه المساعد يُسجَّل في سجل التدقيق.
• يدوم الاتصال 90 يومًا. اربط من جديد لتجديده.

حين يحدث خطأ

• "غير مرتبط" أو 401 — الرمز مفقود أو خاطئ أو منتهٍ (بعد 90 يومًا) أو مفصول. أنشئ اتصالًا جديدًا والصق الرمز الجديد.
• 403، "لم يعد يستطيع تسجيل الدخول" — الحساب المرتبط عُطّل أو عُلّق. يعود الاتصال عند تفعيل الحساب.
• يقول المساعد إنه لا يملك أداة لأمر ما — لم يُمنح الاتصال هذه الصلاحية، أو دورك لا يشملها. أعد الربط مع تحديد الخيارات الصحيحة، أو اطلب ذلك من مالك الحساب.
• رقم الإيراد يبدو منخفضًا — راجع bookings_with_price: حجوزات روابط التقويم (iCal ومنها جاذر إن) لا تحمل سعرًا، فتُحتسب لياليها دون إيرادها.
• 429، طلبات كثيرة — المساعد يسأل أسرع من 120 سؤالًا في الدقيقة. يمكنه المحاولة بعد دقيقة.

الفصل

الإعدادات ← مساعدو الذكاء الاصطناعي ← فصل. يتوقف المساعد عن العمل في طلبه التالي. إن احتمل أن الرمز انكشف، فافصله وأنشئ اتصالًا جديدًا.

بياناتك

عند ربط مساعد، تُرسل إجابات أسئلته إلى مزوّد ذلك المساعد (Anthropic أو OpenAI أو من يشغّله) بموجب اتفاقك معه. لا يرسل سويتي إلا ما يطلبه المساعد ضمن الصلاحيات التي حددتها. ولا تُرسل بيانات تواصل الضيوف أبدًا إلا إذا حددت بيانات الضيوف.