ربط Claude أو ChatGPT بمنصة Braze باستخدام خادم MCP

لربط Claude أو ChatGPT بـ Braze، أضف خادم بروتوكول سياق النموذج (MCP) البعيد الخاص بـ Braze كموصل مخصص وسجّل الدخول باستخدام حساب Braze الخاص بك. سيعمل الوكيل بعد ذلك وفقاً لصلاحيات لوحة التحكم الخاصة بك. ابدأ بتكليف مسؤول بإعداد الوصول، واقتصر في البداية على قراءة التحليلات والمحتوى، واعتبر أي أداة تقوم بتغيير بيانات Braze قراراً منفصلاً ومقصوداً.

أبرز النقاط

• يربط خادم بروتوكول سياق النموذج (MCP) البعيد من Braze عملاء الذكاء الاصطناعي مثل Claude وChatGPT بـ Braze عبر OAuth، دون الحاجة إلى مفتاح واجهة برمجة تطبيقات (API Key).
• يرث الوكيل صلاحيات لوحة تحكم Braze الخاصة بالشخص الذي يقوم بالربط، بما في ذلك الحق في تغيير البيانات.
• يجب على مسؤول الشركة تفعيل وصول OAuth للخادم ومنح إذن الوصول للخادم، وهو إذن معطل افتراضياً.
• لا تقوم أدوات الخادم باسترجاع بيانات من ملفات تعريف مستخدمي Braze.
• اذكر اسم مساحة العمل في كل مطالبة (Prompt)، وتحقق من الإجابات ذات التأثير الكبير بمطابقتها مع لوحة تحكم Braze.
• اتفق كتابياً على أن الشخص، وليس الوكيل، هو المسؤول عن إطلاق أو إيقاف أو حذف أي شيء في بيئة الإنتاج.

ما هو خادم MCP الخاص بـ Braze؟

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

يمكن للوكيل الاستفسار عن أداء الحملات وCanvas، واستكشاف القطاعات والسمات المخصصة، وإنشاء التقارير، وتوليد محتوى مثل قوالب البريد الإلكتروني وكتل المحتوى (Content Blocks). لا تسترجع الأدوات بيانات من ملفات تعريف مستخدمي Braze، وتؤكد Braze أن الأدوات التي تكشف عن بيانات شخصية على مستوى المستخدم غير متاحة.

تحققت Braze من قائمة من العملاء، بما في ذلك Claude وChatGPT عبر الموصلات المخصصة، وCursor، وOpenAI Codex، وClaude Code، وVisual Studio Code. تم إيقاف دعم الخادم القديم المستضاف محلياً من أغسطس 2025، بينما تظل مفاتيح واجهة برمجة التطبيقات قيد الاستخدام لواجهة برمجة تطبيقات Braze.

ما الذي يحتاج المسؤول إلى إعداده أولاً؟

لن يعمل الخادم حتى يقوم مسؤول الشركة بإعداد الوصول. اتبع هذه الخطوات قبل أن يحاول أي شخص الاتصال.

1. قم بتفعيل وصول OAuth لـ MCP ضمن الإعدادات (Settings)، ثم إعدادات المسؤول (Admin Settings)، ثم OAuth.
2. امنح إذن "استخدام خادم MCP" (Use MCP Server) لكل مستخدم يحتاجه، في كل مساحة عمل ذات صلة.
3. وافق على عنوان إعادة التوجيه الخاص بكل عميل في إعدادات OAuth نفسها.
4. تحقق مما إذا كانت الشركة تستخدم القائمة البيضاء لعناوين IP، لأن هؤلاء العملاء لا يمكنهم استخدام الخادم بعد.
5. تأكد من أن المستخدمين لديهم وصول كامل لمساحة العمل، حيث إن الوصول المحدود على مستوى الفريق قد يعيق عمل بعض الأدوات.

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

يتم تسجيل كل عملية تسجيل دخول ناجحة في تقرير أحداث الأمان. وجّه فريق الأمان لديك إلى هذا التقرير قبل الإطلاق، ليكونوا على دراية بمكان المتابعة.

ما هي نقطة النهاية (endpoint) التي يجب استخدامها لربط Claude أو ChatGPT بـ Braze؟

توفر Braze نقطتي نهاية، وتوضح وثائقها أن كلاً منهما يمكنه الوصول إلى أي مجموعة (cluster) تابعة لـ Braze.

العناوين الكاملة التي يجب لصقها في العميل موضحة أدناه.

