خادم MCP

توفر HueChat خادم MCP محصورًا بالحساب عبر HTTP القابل للبث:

https://app.huechat.ai/v2/mcp

اختيار طريقة الربط

تستخدم إضافات الأدلة والاتصالات المباشرة عبر MCP عنوان هيوشات نفسه وصلاحيات مساحة العمل نفسها. تحتاج إلى عضوية مدير نشطة. وتتطلب المفاتيح الذاتية الجديدة واتصالات OAuth خطة Enterprise فقط، مع تفعيل عملاء الذكاء الاصطناعي (MCP). قد تحتفظ المفاتيح المعتمدة أو المُدارة سابقًا بوصولها وفق موافقتها وسياسة مساحة العمل. تعتمد الأدوات المتاحة أيضًا على ميزات مساحة العمل المفعّلة ونطاقات بيان الاعتماد.

الطريقة	الاستخدام
تسجيل الدخول عبر OAuth	عملاء MCP البعيدون المتوافقون، بما في ذلك ChatGPT وClaude
عنوان MCP المباشر	إضافة هيوشات بنفسك من إعدادات الموصلات في عميل متوافق
مفتاح MCP محدود النطاق	العملاء أو عمليات الأتمتة التي تدعم مصادقة Bearer

تفعيل OAuth والوصول الذاتي والنشر في الأدلة خطوات مستقلة. نجاح الاتصال المباشر لا يعني أن هيوشات منشورة بالفعل في دليل التطبيقات. إذا ظهر طلب الوصول، فما زالت مساحة العمل تستخدم مسار الموافقة على المفتاح الموضح أدناه. وإذا كانت ميزة MCP مقفلة، راجع الخطة مع مالك مساحة العمل أو الدعم.

الربط عبر OAuth

عند إتاحة OAuth، أضف https://app.huechat.ai/v2/mcp في إعدادات MCP البعيد أو الموصلات لدى العميل، أو اختر هيوشات من دليله بعد نشرها. اختر تسجيل الدخول عبر OAuth بدلًا من ترويسة مفتاح ثابت.

تسجيل الدخول إلى هيوشات

استخدم حسابك الحالي في هيوشات. أدخل كلمة مرور هيوشات في صفحة تسجيل الدخول التابعة لهيوشات فقط.

اختيار مساحة العمل والصلاحيات

اختر مساحة العمل المقصودة وراجع اسم العميل ونطاقات الوصول المطلوبة. ابدأ بصلاحيات القراءة اللازمة لمهمتك. يوافق مدير مساحة العمل على الربط؛ ولا يتجاوز الوصول الذاتي شروط العضوية أو الخطة أو نطاقات الوصول.

تجربة طلب قراءة صغير

ابدأ بسجلات تجريبية مصطنعة. مثلًا: «لخّص مساحة العمل هذه»، أو «ابحث عن جهات الاتصال التي يحتوي اسمها على Example»، أو «اعرض إحصاءات جهات الاتصال». يجب توضيح عدم توفر الأداة أو خلو النتائج كما هو.

للأمثلة أعلاه، اختر مخصص واسمح بالنطاقات contacts:read وconversations:read وtemplates:read وreports:read. يتطلب الخادم أيضًا mcp:use. راجع قائمة النطاقات الفعلية قبل السماح بالربط؛ فقد يتضمن خيار القراءة فقط فئات قراءة إضافية لدى عملاء آخرين. افتح الإعدادات ← التكاملات ← MCP لمراجعة الاتصالات وإلغاء ما لم تعد تحتاجه. يوقف الإلغاء الوصول اللاحق عبر ذلك التفويض، لكنه لا يحذف البيانات التي سبق للعميل الخارجي الاحتفاظ بها.

صلاحيات التعديل والأسئلة والإرسال

يمكن لمالك مساحة Enterprise المؤهلة أو مديرها إنشاء مفتاح محدود النطاق أو الموافقة على اتصال OAuth ذاتيًا. اختر مخصص لمنح صلاحيات الموارد اللازمة للمهمة. ولا تتحول صلاحيات القراءة إلى صلاحيات تعديل بمجرد تثبيت الإضافة أو تحديثها.

