הגדרת Snowflake MCP עבור Notion

במסמך העזרה הזה

למדו כיצד לחבר את Snowflake לסוכנים בהתאמה אישית או לסוכן Notion שלכם, כדי שתוכלו לשאול שאלות על הנתונים של החברה שלכם ב-Notion.

מעבר לשאלות הנפוצות

חלק מהתכונות נמצאות בשלב אלפא.

חלק מהתכונות המתוארות במאמר זה, כולל חיבורי MCP המוגדרים בסביבת עבודה וההרשאה לכל משתמש בסוכנים בהתאמה אישית, נמצאות כעת בשלב אלפא וייתכן שעדיין אינן זמינות בסביבת עבודה שלכם.

כדי לבקש גישה, צרו קשר עם צוות התמיכה בחשבון Notion שלכם או הגישו מועמדות לתוכנית הגישה המוקדמת שלנו עבור סוכני נתונים →

הסוכנים בהתאמה אישית שלכם וסוכן Notion שלכם יכולים להתחבר ל-Snowflake דרך שרת MCP (פרוטוקול הקשר מודל) ש-Snowflake מריצה. לאחר ההגדרה, תוכלו לשאול את הסוכן שלכם על נתוני מחסן ה-Snowflake שלכם ולקבל תשובות ישירות ב-Notion.

ההגדרה מתבצעת בשלבים, ולאנשים שונים יש אחריות על כל אחד מהם:

  • מנהל Snowflake מגדיר את התפקיד, המחסן ושרת ה-MCP המנוהל על ידי Snowflake.

  • בעלים או מנהל של סביבת עבודה ב-Notion מגדיר את חיבור ה-Snowflake MCP עבור סביבת העבודה.

  • חברי סביבת העבודה יכולים לאחר מכן להתחבר ל-Snowflake MCP מסוכנים בהתאמה אישית באמצעות אישורי ה-Snowflake שלהם, או לחבר את Snowflake ישירות לסוכן Notion שלהם.

  • הכלים הזמינים עשויים להשתנות בהתאם לאזור הענן של Snowflake שלכם.

  • שרת ה-MCP המנוהל של Snowflake אינו זמין בסין היבשתית או באזורים ממשלתיים.

  • סביבת העבודה שלכם ב-Notion חייבת להיות בתוכנית לעסקים (Business) או בתוכנית Enterprise.

  • השתמשו ב-Notion באינטרנט או בשולחן העבודה. תכונה זו אינה זמינה במובייל.

  • לחברה שלכם דרוש חשבון Snowflake.

  • כדי לבנות סוכנים בהתאמה אישית, עליכם להיות בעלי הרשאה ליצירת סוכנים בסביבת העבודה שלכם.

הגדרה משותפת לא מעניקה לכולם את אותם הנתונים.

סביבת עבודה מאחסנת את פרטי החיבור, כולל מזהה לקוח (client ID) וסוד (secret) של OAuth. פרטים אלו מגדירים את החיבור; הם אינם מהווים התחברות משותפת. כל אדם מתחבר ל-Snowflake באמצעות החשבון האישי שלו. בין אם הם משתמשים בסוכנים בהתאמה אישית או בסוכן Notion משלהם, הסוכן יכול לגשת רק לנתונים שאותו חשבון יכול לגשת אליהם.

לפני שהצוות שלכם יוכל לחבר את Snowflake ל-Notion, מנהל Snowflake צריך להגדיר גישה. זהו השלב המורכב ביותר, ועליכם לבצע אותו פעם אחת בלבד. עבדו עם מנהל סביבת העבודה שלכם ב-Notion: Notion מספקת URI להפניה מחדש, ו-Snowflake מספקת מזהה לקוח וסוד של OAuth.

תגדירו תפקיד ומחסן, תיצרו את שרת ה-MCP המנוהל על ידי Snowflake, תעניקו לו גישה למשאבים הדרושים לו, תגדירו את היקף ה-OAuth ואת אינטגרציית האבטחה, ותוסיפו מדיניות רשת אם הארגון שלכם דורש זאת.

