إعداد Snowflake MCP لـ Notion

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

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

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

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

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

• قد تختلف الأدوات المتاحة حسب منطقة سحابة 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 أداةً يستخدمها الأعضاء. فهو يجمع طرق العرض الدلالية والاستعلامات التي تم التحقق منها والبحث والتنسيق في مكان واحد. استخدام 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 للخادم وعميل OAuth والنطاقات التي اعتمدتها.

• لا ينشئ جلسة 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 الخاص بك

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