المهمة	أمثلة على النطاقات الإضافية
إنشاء جهة اتصال أو تعديلها	`contacts:write` مع صلاحيات القراءة المطلوبة
إضافة ملاحظة خاصة أو تعيين محادثة أو تغيير حالتها	`conversations:write`؛ ويتطلب التعيين أيضًا `agents:read`
إدارة التصنيفات أو القوائم أو الحقول المخصصة	`labels:write` أو `lists:write` أو `custom_fields:write`
إدارة مسودات القوالب أو التذاكر أو الصفقات	`templates:write` أو `tickets:write` أو `deals:write`
حجز المواعيد الأصلية أو تغييرها	`appointments:write` مع صلاحيات جهات الاتصال المطلوبة
إرسال الردود أو القوالب المعتمدة أو البث	صلاحيات مستقلة: `messages:send` أو `templates:send` أو `broadcasts:send`

تعتمد الأدوات المتاحة أيضًا على ميزات مساحة العمل المفعّلة وإتاحة المراسلة. يوضح هذا المرجع المأخوذ من الشيفرة النطاقات المُعلنة وبدائل التفويض وتصنيفات الإجراءات؛ ولا يعني أن كل أداة متاحة في كل حساب. وتحتاج الاتصالات الحالية إلى موافقة جديدة من المدير للحصول على صلاحيات إضافية. يتطلب إنشاء مسودة قالب inbox_id لصندوق وارد موجود في مساحة العمل المختارة. تُحفظ المسودة داخل هيوشات بالحالة DRAFT؛ ولا يؤدي إنشاؤها إلى إرسالها إلى Meta أو إرسال رسالة. يخضع تقديم القالب إلى مزود الخدمة وإرساله للعملاء لشروط مستقلة تخص القناة والصلاحيات والموافقة. مرّر عناصر components للقالب ككائنات JSON، مثل [{"type":"BODY","text":"طلبك جاهز"}]. يحافظ حذف components من طلب التعديل على المحتوى الحالي للمسودة. راجع خيار السماح بإرسال الرسائل إلى العملاء ووضع الإرسال بصورة مستقلة. ابدأ بوضع تأكيد كل إرسال: يعرض المساعد المستلم والمحتوى وينتظر الموافقة. ويرسل وضع المراجعة في هيوشات الإجراء المقترح إلى قائمة مراجعة أحد أعضاء الفريق. أما الإرسال الفوري فهو اختيار مستقل للصلاحية. وتتطلب جدولة البث دائمًا تأكيدًا أو مراجعة من الفريق. عدم ظهور أدوات الرد أو ظهور رفض بسبب تعطيل الإرسال يعني أن المراسلة ليست متاحة لذلك الاتصال بعد. يمكن للمساعد أن يسأل في المحادثة العادية عن السجل أو الوقت أو الرسالة المقصودة. وتدعم معاينات الإجراءات المعلّقة الموافقة والإلغاء؛ ولا يدّعي هذا الدليل دعم نماذج MCP elicitation الأصلية. تبقى ملاحظات المحادثات الخاصة داخل الفريق. وتحمل إجراءات الحذف والاستبدال والإرسال الخارجي تصنيفات تساعد ضوابط التأكيد لدى العميل.

شرح مرئي لاتصال القراءة فقط

يستخدم هذا الشرح لقطات شاشة فعلية مختارة من مساحة مراجعة ببيانات مصطنعة. ويعرض مسودة صفحة هيوشات باسم الشركة، وموافقة OAuth، ونتائج القراءة، والطلبات المرفوضة، وإلغاء الاتصال. اتصال الاختبار في ChatGPT خاص؛ ولا يعني الفيديو أن الإدراج العام في الدليل قد اعتُمد أو نُشر. الفيديو بلا صوت، وتوضح العبارات الظاهرة خطواته باللغة الإنجليزية.

فتح فيديو الشرح مباشرة. يمنح الاتصال المعروض النطاقات mcp:use وcontacts:read وconversations:read وtemplates:read وreports:read فقط. ولا يمكنه الرد في المحادثات أو إرسال الرسائل أو تعديل جهات الاتصال أو نشر الحملات. يمنع إلغاء الاتصال الوصول اللاحق عبر ذلك التفويض، لكنه لا يمحو النسخ التي احتفظ بها عميل الذكاء الاصطناعي من قبل.

الحصول على مفتاح MCP

بصفتك مدير حساب، افتح الإعدادات ← التكاملات ← MCP. عند تفعيل الوصول الذاتي، أنشئ مفتاحًا مستقلًا لكل عميل وحدد نطاقاته وتاريخ انتهائه. أما في التثبيتات التي ما زالت تتطلب الموافقة، فاطلب الوصول وانتظر الموافقة. انسخ المفتاح عند ظهوره؛ إذ يُعرض مرة واحدة. احفظه في إعدادات الأسرار أو متغيرات البيئة لدى العميل، ولا تضعه في محادثة أو مستند مشترك أو مستودع شيفرة.