מלאו דף עבודה זה עם מנהל סביבת העבודה שלכם ב-Notion לפני שמתחילים. חברים יכולים לדלג על כך ולהיכנס עם חשבונות ה-Snowflake שלהם לאחר השלמת ההגדרה.

שמרו על סודיות ה-OAuth client secret.

אל תוסיפו אותו ל-Slack, לכרטיסים (tickets), לבקרת מקור או להיסטוריית הטרמינל. שתפו אותו רק דרך ערוץ מאובטח מאושר.

שדה

ערך

בעלים

מזהה חשבון Snowflake

<organization-account>

מנהל Snowflake

מאגר ידע MCP

<database_name>

מנהל Snowflake

סכימת MCP

<schema_name>

מנהל Snowflake

שרת MCP

<mcp_server_name>

מנהל Snowflake

מחסן

<warehouse_name>

מנהל Snowflake

תפקיד גישה

<mcp_access_role>

מנהל Snowflake

כתובת URL של השרת

https://<account_host>/api/v2/databases/<database_name>/schemas/<schema_name>/mcp-servers/<mcp_server_name>

מנהל Snowflake

היקף תפקיד ראשי

session:role:<mcp_access_role>

מנהל Snowflake

כתובת URI להפניה מחדש

העתק את ה-URI ש-Notion מייצרת

מנהל סביבת העבודה של Notion

מזהה לקוח OAuth

אחזר מ-Snowflake

מנהל Snowflake

סוד לקוח של OAuth

העבר דרך ערוץ מאובטח מאושר

מנהל Snowflake

שם המארח של החשבון משתמש במקפים, לא בקו תחתי. ודא שכל שם אובייקט בכתובת ה-URL של השרת תואם לשם האובייקט המתאים ב-Snowflake.

השתמש בתפקיד ייעודי בעל הרשאות מינימליות ובמחסן מאושר אחד בכל עת שניתן.

תפקיד מוגבל ללא תפקידים משניים (מומלץ). מודל זה קל יותר להבנה ולביקורת. הגדר OAUTH_USE_SECONDARY_ROLES = NONE, ציין ALLOWED_ROLES_LIST, והשתמש בהיקף (scope) של Notion‏ session:role:<mcp_access_role>.

תפקידים משניים המוגדרים כברירת מחדל של משתמש (אופציונלי). השתמש במודל זה רק כאשר השרת זקוק להרשאות שעברו בירושה מ-DEFAULT_SECONDARY_ROLES של Snowflake עבור כל משתמש. הגדר OAUTH_USE_SECONDARY_ROLES = IMPLICIT, השמט את ALLOWED_ROLES_LIST, והשתמש בהיקף (scope) של תפקיד ראשי מפורש. Snowflake אינה מאפשרת תפקידים משניים מסוג IMPLICIT עם ALLOWED_ROLES_LIST, לכן השמט את רשימת ההיתרים בעת השימוש במודל זה.

השתמש בתפקיד ייעודי בעל הרשאות מינימליות עבור שרת ה-MCP בכל עת שניתן.

הענק תפקיד זה באמצעות תהליך ניהול הזהויות הרגיל שלך. אם Okta או SCIM מנהלים את החברות בתפקידי Snowflake, אל תוסיף משתמשים באופן ידני מחוץ לתהליך זה.

צור או בחר מאגר ידע וסכימה בבעלות הצוות שיפעיל את השרת.

עבור שאלות עסקיות מנוהלות, באפשרותך לחשוף סוכן Cortex ככלי שבו משתמשים חברי הצוות. הוא שומר תצוגות סמנטיות, שאילתות מאומתות, חיפוש ותזמור במקום אחד. סוכן Cortex הוא אופציונלי. אם תיצור אחד, השתמש במפרט שלהלן. אם תחליף סוכן קיים, ודא שהחלופה תואמת למפרט המאושר שלך.

execution_environment חייב להישאר מקונן תחת משאב כלי ה-Analyst.

אם תציבו את warehouse ברמה העליונה, הגדרת הסוכן עשויה להיווצר, אך לכלי לא יהיה מחסן ביצוע (execution warehouse) בזמן הריצה.

