إعداد خادم MCP لـ Snowflake في Notion

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

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

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

• يُهيّئ مالك مساحة عمل Notion أو مسؤولها اتصال Snowflake بخادم MCP لمساحة العمل.

• يمكن لـ أعضاء مساحة العمل بعد ذلك الاتصال بخادم MCP لـ Snowflake من الوكلاء المخصصين باستخدام بيانات اعتماد 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 أداةً يستخدمها الأعضاء. فهو يجمع طرق العرض الدلالية والاستعلامات المعتمدة وSearch وتنسيق العمليات في مكان واحد. استخدام Cortex Agent اختياري. إذا أنشأت واحدًا، فاستخدم المواصفات أدناه. وإذا استبدلت وكيلًا موجودًا، فتأكد من أن البديل يطابق المواصفات المعتمدة لديك.

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

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

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

امنح كل أداة حق الوصول إلى الموارد الإضافية التي تحتاج إليها فقط. على سبيل المثال، امنح امتياز 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 الذي يحمل التسمية Workspace Managed. لا تحدّد خادم 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 الذي يحمل التسمية Workspace Managed. لا تحدّد خادم 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 الذي يحمل التسمية Workspace Managed بدلًا منه.

• يُطلب منك تسجيل الدخول مرة أخرى. ربما انتهت صلاحية جلسة 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، مع اسم دورك الحقيقي.

• ترى خطأ إعادة توجيه (الخطأ 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 للعملاء المخصصين

• نظرة عامة على OAuth الخاص بـ Snowflake

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

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

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

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

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