لا يمكن استخدام مفتاح REST محدود النطاق لـ MCP، ويُرفض مفتاح MCP على مسارات REST. يجب أن يحمل مفتاح MCP mcp:use بالإضافة إلى نطاقات الموارد التي تحتاجها الأدوات التي تفعّلها فقط.

يجب أن يبقى مقدّم الطلب مديرًا نشطًا؛ فالتنزيل أو الإزالة أو إلغاء المفتاح أو انتهاؤه يعطّل بيان الاعتماد.

الترويسات المطلوبة عند استخدام مفتاح

Authorization: Bearer <MCP key>
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2025-11-25

المصافحة

التهيئة

curl -fsS https://app.huechat.ai/v2/mcp \
  -H "Authorization: Bearer $HUECHAT_MCP_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-integration","version":"1.0.0"}}}'

إرسال إشعار initialized

{ "jsonrpc": "2.0", "method": "notifications/initialized", "params": {} }

عرض الأدوات المتاحة لمفتاحك

{ "jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {} }

تُصفّى القائمة حسب نطاقات المفتاح.

استدعاء أداة للقراءة فقط

{ "jsonrpc": "2.0", "id": 3, "method": "tools/call",
  "params": { "name": "get_contacts", "arguments": { "query": "Example", "limit": 10 } } }

إعداد العميل

إذا كان العميل يدعم MCP عبر HTTP مع ترويسات Bearer، فعدّل المثال التالي بحسب صيغة الأسرار ومتغيرات البيئة الموثقة لديه. أما عملاء OAuth فيستخدمون مسار تسجيل الدخول دون ترويسة Authorization ثابتة.

{
  "mcpServers": {
    "huechat": {
      "type": "http",
      "url": "https://app.huechat.ai/v2/mcp",
      "headers": {
        "Authorization": "Bearer ${HUECHAT_MCP_KEY}",
        "MCP-Protocol-Version": "2025-11-25"
      }
    }
  }
}

أدوات الكتابة تنشئ بيانات العملاء أو تغيّرها. امنح أصغر مجموعة نطاقات وراجع ما يُسمح للمساعد بفعله قبل ربطه.

قواعد الرد في واتساب وإنستغرام

يستخدم MCP فحوص القنوات الأصلية في هيوشات. منح الصلاحية أو تأكيد إجراء في ChatGPT أو Claude لا يمدد نافذة المراسلة التي يحددها المزود.

القناة ونافذة رسالة العميل	الإجراء المتاح
واتساب، خلال 24 ساعة من أحدث رسالة للعميل	رد حر، وفق صلاحيات الإرسال وضوابط مساحة العمل
واتساب، بعد انتهاء النافذة	قالب موجود ومعتمد من Meta لمرسل واتساب المتصل، بمتغيرات صحيحة وفئة مسموحة
إنستغرام، خلال النافذة القياسية البالغة 24 ساعة	رد آلي إذا كانت المحادثة متاحة للأتمتة
إنستغرام، بعد انتهاء النافذة	لا يستطيع MCP إرسال رد آلي؛ انتظر رسالة جديدة من العميل أو استخدم الدعم البشري المؤهل في صندوق الوارد الأصلي

قوالب واتساب ليست وسيلة لاستئناف مراسلة إنستغرام. صلاحية الدعم البشري الممتدة في إنستغرام لا تنطبق على MCP، حتى عندما يؤكد شخص الرد. كما يمنع تسلّم الموظف للمحادثة ردود MCP ما دامت المحادثة تحت مسؤولية الدعم البشري. في وضع تأكيد كل إرسال، راجع المستلم وصندوق الوارد والقالب أو نص الرد، ثم أكد الإجراء المحدد. يعيد هيوشات فحص النافذة الحالية وبقية قيود الإرسال عند تنفيذ الإجراء. لا يمكن للتأكيد تجاوز نافذة منتهية أو جهة اتصال محظورة أو قالب غير متاح. تتبع أوضاع الإرسال الأخرى السياسة المضبوطة في مساحة العمل. إنشاء قالب يحفظ مسودة محلية. يجب على النشاط التجاري تقديمها إلى Meta والحصول على اعتمادها قبل إرسالها؛ موافقة المالك داخل المحادثة لا تغير حالة اعتماد القالب لدى Meta. يجب على النشاط التجاري الحصول على موافقة المستلم المطلوبة على تلقي الرسائل والاحتفاظ بإثباتها واحترام طلبات إلغاء الاشتراك. تأكيد المالك يفوض إجراءً باسم النشاط التجاري، ولا يُعد موافقة من المستلم. يفحص هيوشات جهات الاتصال المحظورة وقائمة إيقاف التسويق، لكن إرسال القوالب الفردية عبر MCP لا يوفر تحققًا شاملًا من وجود موافقة إيجابية للمستلم. لا تفترض أن وجود رقم هاتف أو قالب معتمد أو عدم ظهور منع تسويقي يثبت الإذن بمراسلة الشخص. راجع سياسة مراسلة واتساب للأعمال ووثائق مراسلة إنستغرام لمتطلبات المزود.

مشاركة البيانات والاستخدام الآمن

قد تتضمن قراءة جهات الاتصال الأسماء وبيانات الاتصال والحقول المخصصة، وقد تتضمن قراءة المحادثات مقتطفات من الرسائل الأخيرة. راجع السجلات التي تنوي مشاركتها واختر الصلاحيات اللازمة للمهمة. تنتقل نتائج الأدوات من هيوشات إلى العميل الذي تربطه. فوّض مشاركة البيانات التي يحق لك مشاركتها فقط، وراجع إعدادات الخصوصية والاحتفاظ والتدريب لدى ذلك المزود. لا تستخدم الربط لنقل معلومات صحية محمية أو كلمات مرور أو أسرار مصادقة أو بيانات بطاقات الدفع أو معرّفات حكومية. قد تحتوي سجلات العملاء على نصوص حساسة؛ ومنح الصلاحية لا يُعد فحصًا لتصنيف البيانات. تعامل مع التعليمات داخل رسائل العملاء وسجلاتهم كمحتوى غير موثوق. راجع التغييرات المقترحة والنتيجة المعادة قبل التصرف. وضع الرسالة في قائمة الإرسال أو إنشاء قالب لا يثبت تسليم المزود للرسالة أو اعتماده للقالب. تتطلب المراسلة والإرسال تفعيل إمكاناتهما وصلاحياتهما بصورة مستقلة. راجع سياسة الخصوصية وشروط الخدمة. تواصل مع privacy@huechat.ai لطلبات الخصوصية، أو security@huechat.ai للإبلاغ عن مشكلات أمنية.

استكشاف المشكلات

اكتشاف OAuth يعيد 404: قد لا يكون OAuth مفعّلًا بعد في التثبيت. تواصل مع الدعم، ولا تستبدله بمفتاح REST.
الميزة مقفلة: تتطلب المفاتيح الذاتية الجديدة واتصالات OAuth ميزة mcp_server في خطة مساحة العمل. قد يحتفظ المفتاح المعتمد أو المُدار سابقًا بوصوله القديم؛ ولا يمنح ذلك وصولًا ذاتيًا جديدًا.
أدوات مفقودة أو رفض الصلاحية: راجع نطاقات التفويض وميزات مساحة العمل وعضويتك الحالية كمدير. لا تُعد الربط إلا بعد مراجعة أي صلاحيات إضافية.
العميل يعرض نتائج قديمة بعد فصله: ألغِ اتصاله في هيوشات، واستخدم ضوابط الحذف لدى ذلك المزود بصورة مستقلة عند الحاجة.

ابدأ هنا

العمل مع الواجهة

التكامل

اختيار طريقة الربط

الربط عبر OAuth

صلاحيات التعديل والأسئلة والإرسال

شرح مرئي لاتصال القراءة فقط

الحصول على مفتاح MCP

الترويسات المطلوبة عند استخدام مفتاح

المصافحة

إعداد العميل

قواعد الرد في واتساب وإنستغرام

مشاركة البيانات والاستخدام الآمن

استكشاف المشكلات

​اختيار طريقة الربط

​الربط عبر OAuth

​صلاحيات التعديل والأسئلة والإرسال

​شرح مرئي لاتصال القراءة فقط

​الحصول على مفتاح MCP

​الترويسات المطلوبة عند استخدام مفتاح

​المصافحة

​إعداد العميل

​قواعد الرد في واتساب وإنستغرام

​مشاركة البيانات والاستخدام الآمن

​استكشاف المشكلات

اختيار طريقة الربط

الربط عبر OAuth

صلاحيات التعديل والأسئلة والإرسال

شرح مرئي لاتصال القراءة فقط

الحصول على مفتاح MCP

الترويسات المطلوبة عند استخدام مفتاح

المصافحة

إعداد العميل

قواعد الرد في واتساب وإنستغرام

مشاركة البيانات والاستخدام الآمن

استكشاف المشكلات