סוגי כלי MCP אחרים הנתמכים ב-Snowflake כוללים CORTEX_ANALYST_MESSAGE, CORTEX_SEARCH_SERVICE_QUERY, GENERIC ו-SYSTEM_EXECUTE_SQL.

אם דרושה לך גישה ישירה ל-SQL, מקם אותה בשרת MCP נפרד עם תפקיד בעל הרשאות מינימליות משלו, וודא שהתפקיד הזה הוא לקריאה בלבד.

הוספת 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 יוצרת את מזהה הלקוח והסוד, מנהל סביבת העבודה יכול לסיים את הגדרת החיבור.

השתמש ב-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. נתיב ה-API שמטפל בקריאות חוזרות של OAuth ומחליף קודי אימות

  2. נתיב זמן הריצה של סביבת העבודה שמאמת את החיבור, מריץ כלים ומרענן אסימונים

נתיבים אלו עשויים להשתמש בכתובות יציאה שונות של Notion. אם תאפשר רק את הכתובת ששימשה במהלך החלפת האסימון הראשונית, הכניסה עשויה להצליח, אך האימות או רענון האסימון עלולים להיכשל. השתמש בטווחי היציאה הנוכחיים והמאושרים של Notion. אל תוסיף כתובת IP חד-פעמית מדפדפן או מיומן לרשימת היתרים של ייצור.

צרף מדיניות רשת זו לאינטגרציית ה-OAuth, לא למשתמשים בודדים. אל תשנה את המדיניות הכלל-חשבונית שלך עבור כניסה לדפדפן, גישת VPN או גישת רשת של משתמשים. אם מדיניות רשת מבצעת בלוק לבקשת אסימון, Snowflake עשויה להחזיר invalid_client. שגיאה זו לא בהכרח אומרת שמזהה הלקוח או הסוד אינם נכונים.

הרצה זאת בגיליון עבודה מאובטח של Snowflake. שם האינטגרציה תלוי רישיות ובדרך כלל הוא באותיות רישיות:

שתף את מזהה הלקוח ואת הסוד התואם שלו עם מנהל סביבת העבודה של Notion באמצעות ערוץ מאובטח מאושר. Snowflake מספקת שני סודות תקפים, כך שתוכל להחליף ביניהם ללא זמן השבתה. לעולם אל תדביק אף אחד מהסודות בתיעוד, בצ'אט, בכרטיסים או בבקרת מקור.

חיבורי MCP המוגדרים בסביבת עבודה הם תכונה שנמצאת כרגע בשלב אלפא.

אם לסביבת העבודה שלכם עדיין אין גישה, צרו קשר עם צוות התמיכה בחשבון או הגישו בקשה לתוכנית גישה מוקדמת לסוכני הנתונים שלנו.

ברגע ש-Snowflake מוכנה, בעלים או מנהל של סביבת העבודה מוסיף את השרת פעם אחת עבור סביבת העבודה. לאחר מכן, חברים יכולים למצוא אותו מבלי לראות את סוד הלקוח של ה-OAuth, בין אם הם מחברים את ה-MCP של Snowflake לסוכן מותאם אישית או לסוכן Notion משלהם.

  1. עבור אל הגדרות עבור סביבת העבודה.

  2. בחר חיבורים → MCPs משותפים של סביבת העבודה.

  3. בחר MCP לסביבת עבודה חדשה.

מלא שדות אלו, ולאחר מכן בחר הוסף שרת MCP:

שדה

מה להזין

שם

שם ברור המיועד לחבר/ה, כגון סוכן נתוני Snowflake של החברה.

תיאור

הערה קצרה על הנתונים ועל האופן שבו הם אמורים לשמש.

כתובת URL של השרת

כתובת ה-URL הציבורית המדויקת של ה-MCP של Snowflake מתוך גליון העבודה.

להגדיר את תצורת האימות באופן ידני

הפעל. Notion תגלה את פרטי ה-OAuth של Snowflake.

שימוש בלקוח OAuth משותף לסביבת העבודה

הפעלה.

כתובת URI להפניה מחדש

נוצר על ידי Notion. ודא שהוא תואם ל-URI שנתת למנהל המערכת של Snowflake.

מזהה לקוח

מזהה הלקוח מאינטגרציית ה-OAuth של Snowflake.

