إعداد Snowflake MCP لـ Notion

يمكن لـ وكلائك المخصصين ووكيل Notion الاتصال بـ Snowflake من خلال خادم MCP (بروتوكول سياق النموذج) الذي تشغّله Snowflake. بمجرد إعداده، يمكنك سؤال وكيلك عن بيانات مستودع البيانات الخاص بك في Snowflake والحصول على إجابات مباشرة في Notion.

يتم الإعداد على مراحل، ويكون لكل مرحلة مسؤول مختلف:

• يتولى مسؤول Snowflake إعداد الدور ومستودع البيانات وخادم MCP الذي تديره Snowflake.

• يضبط مالك مساحة عمل Notion أو مسؤولها اتصال Snowflake MCP بمساحة العمل.

• يمكن لـ أعضاء مساحة العمل بعد ذلك الاتصال بـ Snowflake MCP من الوكلاء المخصصين باستخدام بيانات اعتماد Snowflake الخاصة بهم، أو توصيل Snowflake مباشرة بوكيل Notion الخاص بهم. الخطوات من 1 إلى 10 من هذه المقالة هي نفسها لكلا المسارين. ينقسم المساران عند الخطوة 11، حسب الوكيل الذي تريد توصيله.

• قد تختلف الأدوات المتاحة حسب منطقة Snowflake السحابية التي تستخدمها.

• خادم MCP المُدار من Snowflake غير متاح في البر الرئيسي للصين أو المناطق الحكومية.

• يجب أن تكون مساحة عمل Notion الخاصة بك على خطة الأعمال أو الخطة المؤسسية.

• استخدم Notion على الويب أو سطح المكتب. هذه الميزة غير متاحة على الأجهزة المحمولة.

• تحتاج شركتك إلى حساب Snowflake.

• لبناء وكيل مخصص، تحتاج إلى إذن لإنشاء وكلاء في مساحة عملك.

قبل أن يتمكن فريقك من توصيل Snowflake بـ Notion، يحتاج مسؤول Snowflake إلى إعداد الوصول. هذه هي الخطوة الأكثر تعقيداً، ولا تحتاج إلى القيام بها سوى مرة واحدة. تعاون مع مسؤول مساحة عمل Notion الخاص بك: يوفر Notion عنوان URI لإعادة التوجيه، ويوفر Snowflake معرف عميل OAuth وسر العميل.

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

املأ ورقة العمل هذه مع مسؤول مساحة عمل Notion الخاص بك قبل البدء. يمكن للأعضاء تخطيها وتسجيل الدخول بحسابات Snowflake الخاصة بهم بمجرد اكتمال الإعداد.

يستخدم اسم مضيف الحساب واصلات، وليس شرطات سفلية. تأكد من أن كل اسم كائن في عنوان URL للخادم يطابق اسم الكائن المقابل في Snowflake.

استخدم دوراً مخصصاً يتمتع بأقل قدر من الامتيازات ومستودعاً واحداً معتمداً كلما أمكن ذلك.

دور مقيد بدون أدوار ثانوية (موصى به). هذا النموذج أسهل في الفهم والتدقيق. قم بتعيين OAUTH_USE_SECONDARY_ROLES = NONE، وحدد ALLOWED_ROLES_LIST، واستخدم نطاق Notion session:role:<mcp_access_role>.

الأدوار الثانوية الافتراضية للمستخدم (اختياري). استخدم هذا النموذج فقط إذا احتاج الخادم إلى الامتيازات الموروثة من إعداد DEFAULT_SECONDARY_ROLES لكل مستخدم في Snowflake. عيّن OAUTH_USE_SECONDARY_ROLES = IMPLICIT، ولا تُدرج ALLOWED_ROLES_LIST، واستخدم نطاقاً صريحاً للدور الأساسي. لا تسمح Snowflake باستخدام الأدوار الثانوية IMPLICIT مع ALLOWED_ROLES_LIST، لذا لا تُدرج قائمة السماح عند استخدام هذا النموذج.