اختر نقطة النهاية التي يوافق عليها فريق الأمن لديك، وقم بتوثيق هذا القرار. فالاتصال الذي يعمل لا يعني بالضرورة أنه اتصال تسمح به سياسة البيانات الخاصة بك.

لماذا تعتبر الأذونات مهمة جداً؟

يرث الوكيل (agent) أذونات لوحة التحكم الخاصة بك. تربط Braze الوصول بحساب Braze الخاص بكل شخص بدلاً من مفتاح مشترك، لذا فإن ما يمكن للوكيل رؤيته والقيام به يعكس ما يمكن لهذا الشخص القيام به في لوحة التحكم.

ويشمل ذلك التغييرات. تؤكد Braze أن الوكيل يمكنه تغيير بيانات Braze إذا كان مستخدم لوحة التحكم يمتلك تلك الأذونات، كما تتضمن قائمة الأدوات أدوات إطلاق وإيقاف الحملات للعملاء المشاركين في النسخة التجريبية لواجهات برمجة تطبيقات الحملات.

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

ما الذي يجب أن يقرأه الوكيل، وما الذي يجب أن يكتبه؟

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

تعامل مع عمليات الكتابة كقرار منفصل. تتضمن أمثلة استخدام Braze نسخ قوالب البريد الإلكتروني من مساحة عمل تجريبية إلى بيئة الإنتاج، مما يوضح النمط الأكثر أماناً: البناء والتحقق في بيئة تجريبية، ثم النقل.

نوصي بقاعدة مكتوبة بسيطة لأي فريق يقوم بالاتصال: يمكن للوكلاء إنشاء مسودات ومحتوى في بيئة تجريبية، ولكن يقوم شخص ما بإطلاق أو إيقاف أو حذف أي شيء في بيئة الإنتاج من خلال لوحة التحكم.

كيف تضمن موثوقية إجابات الوكيل؟

تقدم إرشادات استخدام Braze أربع عادات، تمنع كل واحدة منها خطأً محدداً.

1. اذكر اسم مساحة العمل في كل مطالبة (prompt)، خاصة إذا كان بإمكانك الوصول إلى عدة مساحات.
2. حدد نطاقات زمنية ومقاييس دقيقة عند طلب التحليلات.
3. اسأل الوكيل عن الأدوات التي استخدمها، حتى تتمكن من التحقق من كيفية وصوله إلى الإجابة.
4. قارن التوصيات ذات التأثير الكبير بالبيانات المصدرية في لوحة تحكم Braze.

تعتبر العادة الأولى هي الأكثر أهمية. فإجابة تتعلق بمساحة عمل خاطئة قد تبدو واثقة تماماً كإجابة تتعلق بمساحة العمل الصحيحة.

كيف يمكنك إلغاء الوصول؟

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

إذا كان هناك احتمال لتسريب رمز مميز (token) أو إساءة استخدامه، يمكن لمسؤول الشركة إلغاء جميع رموز OAuth الخاصة بالشركة دفعة واحدة. سيؤدي هذا إلى فقدان جميع العملاء المتصلين لإمكانية الوصول وسيتعين على الجميع إعادة الاتصال، لذا احتفظ بهذه الخطوة للحالات الطارئة الحقيقية فقط.

ما الذي يجب على فريق الأمن لديك مراجعته؟

تتدفق البيانات التي يعيدها الخادم إلى عميل الذكاء الاصطناعي الذي تتصل به، مثل Claude أو ChatGPT. يستبعد الخادم البيانات الشخصية على مستوى المستخدم، ولكن أسماء الحملات والمحتوى والتحليلات تظل تغادر منصة Braze إلى ذلك العميل.

اطلب من فريق الأمن لديك مراجعة كيفية تعامل كل عميل مع البيانات قبل الإطلاق على نطاق واسع، إلى جانب اختيار نقطة النهاية (endpoint). تقع مسؤولية هذه المراجعة على عاتق مؤسستك ومزود الخدمة، وليس على عاتق Braze.

ما هي الأخطاء التي يجب عليك تجنبها؟

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

المطالبة الخاصة بمساحة عمل خاطئة هي طرح سؤال دون تحديد مساحة العمل، مما يؤدي للحصول على إجابة تتعلق بمساحة عمل أخرى. أما الرقم غير المدقق فهو رقم أنتجه الوكيل ولم يقم أحد بمقارنته مع لوحة التحكم.