סוד הלקוח

הסוד התואם שקיבלת דרך ערוץ הסודות המאושר.

היקפי OAuth

בחר את היקף ה-session:role:<mcp_access_role> המדויק. All scopes תקין רק כאשר Snowflake מפרסמת היקף מאושר אחד בלבד ולא שום דבר רחב יותר.

לאחר השמירה, ודא שהשורה החדשה מופיעה תחת Shared with this workspace ושהערך Workspace OAuth client מציג Configured.

מה הגדרה זו עושה:

  • עוזרת לחבר/ה למצוא את השרת המאושר.

  • שומרת את סוד הלקוח של OAuth פעם אחת באחסון החיבורים המוצפן של Notion.

  • מוודאת שחברים נכנסים באמצעות כתובת ה-URL של השרת, הלקוח וההיקפים שאישרת.

  • אינה יוצרת הפעלת Snowflake משותפת ואינה עוקפת את בקרות הגישה של Snowflake.

  • אינה מחברת כל חבר באופן אוטומטי. כל אדם חייב להיכנס בנפרד.

אם תסיר הגדרה זו, חברים חדשים לא יוכלו עוד למצוא את השרת. חיבורים קיימים עשויים עדיין להופיע, לכן תאם שינוי זה עם ביטול הרשאות ב-Snowflake והסרת חיבורים קיימים.

ברגע שמנהלי המערכת שלך הכינו את חיבור ה-MCP של Snowflake, ישנן שתי דרכים להשתמש בו. אם אתה מגדיר זאת עבור צוות, התחל ב-11A. אם אתה רק רוצה לשאול שאלות משלך, דלג ל-11B. אתה יכול לעשות את שניהם; אלו חיבורים נפרדים.

סוכנים בהתאמה אישית מעניקים לצוות שלך מקום אחד לשאול בו על נתוני Snowflake. אתה מחבר את Snowflake פעם אחת, מוסיף הוראות לגבי המדדים והטבלאות שלך, ומשתף את הסוכן עם הצוות שלך. כל מי שישתמש בו יידרש להיכנס ל-Snowflake עם אישורי הכניסה שלו, כך שכל אדם יקבל תשובות המבוססות רק על הנתונים שהוא מורשה לראות.

אימות אישי בסוכנים בהתאמה אישית נמצא כרגע בשלב אלפא.

אם לסביבת העבודה שלכם עדיין אין גישה, צרו קשר עם צוות התמיכה בחשבון או הגישו בקשה לתוכנית גישה מוקדמת לסוכני הנתונים שלנו.

חבר את Snowflake לסוכנים בהתאמה אישית

  1. פתח את סוכנים בהתאמה אישית שלך, או צור אחד חדש.

  2. עבור אל הגדרות → כלים וגישה.

  3. בחר ב-Add connection, ולאחר מכן בחר בשרת Snowflake המסומן כ-Workspace Managed. אל תבחר ב-Custom MCP server ואל תזין את כתובת ה-URL של השרת באופן ידני.

  4. היכנס ל-Snowflake בדפדפן שלך. ייתכן שיופיע תהליך הכניסה הרגיל של הארגון שלך דרך Okta או SSO.

  5. סקור ואשר את תפקיד ה-Snowflake המבוקש.

  6. בחר באילו כלים הסוכן יכול להשתמש. השאר כלים בעלי יכולת כתיבה ואת CORTEX_AGENT_RUN מוגדרים לבקשת אישור עד שתבדוק אותם.

  7. בחר ב-Connect, ואשר שהחיבור מופיע כ-Connected.

תן לסוכן הקשר

החיבור מעניק לסוכן גישה ל-Snowflake. ההוראות שלך אומרות לו כיצד החברה שלך משתמשת בנתונים אלו. בהוראות של הסוכן, תאר באילו כלים להשתמש עבור אילו סוגי שאלות, כיצד הצוות שלך מגדיר מדדי מפתח, ומאילו טבלאות או תצוגות סמנטיות להתחיל. כמה שאלות דוגמה מאומתות עושות דרך ארוכה. לנקודת התחלה מוכנה, עיין במדריך ערכת הכלים של Data Scout.