استخدم دوراً مخصصاً يتمتع بأقل قدر من الامتيازات لخادم MCP كلما أمكن ذلك.

امنح هذا الدور من خلال عملية إدارة الهوية المعتادة لديك. إذا كانت Okta أو SCIM تدير عضوية أدوار Snowflake، فلا تضف المستخدمين يدوياً خارج تلك العملية.

قم بإنشاء أو اختيار قاعدة بيانات ومخطط مملوكين للفريق الذي سيقوم بتشغيل الخادم.

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

تشمل أنواع أدوات Snowflake MCP المدعومة الأخرى CORTEX_ANALYST_MESSAGE، وCORTEX_SEARCH_SERVICE_QUERY، وGENERIC، وSYSTEM_EXECUTE_SQL.

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

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

امنح حق الوصول فقط للموارد الإضافية التي تحتاجها كل أداة. على سبيل المثال، امنح SELECT على عرض دلالي معتمد، أو USAGE على خدمة Cortex Search، أو USAGE على دالة أو إجراء محدد. لا تمنح الدور لـ PUBLIC ولا تضف امتيازات واسعة للكائنات الحالية أو المستقبلية.

قبل إعداد OAuth، تحقق من خادم MCP والأذونات الممنوحة له:

اضبط مخطط MCP ليعرض الدور المحدد الذي ينبغي للأعضاء طلبه:

استخدم نطاق دور صريح. لا تستخدم session:role:all. يتعامل Snowflake مع هذه القيمة على أنها الدور الأساسي الافتراضي للمستخدم، وليس على أنها تمنح حق الوصول إلى جميع الأدوار، وقد تحظرها سياسات الأدوار ذات الامتيازات العالية. يجعل الدور الصريح الوصول المطلوب واضحاً ويسهّل التحقق منه.

قبل تشغيل SQL، نسّق مع مسؤول مساحة عمل Notion. اطلب منه إدخال عنوان URL لخادم Snowflake في نموذج إعداد MCP لمساحة العمل، وتفعيل تهيئة المصادقة يدويًا واستخدام عميل OAuth مشترك لمساحة العمل. ينشئ Notion عنوان URI لإعادة التوجيه؛ انسخه وأرسله إلى مسؤول Snowflake. بعد أن ينشئ Snowflake معرّف العميل وسرّه، يمكن لمسؤول مساحة العمل إكمال إعداد عملية الربط.

استخدم عنوان URI لإعادة التوجيه تمامًا كما يوفره Notion. لا تضف شرطة مائلة في النهاية أو معلمات استعلام، ولا تغيّر المضيف.

يؤدي تعيين IS_AGENTIC = TRUE إلى وضع علامة على الجلسات التي تم إنشاؤها من خلال هذا التكامل كجلسات وكيل. عندئذٍ تُرجع دالة IS_AGENT_ACTIVATED() الخاصة بـ Snowflake القيمة TRUE، مما يسمح لـ Snowflake بتطبيق التدقيق والحوكمة الخاصة بالوكيل. إذا كنت تستخدم نموذج الدور الثانوي الاختياري، فقم بتعيين OAUTH_USE_SECONDARY_ROLES = IMPLICIT واحذف ALLOWED_ROLES_LIST.

قيمة صلاحية رمز التحديث 7776000 ثانية تعادل 90 يومًا. قبل استخدامها، تأكد من أنها تتوافق مع سياسات إعادة التفويض وتدوير الرموز المميزة في مؤسستك. بالنسبة للتغييرات الروتينية، تجنب CREATE OR REPLACE SECURITY INTEGRATION. فاستبدال التكامل قد يؤدي إلى تعطّل عمليات الربط الحالية.

للتحقق من التكامل دون عرض سرّه، قم بتشغيل:

تأكد من تشغيل التكامل، ومن تطابق عنوان URI لإعادة التوجيه تمامًا، وأن الدور مسموح به وغير محظور، وأن رموز التحديث وPKCE مفعّلة، وأن نقطتي نهاية التفويض والرموز المميزة تستخدمان مضيف الحساب العام لـSnowflake.

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

