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

تشمل أنواع أدوات 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 لمساحة العمل وتشغيل Manually configure authentication و Use a workspace-shared OAuth client. يقوم Notion بإنشاء URI لإعادة التوجيه. انسخه وأرسله إلى مسؤول Snowflake. بعد أن ينشئ Snowflake معرف العميل والسر، يمكن لمسؤول مساحة العمل إنهاء إعداد عملية الربط.

استخدم عنوان إعادة التوجيه (redirect 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. فاستبدال التكامل قد يؤدي إلى مقاطعة عمليات الربط الحالية.

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

تأكد من تشغيل التكامل، وأن عنوان إعادة التوجيه يطابق تماماً، وأن الدور مسموح به وغير محظور، وأن رموز التحديث و 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. حدد عمليات ربط → MCPs المشتركة لمساحة العمل.

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

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

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

ما الذي يقوم به هذا الإعداد:

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

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

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

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

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

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

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

يمنح الوكيل المخصص (Custom Agent) فريقك مكاناً واحداً للاستفسار عن بيانات 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. لا تحدد Custom MCP server أو تدخل عنوان 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، مع اسم دورك الحقيقي.

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

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