שתף את הסוכן

שתף את הסוכן עם הצוות שלך באותו אופן שבו אתה משתף כל סוכנים בהתאמה אישית. בפעם הראשונה שמישהו ישאל אותו שאלה שזקוקה ל-Snowflake, הוא יתבקש להיכנס עם חשבון ה-Snowflake שלו. הוא לא יתבקש לספק מזהה לקוח או סוד.

אימות אישי חל כאשר מישהו משוחח עם הסוכן ישירות.

הרצות מתוזמנות ומופעלות באמצעות טריגרים אינן כוללות אדם מחובר, ולכן הן עדיין לא יכולות להשתמש בגישת Snowflake של אף אחד. אם אתם זקוקים לנתוני Snowflake לפי לוח זמנים, דברו עם מנהל ה-Snowflake שלכם לפני שתגדירו זאת.

אם ברצונך לשאול שאלות משלך בצ'אט משלך, חבר את Snowflake לסוכן ה-Notion שלך. אתה נכנס עם חשבון ה-Snowflake שלך, כך שהסוכן שלך מגיע רק למה שאתה מורשה לראות.

  1. עבור אל הגדרות → Notion AI.

  2. תחת שרתי MCP, בחר ב-הוסף שרת MCP.

  3. בחר בשרת Snowflake המסומן כ-Workspace Managed. אל תבחר ב-Custom MCP server ואל תזין את כתובת ה-URL של השרת באופן ידני.

  4. בחר ב-Connect.

  5. היכנס ל-Snowflake בדפדפן שלך. ייתכן שיופיע תהליך הכניסה הרגיל של הארגון שלך דרך Okta או SSO.

  6. סקור ואשר את תפקיד ה-Snowflake המבוקש.

  7. כאשר הדפדפן שלך שואל אם לפתוח את Notion, בחר ב-Open Notion.

  8. וודא שסטטוס השרת הוא מחובר, לא זקוק לאימות.

לאחר שתתחבר, Snowflake יופיע ב-כל המקורות → שרתי MCP בצ'אט.

לא אמורים לבקש ממך מזהה לקוח או סוד OAuth באף אחד מהנתיבים.

אם Notion מבקש אחד מהם, ייתכן שבחרתם באפשרות ה-MCP לסוכנים בהתאמה אישית במקום בשרת המנוהל על ידי סביבת עבודה, או שהמנהל שלכם לא הפעיל את השתמש בלקוח OAuth משותף לסביבת עבודה. חזרו ובחרו בשרת מנוהל על ידי סביבת עבודה במקום זאת.

  1. שאל שאלה לא מזיקה עם תשובה ידועה שאמורה להשתמש ב-Snowflake.

  2. וודא שהסוכן משתמש ב-Snowflake ומחזיר תוצאה.

  3. וודא שאינך יכול לגשת לנתונים מחוץ לתפקיד שניתן לך.

אם הגדרת סוכנים בהתאמה אישית, גם בקש מחברי צוות עם תפקיד Snowflake מצומצם יותר לנסות אותם. הם אמורים לראות רק את הנתונים שלהם, לא את שלך. זו הדרך המהירה ביותר לוודא שסוכנים בהתאמה אישית משתמשים בגישת כל אדם ולא בגישת הבונה.

לבדיקה מעמיקה יותר, בקש ממנהל ה-Snowflake שלך לאשר את המשתמש, התפקיד, ה-warehouse והיסטוריית השאילתות שלך. כניסה מוצלחת מאשרת את זהותך, אך היא לא מאשרת שכל הרשאה היא נכונה.

שאל את הסוכן שאלה ספציפית לגבי נתוני ה-Snowflake שלך. לדוגמה:

  • "מ-Snowflake, מה היו סך ההרשמות שלנו בחודש שעבר?"

  • "מ-Snowflake, מה היו 10 החשבונות בעלי ההכנסה הגבוהה ביותר שלנו ברבעון זה?"

עם סוכנים בהתאמה אישית, בדרך כלל ניתן לדלג על "מ-Snowflake" ברגע שההוראות שלהם מבהירות מתי להשתמש בו. עם סוכן Notion שלך, ציון Snowflake עוזר לסוכן לבחור את המקור הנכון.