يجب أن يسمح تكامل OAuth بكلا مساري Notion:

1. مسار واجهة برمجة التطبيقات الذي يعالج عمليات رد اتصال OAuth ويتبادل رموز التفويض

2. مسار وقت تشغيل مساحة العمل الذي يتحقق من صحة عملية الربط، ويشغّل الأدوات، ويجدّد الرموز المميزة

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

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

شغّل هذا الأمر في ورقة عمل آمنة في Snowflake. اسم التكامل حساس لحالة الأحرف، ويُكتب عادةً بأحرف كبيرة:

شارك معرّف العميل والسر المطابق له مع مسؤول مساحة عمل Notion عبر قناة آمنة معتمدة. يوفر Snowflake سرّين صالحين، لذا يمكنك التبديل بينهما دون انقطاع الخدمة. لا تلصق أيًا من السرّين في الوثائق أو الدردشة أو التذاكر أو نظام التحكم في الإصدارات.

عندما يصبح Snowflake جاهزًا، يضيف مالك مساحة العمل أو مسؤولها الخادم مرة واحدة. بعدها يمكن للأعضاء العثور عليه دون الاطلاع على سر عميل OAuth، سواء أرادوا ربط Snowflake MCP بوكيل مخصّص أو بوكيل Notion الخاص بهم.

1. انتقل إلى الإعدادات الخاصة بمساحة العمل.

2. حدّد عمليات الربط → خوادم MCP المشتركة لمساحة العمل.

3. حدّد خادم MCP جديد لمساحة العمل.

املأ هذه الحقول، ثم حدّد إضافة خادم MCP:

بعد الحفظ، تأكد من ظهور الصف الجديد ضمن تمت مشاركته مع مساحة العمل هذه وأن عميل OAuth لمساحة العمل يعرض الحالة تم التكوين.

ما يفعله هذا الإعداد:

• يساعد الأعضاء في العثور على الخادم المعتمد.

• يخزّن سر عميل OAuth مرة واحدة في مخزن عمليات الربط المشفّر في Notion.

• يضمن تسجيل دخول الأعضاء باستخدام عنوان URL للخادم والعميل والنطاقات التي اعتمدتها.

• لا ينشئ جلسة Snowflake مشتركة ولا يتجاوز عناصر التحكم في الوصول الخاصة بـ Snowflake.

• لا يربط كل عضو تلقائيًا. يجب على كل شخص تسجيل الدخول بشكل منفصل.

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

بعد أن يجهّز المسؤولون عملية ربط Snowflake MCP، يمكنك استخدامها بطريقتين. إذا كنت تُعدّها لفريق، فابدأ بالخطوة 11A. وإذا أردت طرح أسئلتك فقط، فانتقل إلى 11B. يمكنك استخدام الطريقتين؛ فلكل منهما عملية ربط مستقلة.

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

ربط Snowflake بوكيل مخصص

1. افتح وكيلك المخصّص، أو أنشئ واحدًا جديدًا.

2. انتقل إلى الإعدادات → الأدوات والوصول.

3. حدد إضافة اتصال، ثم اختر خادم Snowflake المسمى تديره مساحة العمل. لا تحدد خادم MCP مخصَّص ولا تُدخل عنوان URL للخادم يدويًا.

4. سجّل الدخول إلى Snowflake في متصفحك. قد يظهر تسجيل دخول Okta أو SSO المعتاد لمؤسستك.

5. راجع دور Snowflake المطلوب ووافق عليه.

6. اختر الأدوات التي يمكن للوكيل استخدامها. اترك الأدوات القادرة على الكتابة وCORTEX_AGENT_RUN مضبوطة على طلب الموافقة حتى تختبرها.

7. حدد ربط، وتأكد من أن حالة الاتصال تظهر متصل.

تزويد الوكيل بالسياق

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

مشاركة الوكيل

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

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

1. انتقل إلى الإعدادات → Notion AI.

2. تحت خوادم MCP، حدد إضافة خادم MCP.

