تحتاج برامج الذكاء الاصطناعي إلى أدوات، وليس مجرد دردشة
تستطيع أنظمة الذكاء الاصطناعي تصنيف الطلبات، وصياغة الردود، وتلخيص المحادثات، واختيار الخطوة التالية في سير العمل. ولتنفيذ هذه الخطوة، تحتاج هذه الأنظمة إلى الوصول إلى أدوات العمل. كما يحتاج النظام القادر على صياغة الرد إلى أداة مراسلة لإيصاله.
بالنسبة للعديد من الشركات، يُعدّ واتساب قناة التواصل الرئيسية. تستخدمه فرق المبيعات لمتابعة العملاء المحتملين، وفرق الدعم للرد على استفسارات العملاء، وفرق العمليات لإرسال إشعارات المواعيد والتسليم والدفع وحالة الطلبات. وتزداد قيمة الذكاء الاصطناعي عندما يتمكن الموظف من الانتقال من مجرد الاقتراح إلى التنفيذ المُتحكّم به: إرسال رسالة نصية، إنشاء أو عرض نموذج، طلب معلومات الفوترة، التحقق من الرسائل الفاشلة، تصدير البيانات، أو تهيئة نقاط نهاية سير العمل.
تم تصميم خادم ChatArchitect Cloud MCP خصيصًا لهذه الطبقة. فهو يمنح عملاء الذكاء الاصطناعي طريقة مُتحكَّم بها لاستدعاء إجراءات واجهة برمجة تطبيقات ChatArchitect WhatsApp المُختارة من خلال بروتوكول سياق النموذج، دون الحاجة إلى مطالبة كل عميل بإنشاء وصيانة تكامل خلفي مُخصَّص.
ما هو MCP بكلمات بسيطة؟
بروتوكول سياق النموذج (MCP) هو معيار قياسي لربط تطبيقات الذكاء الاصطناعي بالأدوات الخارجية. في بيئة MCP، يعمل تطبيق الذكاء الاصطناعي كعميل. يوفر خادم MCP مجموعة من الإجراءات المتاحة، ومخططات الإدخال الخاصة بها، وتنسيقات الإخراج. يستطيع عميل الذكاء الاصطناعي اكتشاف هذه الإجراءات واستدعائها عندما يُسند المستخدم مهمة تتطلب تنفيذًا فعليًا.
يمكن اعتبار MCP بمثابة وسيط قياسي بين وكيل الذكاء الاصطناعي ونظام الأعمال. يعتمد الأمان على مصادقة الخادم والتحقق من صحة البيانات، وصلاحيات العميل، وكيفية إدارة الاتصال. لا يحتاج الوكيل إلى معرفة تفاصيل واجهة برمجة التطبيقات الداخلية لكل خدمة، إذ يرى قائمة ثابتة من الأدوات بأسماء ومعلمات واضحة. يتولى الخادم المصادقة والتحقق من صحة البيانات، واستدعاءات واجهة برمجة التطبيقات، وتوحيد الاستجابات، وتحديد الأخطاء.
يُعدّ هذا الفصل مهمًا. فهو يعني أن بإمكان عميل الذكاء الاصطناعي العمل مع وظيفة تجارية، مثل إرسال رسالة نصية عبر واتساب، بدلًا من تعلّم واجهة برمجة تطبيقات ChatArchitect الخام بالكامل. كما يعني أيضًا أن بإمكان الشركة إبقاء الأسرار والمعلمات الداخلية وقواعد التشغيل بعيدة عن وسائط الأداة المُوجّهة للنموذج.
ما هو خادم ChatArchitect Cloud MCP؟
خادم ChatArchitect Cloud MCP هو واجهة MCP عامة عن بُعد لواجهة برمجة تطبيقات ChatArchitect WhatsApp. تم تنفيذه كخدمة Node.js وTypeScript باستخدام Express، وcreateMcpExpressApp() من @modelcontextprotocol/express، و NodeStreamableHTTPServerTransport من @modelcontextprotocol/node.
يُتيح الخادم نقطة دخول واحدة عامة لنقل بيانات MCP: POST /mcp. تتصل عملاء الذكاء الاصطناعي بهذه النقطة، وتُصادق باستخدام رمز Bearer، وتكتشف الأدوات المدعومة، وتُفعّل الإجراءات المُفعّلة في إعدادات العميل. يُتيح رمز الحساب الصحيح الوصول إلى واجهة أدوات الخادم؛ ويجب ضبط قيود كل أداة وسياسات الموافقة في عميل الذكاء الاصطناعي.
هذه واجهة v1 مُركّزة، وليست نسخة طبق الأصل من جميع إمكانيات واجهة برمجة تطبيقات ChatArchitect. يُبقي التطبيق الحالي واجهة الأدوات العامة محدودة عمدًا. فهو يُتيح 10 أدوات MCP لمراسلة واتساب، وروابط الدفع، والإشعارات، والقوالب، والتصدير، والرسائل الفاشلة، وخطافات الويب، والفواتير. ولا يُتيح مطالبات أو موارد MCP. كما أنه لا يستقبل ردود استدعاءات تسليم خطافات الويب. ولا يدعم SSE على طلب GET /mcp؛ في الإصدار v1، كان طلبا GET /mcp و DELETE /mcp يُرجعان عمدًا الخطأ 405 (الطريقة غير مسموحة).
تتمثل الفائدة الرئيسية للعملاء في أمر بسيط: يمكنهم ربط وكيل الذكاء الاصطناعي بـ WhatsApp و ChatArchitect دون تصميم خادم MCP الخاص بهم، وواجهة OAuth، والتحقق من صحة الرمز المميز، ومعالجة سياق الطلب، وعميل المصدر، ومخططات الأدوات، وتطبيع الاستجابة من الصفر.
لماذا تُعدّ خدمة إدارة المحتوى السحابية مفيدة للعملاء؟
يوفر خادم ChatArchitect Cloud MCP طبقة تكامل جاهزة. يقوم العملاء بربط أدوات الذكاء الاصطناعي الخاصة بهم بنقطة نهاية سحابية، ويمنحون صلاحية الوصول، ويبدأون بمجموعة مستقرة من إجراءات WhatsApp وChatArchitect. تتم إدارة التحديثات، وعمليات الربط الداخلية، والتحقق من صحة الطلبات، ونقل MCP في مكان واحد.
يمكن للفريق البدء برد واحد للدعم أو إشعار داخلي، ثم التوسع إلى سير عمل يشمل إدارة علاقات العملاء، ونظام الدعم الفني، ومنصة n8n، وواجهة برمجة تطبيقات OpenAI Responses، وChatGPT، وأدوات تطوير الذكاء الاصطناعي، وأنظمة خلفية مخصصة. يجب التحقق من سلوك كل عميل فيما يتعلق بالنقل والمصادقة والموافقة قبل إطلاق النظام.
ما الذي يمكن للعملاء فعله به؟
بالنسبة لفرق المبيعات، يُمكن لـ ChatArchitect MCP مساعدة وكيل الذكاء الاصطناعي في الرد على استفسارات واتساب، وإعداد العروض، أو إخطار المدير عند الحاجة المُلحة لحالة عميل مُحتمل. لا يُتيح نموذج الموقع الإلكتروني وحده الوصول إلى خدمة عملاء واتساب، إذ يتطلب التواصل الذي تبدأه الشركات خارج نطاق الـ ٢٤ ساعة نموذج رسالة مُعتمد.
بالنسبة لدعم العملاء، يمكن للاتصال تأكيد استلام الطلب، وإرسال تحديث للحالة ضمن نافذة خدمة العملاء المفتوحة، أو تسليم السياق إلى سير عمل آخر.
بالنسبة للعمليات، يمكن للأدوات ربط عمليات التحقق من الفواتير، والتصدير، والإشعارات الداخلية، والردود على واتساب بسير عمل إدارة علاقات العملاء. أداة إرسال واتساب الحالية مخصصة للنصوص فقط. لا يوفر إنشاء القوالب أو عرضها أداة لإرسال رسائل القوالب؛ استخدم مسار ChatArchitect المدعوم بشكل منفصل عند الحاجة إلى قالب.
بالنسبة للمطورين وفرق الأتمتة، تكمن القيمة في وجود حدود بروتوكول مستقرة. فبدلاً من منح كل سير عمل للذكاء الاصطناعي وصولاً مباشراً إلى بيانات اعتماد واجهة برمجة التطبيقات الخام ونقاط نهاية ChatArchitect الخام، يمكن للمطورين ربط طبقة الذكاء الاصطناعي بخادم MCP مُدار. يقوم الخادم بالتحقق من صحة المدخلات باستخدام مخططات Zod، وإضافة معلمات داخلية من المصدر، وتحويل استجابات ChatArchitect إلى محتوى منظم، وإرجاع أخطاء متوقعة.
كيف يعمل؟
وكيل الذكاء الاصطناعي / ChatGPT / واجهة برمجة تطبيقات استجابات OpenAI / n8n / VSCode / واجهة خلفية مخصصة | خادم ChatArchitect السحابي MCP | واجهة برمجة تطبيقات WhatsApp ومنطق الأعمال لـ ChatArchitect | عميل على WhatsApp
العملية بسيطة ومباشرة:
- يتلقى وكيل الذكاء الاصطناعي مهمة، مثل إرسال متابعة إلى عميل محتمل جديد.
- يكتشف عميل الذكاء الاصطناعي الأدوات المتاحة من خادم ChatArchitect MCP.
- يقوم العميل باستدعاء أداة من خلال
POST /mcpمعAuthorization: Bearer <token>. - يقوم خادم MCP بالتحقق من صحة الرمز المميز واستخراج بيانات اعتماد حساب ChatArchitect من نص الرمز المميز المشفر.
- يقوم الخادم بالتحقق من صحة وسيطات الأداة ويستدعي نقطة النهاية المطلوبة في ChatArchitect.
- يتم تحويل الاستجابة إلى
محتوى منظم. - تعود النتيجة إلى عميل الذكاء الاصطناعي أو سير العمل الآلي.
لا يتلقى عميل الذكاء الاصطناعي معرف التطبيق أو السر كمعلمات للأداة. تتم معالجة بيانات الاعتماد هذه في طبقة التخويل، وليس في المطالبات أو المخططات التي تواجه النموذج.
نموذج الترخيص والأمان
تقبل نقطة نهاية MCP العامة مصادقة Bearer فقط على مستوى طلب MCP. عقد الرمز المميز متداخل: يحتوي JWE خارجي مضغوط على JWT داخلي موقّع. يتم تشفير رمز الوصول باستخدام dir و A256GCM، بينما يتم توقيع JWT الداخلي باستخدام HS256.
يجب أن يحتوي الرمز المميز على البيانات المطلوبة التي يستخدمها الخادم: sub=chatarchitect-sessionو app_idو secretو expو issو aud. يجب أن يتطابق المُصدر مع PUBLIC_BASE_URL، ويجب أن يتطابق الجمهور مع ${PUBLIC_BASE_URL}/mcp. النطاق الثابت الاختياري هو mcp.
يُبقي هذا التصميم بيانات اعتماد ChatArchitect بعيدة عن مدخلات الأدوات الموجهة للنموذج واستجابات الأدوات العادية. تُزوّد طبقة التخويل هذه البيانات للخادم، الذي يستخدم مصادقة Basic الداخلية عند استدعاء واجهة برمجة تطبيقات ChatArchitect. تبقى بيانات الاعتماد حساسة: أدخلها فقط في صفحة التخويل الموثوقة، وتجنّب استخدام الرموز المميزة في المطالبات وملفات التكوين المشتركة ولقطات الشاشة.
يتضمن التنفيذ أيضًا مهلات الطلبات، ومهلات المصدر، وحدود حجم الجسم، وحماية رأس المضيف من خلال createMcpExpressApp() و ALLOWED_HOSTS، ومعرفات التطبيقات المقنّعة في مسجلات الأطفال، ومساعدات التنقيح للقيم الحساسة.
لضمان التحكم من جانب العميل، يمكن وضع أدوات الكتابة خلف نظام الموافقة في تطبيق الذكاء الاصطناعي. عادةً ما يُسمح باستخدام أدوات القراءة فقط، مثل البحث عن الفواتير أو قوائم القوالب، دون موافقة، بينما قد تتطلب أدوات الكتابة، مثل إرسال رسالة واتساب أو تهيئة روابط الويب، تأكيدًا بشريًا.
أدوات MCP المدعومة
يمثل عقد MCP الخارجي طبقة الأدوات. أسماء الأدوات ثابتة ويجب التعامل معها كأسماء تكامل مستقرة.
| أداة | يكتب | وصف |
|---|---|---|
إرسال رسالة نصية عبر واتساب | يكتب | يرسل رسالة نصية عبر واتساب باستخدام ChatArchitect. يدعم هذا البرنامج واتساب ، بالإضافة إلى الرسائل النصية. المدخلات المطلوبة هي: القناة، والوجهة، والنص؛ أما المعرّف الخارجي فهو اختياري. |
get_payment_url | إنشاء رابط الدفع | يُنشئ هذا الأمر رابط دفع ChatArchitect ويعيده بناءً على بريد إلكتروني ومبلغ محدد. نوع الدفع الافتراضي "بطاقة"؛ والقيم المدعومة هي "بطاقة" و "تحويل بنكي". بالنسبة للحسابات التي تُفوتر باليورو، الحد الأدنى هو 30 يورو لأي من طريقتي الدفع. إنشاء الرابط لا يُنفذ عملية دفع. |
إرسال إشعار | يكتب | يرسل إشعارًا إلى ChatArchitect يتضمن الاسم والمصدر والنص . ويؤكد الناتج الموحد إرسال الإشعار. |
إنشاء_قالب | يكتب | يُنشئ قالب ChatArchitect نصيًا فقط. تشمل المدخلات اسم العنصر الآمن للاختصارات ، ورمز اللغة ، والفئة ، والمحتوى ، ومثال اختياري ، وعمودي إلزامي . يستخدم الاستدعاء الأصلي نوع القالب: "نص" . |
export_chatarchitect_ata | للقراءة فقط | يُصدّر بيانات ChatArchitect بصيغة CSV. تشمل الإجراءات المدعومة: أرقام الهواتف، والرسائل المرسلة، المستلمة، والمحادثات. تشمل النطاقات المدعومة: الشهر الماضي، والشهر الحالي، ويوم أمس، واليوم. عدد الصفحات 1 على الأقل. |
قائمة القوالب | للقراءة فقط | يعرض هذا الأمر قوالب ChatArchitect لوجهة واتساب. المدخلات هي channel=whatsapp و destination. المخرجات عبارة عن مصفوفة ثابتة من أسماء القوالب والحالات ورموز اللغة الاختيارية. |
get_last_failed_messages | للقراءة فقط | يعرض هذا الأمر آخر الرسائل الفاشلة لوجهة واتساب. المدخلات هي: channel=whatsapp و destination. |
set_webhooks | يكتب | يُستخدم هذا الإعداد لضبط عناوين URL الخاصة بخطافات الويب في ChatArchitect. تتضمن المدخلات العامة خيارات اختيارية مثل webhookو webhook_separateو webhook_message_eventو webhook_user_event. يجب أن تستخدم عناوين URL الخاصة بخطافات الويب بروتوكول https://. |
get_webhooks | للقراءة فقط | يقرأ إعدادات Webhook الحالية لـ ChatArchitect. إذا كان الخادم الخلفي لا يدعم GET /webhook ويعيد رمز 404 أو 405، فإن خادم MCP يربط ذلك بـ unsupported_by_backend. |
الحصول على الفواتير | للقراءة فقط | يُعيد هذا البرنامج ملخص الفواتير متضمنًا للعملاء، وتاريخ الاستحقاق، والعملاء النشطين، والرصيد، وحالة الفاتورة (نشطة أو منتهية الصلاحية). هذه أداة اصطناعية مُنفذة عبر مسار طلبات داخلي في ChatArchitect. |
الأدوات الموجهة للقراءة هي: export_chatarchitect_data، وlist_templates، وget_last_failed_messages، get_webhooks، و get_billing. أما الأدوات التي تُغير الحالة أو تُنشئ كائنًا فهي: send_whatsapp_text_message، وsend_notification، وcreate_template، وset_webhooks، و get_payment_url.
تصف هذه التصنيفات العمليات؛ وهي ليست أذونات مفروضة من الخادم لكل أداة على حدة، أو تعليقات أمان MCP. يمكنك ضبط الأدوات المسموح بها والموافقات حسب اسم الأداة في عميل الذكاء الاصطناعي الخاص بك. يتطلب الطيار الحذر تأكيدًا قبل إرسال رسالة، أو تغيير روابط الويب، أو إنشاء قالب، أو إنشاء رابط دفع.
مثال توضيحي: الرد على استفسار عبر واتساب
يرسل أحد العملاء رسالة إلى شركتك عبر واتساب للاستفسار عن عرض توضيحي. تُمرر الرسالة الواردة وسياق نظام إدارة علاقات العملاء (CRM) إلى نظام ذكاء اصطناعي. في غضون 24 ساعة من آخر رسالة من العميل، يُعدّ الموظف ردًا يؤكد فيه الاستفسار ويحدد موعدًا للعرض التوضيحي.
يمكن للعميل أن يسأل:
قم بصياغة رد على استفسار واتساب هذا، واقترح إجراء مكالمة تجريبية غداً. اطلب مني الموافقة على النص النهائي قبل إرساله.
يلاحظ عميل الذكاء الاصطناعي أن منصة ChatArchitect MCP توفر وظيفة إرسال رسالة نصية عبر واتساب. إذا كانت الأداة مسموحة واستوفت شروط الموافقة، يتصل العميل بخادم MCP. يتحقق الخادم من صحة رمز Bearer، ويتأكد من أن مدخلات الأداة تحتوي فقط على حقول نص واتساب المدعومة، ثم يرسل الرسالة عبر ChatArchitect، ويعيد النتيجة بعد توحيدها.
احتفظ بموافقة العميل وسجّل نتيجة الأداة في سير عملك. بالنسبة للرسائل التي تبدأها جهة العمل، احصل على موافقة صريحة. خارج نطاق خدمة العملاء على مدار 24 ساعة، استخدم نموذجًا معتمدًا من خلال آلية إرسال نماذج مدعومة بدلاً من هذه الأداة النصية فقط. راجع سياسة مراسلة واتساب للأعمال.
خيارات الاتصال المدعومة
يمكن استخدام ChatArchitect Cloud MCP من بيئات الذكاء الاصطناعي والأتمتة المختلفة. تختلف واجهة المستخدم الدقيقة باختلاف العميل، ولكن القاعدة المهمة واحدة في كل مكان: استخدم عنوان URL الكامل لنقطة نهاية MCP، بما في ذلك /mcp.
https://api-mcp.chatarchitect.com/mcp
إذا تم تكوين العميل باستخدام المجال الأساسي فقط، فقد يرسل طلبات MCP إلى / بدلاً من /mcp، ولن تظهر الأدوات.
موقع ChatGPT
إذا كانت خطة ChatGPT ومساحة العمل لديك تسمحان بعمليات تكامل MCP مخصصة، فأضف ChatArchitect كملحق MCP مخصص. قد يحتاج مسؤولو مساحة العمل إلى تمكين الوصول أو الموافقة عليه.
مثال على الإعداد:
- افتح قسم الإضافات في ChatGPT.
- حدد علامة +، ثم أضف خادم MCP مخصص.
- أدخل عنوان URL الخاص بالخادم هذا واختر مصادقة OAuth:
https://api-mcp.chatarchitect.com/mcp
- قم بإنشاء الملحق، وتثبيته، وإكمال عملية التفويض.
- أدخل
معرف تطبيقوكلمةالمرورفقط في صفحة التفويض الموثوقة. - قم بتمكين الأدوات اللازمة لسيناريوك واختبر إجراءً موجهاً نحو القراءة أولاً.
قد تتغير تسميات الواجهة ومدى توفرها؛ استخدم تعليمات الاتصال الرسمية لـ ChatGPT MCP لحسابك.
مثال على الرسالة بعد الاتصال:
استخدم إضافة ChatArchitect لعرض قوالب واتساب لهذا الوجهة. لا ترسل رسالة إلا بعد موافقتي على النص النهائي.
قم بضبط أذونات الأدوات ومراجعة إجراءات الكتابة بشكل صريح. يُعدّ طلب التأكيد مفيدًا، ولكنه لا يغني عن إعدادات موافقة العميل.
n8n
يمكن لـ n8n استخدام أدوات MCP ضمن عمليات سير العمل الآلية. استخدم عقدة عميل MCP عندما تريد استدعاء MCP كخطوة عادية في سير العمل. استخدم عقدة أداة عميل MCP عندما يحتاج وكيل الذكاء الاصطناعي الخاص بـ n8n إلى استدعاء أدوات MCP خارجية.
الإعداد الموصى به لهذا الخادم:
- أضف عقدة عميل MCP، أو عقدة أداة عميل MCP إذا كان إصدار n8n الخاص بك يدعم بروتوكول HTTP القابل للبث لتلك العقدة.
- قم بتعيين عنوان URL لنقطة نهاية MCP إلى:
https://api-mcp.chatarchitect.com/mcp
- اختر مصادقة Bearer أو OAuth2.
- للمصادقة باستخدام Bearer، قم بتوفير رمز وصول قصير الأجل لـ ChatArchitect MCP:
التفويض: حامل <رمز Chatarchitect-mcp الرمزي>
- بالنسبة لمصادقة OAuth2، استخدم بيانات تعريف الخادم ونقاط النهاية التي يعرضها ChatArchitect MCP:
بيانات تعريف خادم التخويل: https://api-mcp.chatarchitect.com/.well-known/oauth-authorization-server بيانات تعريف الموارد المحمية: https://api-mcp.chatarchitect.com/.well-known/oauth-protected-resource
- اختر الأداة التي تريد استدعاءها، أو اعرض أدوات محددة على وكيل الذكاء الاصطناعي.
مثال على سير عمل n8n:
رسالة واتساب واردة -> تحقق من نافذة خدمة العملاء المتاحة على مدار 24 ساعة -> يقوم وكيل الذكاء الاصطناعي بصياغة رد -> موافقة بشرية -> أداة عميل MCP: إرسال رسالة نصية عبر واتساب -> تحديث نظام إدارة علاقات العملاء
تحقق من وثائق أداة عميل n8n MCP وإمكانيات النقل الخاصة بالإصدار المثبت لديك.
لا يدعم ChatArchitect MCP v1 تقنية SSE على طلب GET /mcp ؛ حيث يُرجع هذا الطلب رمز 405. إذا كانت عقدة n8n أو إصدار أقدم من n8n لا يقبل إلا نقطة نهاية SSE، فاستخدم عقدة MCP تدعم بروتوكول HTTP Streamable أو ضع محولًا متوافقًا أمام خادم MCP.
كلود كود
يدعم برنامج Claude Code خوادم HTTP MCP البعيدة. وهذا يجعله مفيدًا للفرق التقنية التي ترغب في فحص أو اختبار سير عمل ChatArchitect أثناء العمل في مستودع.
إعداد قائم على OAuth:
claude mcp add --transport http chatarchitect https://api-mcp.chatarchitect.com/mcp
ثم، داخل برنامج Claude Code، قم بتشغيل ما يلي:
/mcp
يفتح برنامج Claude Code عملية OAuth للخوادم البعيدة التي تتطلب المصادقة. بعد اكتمال العملية، تصبح أدوات ChatArchitect متاحة في جلسة Claude Code.
إذا كان نظامك الخلفي يقوم بإنشاء رمز Bearer قصير الأجل وتريد تمريره مباشرةً، فاستخدم تكوينًا قائمًا على الترويسة:
claude mcp add --transport http chatarchitect https://api-mcp.chatarchitect.com/mcp \ --header "Authorization: Bearer <chatarchitect-mcp-token>"
لإعداد مشروع مشترك بين أعضاء الفريق، يمكن لـ Claude Code أيضًا تخزين خوادم MCP في .mcp.json . يُرجى عدم تضمين بيانات الاعتماد في الملفات المشتركة؛ اتبع توثيق Claude Code MCP الخاص بالمصادقة والأذونات.
{ "mcpServers": { "chatarchitect": { "type": "http", "url": "https://api-mcp.chatarchitect.com/mcp" } } }
مثال على موجه كود كلود:
استخدم خادم ChatArchitect MCP للتحقق من الفواتير وعرض آخر رسائل واتساب الفاشلة. لا تستخدم أدوات الكتابة.
المخطوطة
يمكن لـ Codex الاتصال بخوادم MCP البعيدة من خلال واجهة سطر الأوامر أو إضافة بيئة التطوير المتكاملة. يُعد هذا مفيدًا عندما يرغب المطورون في أن يقوم Codex بفحص أدوات ChatArchitect MCP، أو اختبار عقود الأدوات، أو المساعدة في بناء سير العمل الذي يستدعي إجراءات ChatArchitect.
إعداد واجهة سطر الأوامر:
codex mcp add chatarchitect --url https://api-mcp.chatarchitect.com/mcp codex mcp login chatarchitect codex mcp list
التكوين المباشر المكافئ في ~/.codex/config.toml:
[mcp_servers.chatarchitect] url = "https://api-mcp.chatarchitect.com/mcp"
قم بتشغيل الأمر codex mcp login chatarchitect لبدء OAuth وأدخل بيانات اعتماد ChatArchitect الخاصة بك في صفحة التفويض الموثوقة.
بالنسبة لرمز Bearer الذي يتم إنشاؤه بواسطة الواجهة الخلفية، استخدم متغير بيئة بدلاً من الرمز الحرفي في التكوين:
[mcp_servers.chatarchitect] url = "https://api-mcp.chatarchitect.com/mcp" bearer_token_env_var = "CHATARCHITECT_MCP_TOKEN"
قم بتعيين رمز CHATRACHITECT_MCP_TOKEN بشكل آمن في بيئة التشغيل قبل بدء تشغيل Codex. استخدم إما OAuth أو إعداد Bearer-token للاتصال. راجع وثائق Codex MCP للاطلاع على عناصر التحكم في الأداة وخيارات المصادقة.
مثال على موجه كودكس:
استخدم خادم ChatArchitect MCP لفحص الأدوات المتاحة. ثم ضع خطة اختبار آمنة لوظائف get_billing وlist_templates وsend_whatsapp_text_message. لا ترسل أي رسالة واتساب إلا بعد موافقتي الصريحة على نصها.
المؤشر
يدعم Cursor خوادم MCP المخصصة من خلال ملف mcp.json. استخدم إعدادات على مستوى المشروع عندما يكون الاتصال مقتصراً على مستودع واحد فقط، أو إعدادات عامة عندما تريد أن يكون الخادم متاحاً عبر المشاريع.
ملف على مستوى المشروع:
.cursor/mcp.json
الملف العالمي:
~/.cursor/mcp.json
تكوين الخادم البعيد بنمط OAuth:
{ "mcpServers": { "chatarchitect": { "url": "https://api-mcp.chatarchitect.com/mcp" } } }
تكوين رمز حامل البطاقة باستخدام متغير بيئي:
{ "mcpServers": { "chatarchitect": { "url": "https://api-mcp.chatarchitect.com/mcp", "headers": { "Authorization": "Bearer ${env:CHATARCHITECT_MCP_TOKEN}" } } } }
مثال على موجه المؤشر:
استخدم أدوات ChatArchitect MCP لعرض قوالب الرسائل لهذا الوجهة في واتساب. إذا كنت ترغب في إرسال رسالة، فقم بصياغتها أولاً وانتظر الموافقة عليها.
فعّل الأدوات اللازمة لسير العمل فقط، واستخدم ضوابط موافقة العميل للإجراءات التي تُغيّر الحالة. راجع وثائق Cursor MCP للاطلاع على معلومات التكوين ومعالجة متغيرات البيئة.
متى يجب عليك استخدام ChatArchitect MCP؟
استخدم ChatArchitect MCP عندما يكون لديك بالفعل، أو تخطط لإنشاء، سير عمل ذكاء اصطناعي يحتاج إلى العمل في WhatsApp أو ChatArchitect بدلاً من مجرد إنتاج النصوص. إنه خيار مثالي عندما تريد من وكيل الذكاء الاصطناعي إرسال رسائل WhatsApp، والعمل مع القوالب، وتصدير البيانات المتعلقة بالمحادثات، وفحص الرسائل الفاشلة، والتحقق من الفواتير، أو ربط إجراءات WhatsApp بنظام إدارة علاقات العملاء (CRM) ودعم سير العمل.
يُعدّ هذا مفيدًا أيضًا عند الرغبة في تحديد حدود تكامل مُحكمة. يُمكن السماح لعميل الذكاء الاصطناعي باستدعاء أدوات مُحددة فقط. قد تتطلب عمليات الكتابة موافقة. تبقى مخططات الأدوات محدودة. تبقى البيانات السرية بعيدة عن المطالبات ومعاملات الأدوات. تبقى تفاصيل المصدر داخل خادم MCP.
تتيح نقطة النهاية السحابية لفريقك الاتصال دون الحاجة إلى نشر بنية تحتية خاصة به لمنصة إدارة الاتصالات. يمكنك التركيز على سير العمل وتجربة العملاء بينما يوفر ChatArchitect طبقة التنفيذ.
ما تحتاجه للبدء
للبدء باستخدام ChatArchitect Cloud MCP، ستحتاج إلى حساب ChatArchitect، وإعداد واجهة برمجة تطبيقات WhatsApp Business API فعّالة، وإمكانية الوصول إلى نقطة نهاية MCP، وطريقة مصادقة لرمز MCP Bearer أو تدفق OAuth، وبرنامج عميل ذكاء اصطناعي أو أداة أتمتة قادرة على استدعاء MCP. للتجربة الأولية، اختر سيناريو بسيطًا واحدًا: متابعة عميل محتمل، أو تأكيد دعم، أو تذكير بالدفع، أو إشعار داخلي.
ومن ثم، حدد الأدوات التي يمكن لعميل الذكاء الاصطناعي استخدامها. عادةً ما يسمح الإعداد المحافظ باستخدام أدوات القراءة فقط دون الحاجة إلى موافقة، بينما يتطلب موافقة لأدوات الكتابة. على سبيل المثال، يمكن للعميل قراءة نماذج الفواتير أو القوائم بحرية، ولكن يجب عليه طلب موافقة المستخدم قبل إرسال رسالة عبر واتساب أو تغيير إعدادات الويب هوك.
التعليمات
هل هذا مخصص للمطورين فقط؟
لا. يمكن للمطورين الاتصال عبر واجهة برمجة تطبيقات OpenAI Responses أو نظام خلفي مخصص، ولكن يمكن لفرق الأتمتة أيضًا استخدام أدوات بدون كتابة أكواد أو أدوات كتابة أكواد قليلة تدعم MCP. الهدف هو توفير واجهة أدوات قياسية يمكن لعملاء الذكاء الاصطناعي المختلفين استخدامها.
هل أحتاج إلى استضافة خادم MCP الخاص بي؟
لا. تم تصميم خادم ChatArchitect Cloud MCP كنقطة نهاية MCP مستضافة. يتصل العملاء بنقطة النهاية السحابية بدلاً من نشر خادم MCP الخاص بهم وصيانته.
هل يمكن للذكاء الاصطناعي إرسال رسائل واتساب تلقائياً؟
نعم، عندما يقوم العميل بضبط التفويض والأدوات المسموح بها وقواعد الموافقة. بالنسبة لسير العمل الحساس، يجب أن تتطلب أدوات الكتابة تأكيدًا قبل التنفيذ.
هل يمكنني طلب الموافقة قبل الإرسال؟
نعم. قم بضبط قواعد الموافقة في عميل الذكاء الاصطناعي حسب اسم الأداة. لا يفرض الخادم الحالي هذه القواعد ولا ينشر تعليقات السلامة لكل أداة، لذا راجع سلوك العميل بدلاً من افتراض التصنيف التلقائي.
هل يمكنني تعطيل الوصول أو تقييده لاحقاً؟
يمكنك فصل التكامل أو تعطيل الأدوات في العميل. يتحكم هذا الإجراء في ذلك العميل، ولكنه لا يُبطل الرموز المميزة الصادرة مسبقًا. لا يحتوي خادم الإصدار الأول الحالي على نقطة نهاية لإلغاء OAuth؛ وتبقى رموز الوصول الصادرة صالحة للاستخدام حتى تاريخ انتهاء صلاحيتها. نسّق تغييرات الوصول من جانب الخادم مع ChatArchitect عند الحاجة إلى إيقاف الوصول.
هل هو مناسب للإنتاج؟
يتضمن الخادم مصادقة Bearer، ورموز وصول مشفرة، والتحقق من صحة المخطط، ومهلات زمنية، وتوحيد الاستجابة، وأدوات مساعدة لتنقيح المحتوى. لا تضمن هذه الميزات جاهزية النظام لكل عملية نشر. قبل إطلاقه في بيئة الإنتاج، تحقق من صحة سير العمل التمثيلي في حساب تجريبي، وتأكد من موافقات العملاء، وراقب حالات الفشل، والتزم بقواعد واتساب للأعمال.
ابدأ سير عمل MCP الخاص بك
هل ترغب في ربط وكيل الذكاء الاصطناعي الخاص بك بتطبيق واتساب؟ تواصل مع ChatArchitect وسنساعدك في إعداد منصة إدارة السحابة (Cloud MCP) لحالة استخدامك.
هل لديك بالفعل سير عمل للذكاء الاصطناعي؟ أرسل لنا سيناريوك وسنوضح لك كيفية ربطه من خلال MCP.