בקשות גדולות עלולות לקחת זמן רב יותר או להסתיים בזמן קצוב. אם זה קורה, שאל שאלה מצומצמת יותר או פצל את הבקשה לשאלות קטנות יותר.

ברוב המקרים, אתה נשאר מחובר מבלי לעשות דבר. Snowflake משתמש באסימוני גישה לטווח קצר, ו-Notion מרענן אותם ברקע. אסימון גישה שפג תוקפו כשלעצמו לא ינתק אותך.

תצטרך להיכנס שוב אם:

  • אסימון הרענון שלך פג תוקף או שמנהל מערכת ביטל אותו

  • מנהל מערכת החליף את אינטגרציית ה-OAuth או את ה-client secret

  • תפקיד ה-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 שלך.

  • כתובת השרת נראית כפולה, כמו https://https%3A... הכתובת הודבקה עם https:// נוסף בהתחלה. תקן זאת כך שהכתובת תתחיל עם https:// אחד בלבד.

  • אתה רואה "שרת זה אינו תומך באימות OAuth." אינטגרציית האבטחה אינה מוגדרת עבור OAuth, או שכתובת השרת שגויה. בקש ממנהל ה-Snowflake שלך לבדוק את אינטגרציית אבטחת ה-OAuth ואת כתובת השרת.

  • אתה רואה invalid_client בזמן כניסה או רענון. מזהה הלקוח או הסוד שגויים, או שהסוד השתנה. בקש מהמנהל שלך את מזהה הלקוח והסוד הנוכחיים.

  • ההתחברות מצליחה, אך נכשלת מיד לאחר מכן. ייתכן שהתפקיד שלך לא מגיע לשרת, או שתפקיד או כלל רשת חוסמים את ההפעלה. בקש מהמנהל שלך לבדוק את ההרשאות והמדיניות שלך.

  • אתה רואה את "The role ALL requested has been explicitly blocked." החיבור ביקש את כל התפקידים בבת אחת (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.

תצוגות ACCOUNT_USAGE עלולות להשתהות, לכן שורה חסרה אינה הוכחה לכך שבקשה מעולם לא התרחשה.

החלפות סודות, החלשת מדיניות והרחבת הרשאות מומלץ להימנע מהן עד שתזהו איזו שכבה נכשלת.

השתמש במדריכי Snowflake אלו כדי להשלים את ההגדרה:


שאלות נפוצות

האם עלי להגדיר סוכנים בהתאמה אישית או לחבר את Snowflake לסוכן Notion שלי?

אם אתם מגדירים את חיבור ה-Snowflake MCP עבור הצוות שלכם, כדאי לבנות סוכנים בהתאמה אישית. הם מספקים לכולם את אותן ההוראות, את אותן ההגדרות של המדדים ומרכז לפניות, בעוד שכל אדם עדיין נכנס עם אישורי ה-Snowflake שלו. אם אתם מעדיפים לשאול שאלות אישיות בלבד, חברו את ה-Snowflake MCP לסוכן Notion שלכם. ניתן לשלב את שתי האפשרויות.

האם חיבור Snowflake לסוכן Notion שלי מחבר אותו גם לסוכנים בהתאמה אישית שלנו?

לא. כל אחד מהם הוא חיבור נפרד, וכל סוכן בהתאמה אישית זקוק לחיבור משלו. הגדרת ה-Snowflake משלבים 1–10 היא משותפת; ההתחברות אינה משותפת.

האם כולם בצוות רואים את אותם הנתונים?

לא. כל אדם נכנס ל-Snowflake עם האישורים שלו, והסוכן יכול להגיע רק למה שאותו חשבון מאפשר. זה נכון גם עבור סוכן בהתאמה אישית.

האם אני צריך לשתף את סיסמת ה-Snowflake שלי עם הצוות שלי?

לא. אף אחד לא משתף אישורים. סביבת העבודה שומרת את פרטי לקוח ה-OAuth פעם אחת, וכל אדם נכנס ל-Snowflake בעצמו.


מתן משוב

האם המשאב הזה היה שימושי?