3. حدد خادم Snowflake المسمى تديره مساحة العمل. لا تحدد خادم MCP مخصَّص ولا تُدخل عنوان URL للخادم يدويًا.

4. حدد ربط.

5. سجّل الدخول إلى Snowflake في متصفحك. قد يظهر تسجيل دخول Okta أو SSO المعتاد لمؤسستك.

6. راجع دور Snowflake المطلوب ووافق عليه.

7. عندما يسألك متصفحك عما إذا كنت تريد فتح Notion، حدد فتح Notion.

8. تأكد من أن حالة الخادم هي متصل، وليست بحاجة إلى المصادقة.

بعد الاتصال، يظهر Snowflake في جميع المصادر → خوادم MCP في الدردشة.

1. اطرح سؤالًا لا ينطوي على مخاطر وتعرف إجابته، ويُفترض أن يستخدم الوكيل Snowflake للإجابة عنه.

2. تأكد من أن الوكيل يستخدم Snowflake ويعيد نتيجة.

3. تأكد من أنك لا تستطيع الوصول إلى بيانات خارج الدور الذي مُنحت إياه.

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

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

اطرح على الوكيل سؤالاً محدداً حول بيانات Snowflake الخاصة بك. على سبيل المثال:

• "من Snowflake، كم بلغ إجمالي عمليات التسجيل لدينا الشهر الماضي؟"

• "من Snowflake، ما هي الحسابات العشرة الأعلى إيراداً لدينا في هذا الربع؟"

باستخدام وكيل مخصص، يمكنك عادةً تخطي عبارة "من Snowflake" بمجرد أن توضح تعليماته متى يجب استخدامه. أما مع وكيل Notion الخاص بك، فإن ذكر Snowflake يساعد الوكيل في اختيار المصدر الصحيح.

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

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

ستحتاج إلى تسجيل الدخول مرة أخرى إذا:

• انتهت صلاحية رمز التحديث الخاص بك أو قام المسؤول بإلغائه

• قام مسؤول باستبدال تكامل OAuth أو سر العميل

• تمت إزالة دور Snowflake الخاص بك

• يقوم المسؤول بإزالة إعداد مساحة العمل أو اتصالك

• سياسة الشبكة تحظر تحديث الرمز المميز

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

إذا كنت تقوم بتدوير سر العميل: استخدم آلية تدوير سرَّي العميل في Snowflake بدلاً من استبدال التكامل. أبقِ السرَّين صالحين لفترة كافية لتحديث إعداد مساحة العمل واختباره قبل إيقاف استخدام السر القديم.

ALTER SECURITY INTEGRATION <oauth_integration_name>
REFRESH OAUTH_CLIENT_SECRET_2;

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

• يُطلب منك إدخال معرّف العميل أو سرّه. ربما اخترت خيار MCP المخصص. ارجع واختر خادم Snowflake المميز بعبارة تديره مساحة العمل بدلاً من ذلك.

• يُطلب منك تسجيل الدخول مرة أخرى. ربما انتهت صلاحية جلسة Snowflake الخاصة بك، أو ربما قام مسؤول بتحديث الاتصال. سجّل الدخول إلى Snowflake مرة أخرى.

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

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

• يعمل الوكيل المخصَّص في الدردشة، ولكن ليس وفق جدول زمني. لا يوجد شخص مسجّل الدخول في عمليات التشغيل المجدولة أو التي تُشغَّل عند وقوع حدث، لذا لا يمكنها استخدام Snowflake مع تسجيل دخول خاص بكل شخص حتى الآن.

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

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

• تنتهي مهلة الطلب. اطرح سؤالاً أكثر تحديداً، أو قسّم طلبك إلى أسئلة أصغر.

تنتج هذه الأخطاء عادةً عن إعدادات Snowflake، لا عن إعدادات Notion. شاركها مع مسؤول Snowflake.

• يبدو عنوان URL للخادم مكرّرًا، مثل https://https%3A... لُصق العنوان مع إضافة https:// في بدايته. صحّحه بحيث يبدأ عنوان URL بمقطع https:// واحد فقط.

