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

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

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