الإطلاق عبر الدردشة هو حملة إنتاج يتم إطلاقها أو إيقافها من خلال وكيل بدلاً من شخص عبر لوحة التحكم. اتفق كتابياً على عدم القيام بذلك.

أين يرتبط هذا ببقية البرنامج؟

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

. تعتمد الإجابات الجيدة أيضاً على بيانات نظيفة، كما هو موضح في تتبع أحداث المستخدم في Brazeودمج بيانات نظام إدارة علاقات العملاء (CRM) في Braze.

بصفتها شريكاً في تنفيذ حلول Braze، توصي شركة CustomerIK بالتعامل مع وصول الوكيل كمشروع أذونات قبل أن يكون مشروع إنتاجية. حدد من يتصل، وما الذي يمكنهم تغييره، وأين تتم عمليات الكتابة، ثم قم بإجراء الاتصال.

اختبار اتصال بنتيجة قابلة للملاحظة

بعد أن يكمل المسؤول الإعداد، أضف نقطة النهاية البعيدة المعتمدة من خلال إعدادات الموصل الخاصة بالعميل وقم بالمصادقة. تختلف قوائم العملاء، لذا اتبع التعليمات الحالية الخاصة بكل عميل. ابدأ بطلب أسماء ومعرفات الحملات في مساحة عمل محددة دون تغيير أي شيء.

قارن نتيجة واحدة مع لوحة التحكم، ثم اطلب مقياساً محدداً ونطاقاً زمنياً معيناً. إذا كانت عمليات الكتابة مصرحاً بها، اختبر تغييراً مدعوماً على مسودة تجريبية وافحص الحقل المحفوظ وسجل التعديلات. لا تستخدم عملية إطلاق فعلية كاختبار للاتصال.

الأمثلة العملية وحالات الاختبار هي توجيهات تحريرية توضيحية، وليست نتائج مقاسة للعملاء أو ادعاءً بأنه تم اختبار تكامل مباشر.

الأسئلة الشائعة

1. ما هي عملاء الذكاء الاصطناعي الذين يعملون مع خادم Braze MCP؟

يمكن لأي عميل يدعم الخوادم البعيدة باستخدام OAuth العمل مع هذه الخدمة. وقد تحققت Braze من توافق كل من Claude وChatGPT من خلال موصلات مخصصة، بالإضافة إلى Cursor وOpenAI Codex وClaude Code وVisual Studio Code.

2. هل أحتاج إلى مفتاح واجهة برمجة تطبيقات (API key) من Braze لاستخدام خادم MCP؟

لا تحتاج إلى ذلك. يتم تسجيل الدخول باستخدام حساب لوحة تحكم Braze الخاص بك عبر OAuth. ولا تزال مفاتيح واجهة برمجة التطبيقات تعمل مع واجهة برمجة تطبيقات Braze.

3. هل يمكن لخادم MCP إرجاع بيانات ملف تعريف المستخدم؟

لا يمكنه ذلك. فأدواته لا تسترجع بيانات من ملفات تعريف مستخدمي Braze، كما أن الأدوات التي تكشف عن البيانات الشخصية على مستوى المستخدم غير متاحة.

4. هل يمكن للوكيل تغيير البيانات في Braze؟

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

5. كيف يمكنني إزالة وصول الوكيل؟

قم بإزالة إذن الوصول إلى الخادم من المستخدم في لوحة التحكم. وإذا كان هناك احتمال لتسريب رمز مميز (token)، يمكن لمسؤول الشركة إبطال جميع رموز OAuth الخاصة بالشركة دفعة واحدة.

المصادر

• Braze،خادم Braze MCP. تم الاسترجاع في 18 أكتوبر 2026.
• Braze،إعداد خادم Braze MCP. تم الاسترجاع في 18 أكتوبر 2026.
• Braze،استخدام خادم Braze MCP. تم الاسترجاع في 18 أكتوبر 2026.
• Braze،وظائف واجهة برمجة التطبيقات المتاحة. تم الاسترجاع في 18 أكتوبر 2026.
• Braze،ما الجديد في Braze. تم الاسترجاع في 18 أكتوبر 2026.

CustomerIK هي شريك تنفيذ لـ Braze، وتعمل في مجالات الإعداد، والتكامل التقني، وعمليات التسويق، وإدارة بيانات العملاء.

إذا كنت تخطط لربط وكلاء الذكاء الاصطناعي بـ Braze وترغب في ضبط قواعد الوصول أولاً، فلنتحدث.