• تظهر لك رسالة «هذا الخادم لا يدعم مصادقة OAuth». لم يُعد تكامل الأمان لاستخدام OAuth، أو أن عنوان URL للخادم غير صحيح. اطلب من مسؤول Snowflake التحقق من تكامل أمان OAuth وعنوان URL للخادم.

• تظهر لك invalid_client أثناء تسجيل الدخول أو التحديث. معرّف العميل أو سرّه غير صحيح، أو تغيّر السر. اطلب من المسؤول معرّف العميل والسرّ الحاليين.

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

• تظهر لك رسالة «حُظر الدور المطلوب ALL صراحةً». طلبت عملية الربط جميع الأدوار دفعة واحدة (session:role:all)، وهذا محظور. استخدم دورًا واحدًا محددًا، مثل session:role:analyst، مع استبدال analyst باسم دورك الفعلي.

• يظهر لك خطأ في إعادة التوجيه (الخطأ 390307). عنوان URL لإعادة التوجيه المحفوظ في Snowflake لا يطابق العنوان الذي تستخدمه Notion. اطلب من المسؤول ضبط عنوان URL لإعادة التوجيه في تكامل الأمان ليطابق عنوان Notion تمامًا.

• يظهر لك الخطأ 390311 بشأن تحدّي رمز غير صالح. هذا يعني وجود عدم تطابق في PKCE. اطلب من المسؤول التأكد من ضبط OAUTH_ENFORCE_PKCE ضبطًا صحيحًا في تكامل الأمان.

• أنت متصل، لكن لا تظهر أي أدوات. قد لا يكون لدورك صلاحية USAGE على خادم MCP. اطلب من المسؤول التأكد من منح الصلاحية، ثم شغّل DESCRIBE MCP SERVER للتحقق من الإعداد.

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

• كان يعمل سابقًا، لكنه الآن لا يعمل لدى أحد بعد تغيير السر. تغيّر سر العميل، لذا لم تعد عملية الربط المحفوظة محدّثة. اطلب من المسؤول السر الجديد، ثم أعد الاتصال.

• كان يعمل سابقًا، لكنه الآن لا يعمل معك وحدك. ربما تغيّر دور أو صلاحية ممنوحة أو سياسة، أو انتهت صلاحية جلستك. سجّل الدخول مجددًا، ثم اطلب من المسؤول التأكد من أن صلاحيات وصولك لم تتغيّر.

• تم رفض معرف حسابك. استخدم تنسيق organization-account مع واصلة، مثل myorg-myaccount، وليس النقاط.

• لا يمكن لحساب PrivateLink الاتصال. تتطلب حسابات PrivateLink إعداد شبكة إضافي. اسأل المسؤول عما إذا كان PrivateLink يسمح باتصال Notion.

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

• ترى oauth_security_error بعد تسجيل الدخول عبر المتصفح. قد تكون سياسة الشبكة على مستوى الحساب تحظر الطلب. يمكن للمسؤول التأكد من ذلك عن طريق تشغيل:

• يبدو أن تسجيل الدخول يعمل ولكنك تحصل على خطأ في الدور، حتى مع النطاق الصحيح. قد يكون دورك الافتراضي محظوراً، على سبيل المثال ACCOUNTADMIN أو دور في BLOCKED_ROLES_LIST. يمكن للمسؤول التحقق من ذلك وإصلاحه:

تساعد أوامر القراءة فقط هذه المسؤول في التأكد من الإعداد دون تغيير أي شيء. قم بتشغيلها في Snowflake.

استخدم أدلة Snowflake هذه لإكمال الإعداد:

• خادم MCP الذي تديره Snowflake

• إنشاء تكامل أمان OAuth لـ Snowflake

• Snowflake OAuth للعملاء المخصصين

• نظرة عامة على Snowflake OAuth

• معرفات حساب Snowflake

• الوكلاء المخصَّصون

• عمليات ربط MCP للوكلاء المخصصين

• اربط خوادم MCP بوكيل Notion الخاص بك

• أفضل ممارسات الأمان لعمليات ربط الوكيل