מדריך זה מיועד למנהלי workspace ב-ChatGPT ולמשתמשי ChatGPT Plus או Pro שרוצים לחבר את ChatGPT ל-Snowflake דרך שרת MCP בניהול Snowflake.
רוב ההגדרות מתבצעות ב-Snowflake. לאחר ש-Snowflake מוכן, השלימו את חיבור תבנית Snowflake ב-ChatGPT, ואז הפעילו את תוסף Snowflake שמשתמש בתבנית הזו.
OAuth מובנה: כאשר האפשרות זמינה בחשבון Snowflake שלכם וב-ChatGPT, השתמשו באפליקציית השותף של ChatGPT שהופעלה על ידי מנהל Snowflake. היכנסו ל-Snowflake באמצעות ה-SSO של הארגון, אם הוא מוגדר. אין צורך להזין מזהה לקוח או סוד לקוח ב-ChatGPT. פעלו לפי ההוראות בסעיף OAuth מובנה בהמשך.
לקוח OAuth מותאם אישית: בחרו באפשרות זו אם הארגון שלכם דורש לקוח OAuth משלו או אם OAuth מובנה אינו זמין. פעלו לפי ההוראות בסעיף לקוח OAuth מותאם אישית בהמשך.
שתי אפשרויות ה-OAuth דורשות את הגדרת שרת ה-MCP המשותפת, את ההרשאות לאובייקטים שבשימוש ואת הגישה לרשת שמתוארות בהמשך. לפני הגדרת OAuth, השלימו את שלבי ההגדרה המשותפים עד לסעיף הזנת פרטי שרת Snowflake ב-ChatGPT, כולל סעיף זה.
מה מגדירים
אתם יוצרים שרת MCP בניהול Snowflake שישמש כ-endpoint של MCP עבור ChatGPT. שרת ה-MCP מגדיר:
באילו פעולות ChatGPT יכול להשתמש.
לאילו נתונים או אובייקטים ב-Snowflake הכלים האלה יכולים לגשת.
באיזה תפקיד Snowflake משתמש כל משתמש בעת מתן הרשאה.
אילו מסד נתונים, סכמה ושם שרת MCP ב-Snowflake מזהים את ה-endpoint.
לאחר מכן מגדירים את Snowflake - תבנית רשמית ב-ChatGPT באמצעות כתובת ה-URL המלאה של שרת ה-MCP המנוהל. מסך הגדרת התבנית עשוי להציג את כתובת ה-URL בארבעה שדות נפרדים:
קידומת המארח של Snowflake.
מסד נתונים.
סכמה.
שם שרת MCP.
ChatGPT יכול לגלות ולהשתמש רק בכלים שנחשפים על ידי שרת ה-MCP ומותרים לפי תפקיד Snowflake שבו המשתמש נותן הרשאה.
לפני שמתחילים
נדרשים:
גישת מנהל או בעלים של workspace ב-ChatGPT, או גישה ל-ChatGPT Plus או Pro.
גישה ל-Snowflake שמאפשרת ליצור אובייקטים של שרת MCP ולהעניק הרשאות.
מסד הנתונים והסכמה ב-Snowflake שבהם ימוקם שרת ה-MCP.
החלטה מה יורשה ל-ChatGPT לעשות, למשל שימוש ב-Cortex Search, ב-Cortex Analyst, ב-SQL לקריאה בלבד או בפרוצדורה או פונקציה מסוימת.
תפקיד ב-Snowflake עם ההרשאות המזעריות הנחוצות, שבו ישתמשו המשתמשים בעת מתן הרשאה לאפליקציה.
קידומת המארח של חשבון Snowflake, כולל סיומת אזור או ענן, אם קיימת.
אם חשבון Snowflake שלכם מגביל גישה באמצעות מדיניות רשת או רשימת כתובות IP מורשות, בקשו ממנהל Snowflake לאפשר חיבורים נכנסים מטווחי כתובות ה-IP היוצאות של אפליקציות ChatGPT העדכניים. הרשימה משתנה ויש לשמור אותה מעודכנת.
ערכים שיש להכין
קידומת המארח של Snowflake: כל מה שמופיע לפני .snowflakecomputing.com בכתובת ה-URL של חשבון Snowflake.
מסד נתונים: מסד הנתונים שמכיל את שרת ה-MCP.
סכמה: הסכמה שמכילה את שרת ה-MCP.
שם שרת MCP: שם האובייקט של שרת ה-MCP ב-Snowflake.
כתובת ה-URL המלאה של שרת ה-MCP המנוהל, אם מסך ההגדרה של ChatGPT מבקש כתובת URL.
תפקיד Snowflake: התפקיד שבו המשתמשים צריכים להשתמש בעת מתן הרשאה לאפליקציה.
רשימת כלים: האובייקטים והפעולות ב-Snowflake שבהם תרצו ש-ChatGPT ישתמש.
החלטה מה ChatGPT יוכל לעשות
בחרו רק את היכולות שברצונכם לחשוף. אפשרויות נפוצות כוללות:
חיפוש באמצעות Cortex Search למציאת תשובות בנתונים או בתוכן מאונדקסים ב-Snowflake.
שאלות ותשובות עם Cortex Analyst דרך תצוגה סמנטית מאושרת.
SQL לקריאה בלבד לצורך גישה מבוקרת באמצעות שאילתות.
סוכן Snowflake, פרוצדורה מאוחסנת או UDF לתהליך עבודה מסוים.
אם אתם מאפשרים שימוש ב-SQL, השאירו אותו במצב קריאה בלבד, אלא אם הארגון שלכם בדק ואישר גישת כתיבה.
פתיחת גיליון עבודה ב-Snowflake
היכנסו לאפליקציית Snowflake.
עברו לתפקיד שמאפשר ליצור את שרת ה-MCP ולהעניק גישה.
עברו אל סביבות עבודה.

צרו סביבת עבודה עם קובץ SQL.

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

יצירת שרת ה-MCP ב-Snowflake
היכנסו ל-Snowflake עם תפקיד שמאפשר ליצור את שרת ה-MCP ולהעניק גישה. פתחו גיליון עבודה במסד הנתונים ובסכמה שבהם יש ליצור את שרת ה-MCP.
הריצו פקודה כמו בדוגמה הבאה. החליפו את השמות בשמות של מסד הנתונים, הסכמה, השירותים, התצוגות, מחסן החישוב והשרת שלכם ב-Snowflake.
CREATE MCP SERVER CHATGPT_SNOWFLAKE_MCP FROM SPECIFICATION $$ tools: - name: "support-search" type: "CORTEX_SEARCH_SERVICE_QUERY" identifier: "CHATGPT_APPS.TOOLS.SUPPORT_SEARCH_SERVICE" title: "Support Search" description: "Search support content for relevant customer issues." - name: "revenue-analyst" type: "CORTEX_ANALYST_MESSAGE" identifier: "CHATGPT_APPS.TOOLS.REVENUE_SEMANTIC_VIEW" title: "Revenue Analyst" description: "Answer revenue questions using the approved semantic view." - name: "sql-readonly" type: "SYSTEM_EXECUTE_SQL" title: "Read-only SQL" description: "Run read-only SQL queries against approved Snowflake data." config: read_only: true query_timeout: 600 warehouse: "CHATGPT_WH" $$;

שמות הכלים והאובייקטים של Snowflake בפקודה זו הם דוגמאות:
support-searchחושף את שירות Cortex Search שצוין.revenue-analystחושף את התצוגה הסמנטית שצוינה. הוסיפו כלים לתצוגות אחרות לפי הצורך.sql-readonlyמאפשר שימוש ב-SQL לקריאה בלבד באמצעות מחסן החישוב שצוין.
השתמשו בשמות קבועים ותיאוריים לכלים, כדי ש-ChatGPT יוכל לבחור את הכלי המתאים. יצירת שרת ה-MCP אינה מעניקה אוטומטית גישה לאובייקטים של Snowflake שבהם הוא משתמש.
לאפשרויות נוספות במפרט, ראו: יצירת שרת MCP בניהול Snowflake.
הענקת ההרשאות המתאימות ב-Snowflake
בחרו את תפקיד Snowflake שבו המשתמשים ייתנו הרשאה, ואז העניקו לתפקיד הזה גישה אל:
מסד הנתונים והסכמה.
שרת ה-MCP.
כל אובייקט שבו הכלים משתמשים, למשל שירות חיפוש, תצוגה סמנטית או מחסן חישוב.
דוגמה:
GRANT USAGE ON DATABASE CHATGPT_APPS TO ROLE CHATGPT_CONNECTOR_ROLE;GRANT USAGE ON SCHEMA CHATGPT_APPS.TOOLS TO ROLE CHATGPT_CONNECTOR_ROLE;GRANT USAGE ON MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP TO ROLE CHATGPT_CONNECTOR_ROLE;
GRANT USAGE ON CORTEX SEARCH SERVICE CHATGPT_APPS.TOOLS.SUPPORT_SEARCH_SERVICE TO ROLE CHATGPT_CONNECTOR_ROLE;GRANT SELECT ON SEMANTIC VIEW CHATGPT_APPS.TOOLS.REVENUE_SEMANTIC_VIEW TO ROLE CHATGPT_CONNECTOR_ROLE;GRANT USAGE ON WAREHOUSE CHATGPT_WH TO ROLE CHATGPT_CONNECTOR_ROLE;
אם שרת ה-MCP חושף UDF, פרוצדורה מאוחסנת או סוכן Cortex, העניקו את ההרשאות הנדרשות גם לאובייקט הזה.
בדיקה ש-Snowflake מוכן
הריצו:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
לאחר מכן הריצו:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
ודאו:
השרת קיים במסד הנתונים ובסכמה הצפויים.
רשימת הכלים תואמת למה שהתכוונתם.
הערך
identifierשל כל כלי מצביע על האובייקט הנכון ב-Snowflake.לתפקיד המשמש לחיבור יש הרשאת
USAGEבשרת ה-MCP.לתפקיד המשמש לחיבור יש את ההרשאות הנדרשות בכל אובייקט שבו הכלים משתמשים.
הזנת פרטי שרת Snowflake ב-ChatGPT
להגדרה עבור workspace, פתחו את admin.openai.com, בחרו את ה-workspace הרצוי ב-ChatGPT ופתחו את תוספים. למידע על ניווט ב-workspace וגישה לאפליקציות מדור קודם, ראו בקרות ניהול, אבטחה ותאימות עבור תוספים ואפליקציות.
ב-ChatGPT, עברו לחשבון או ל-workspace שבהם האפליקציה אמורה להיות זמינה.
עברו אל הגדרות > תוספים להגדרה אישית, או אל מסוף הניהול > תוספים כמנהלי workspace להגדרה עבור ה-workspace.
חפשו את Snowflake.
הפעילו את Snowflake - תבנית רשמית.
פתחו את Snowflake - תבנית רשמית, הזינו שם ברור לחיבור ובחרו חיבור.
הזינו את כתובת ה-URL המלאה של שרת ה-MCP המנוהל:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
דוגמה:
https://myorg-myaccount.azure.snowflakecomputing.com/api/v2/databases/CHATGPT_APPS/schemas/TOOLS/mcp-servers/CHATGPT_SNOWFLAKE_MCP

אם מסך ההגדרה מציג את הגדרות Snowflake בשדות נפרדים, השתמשו באותם ערכים שמופיעים בכתובת ה-URL:
קידומת המארח של Snowflake
השתמשו בכל מה שמופיע לפני .snowflakecomputing.com בכתובת ה-URL של חשבון Snowflake שלכם, כולל סיומת אזור או ענן, אם קיימת.
לדוגמה, אם כתובת ה-URL של החשבון מתחילה כך:
https://myorg-myaccount.azure.snowflakecomputing.com
קידומת המארח היא:
myorg-myaccount.azure
מסד נתונים
הזינו את מסד הנתונים שמכיל את שרת ה-MCP, למשל:
CHATGPT_APPS
סכמה
הזינו את הסכמה שמכילה את שרת ה-MCP, למשל:
TOOLS
שם שרת MCP
הזינו את שם האובייקט של שרת ה-MCP ב-Snowflake, למשל:
CHATGPT_SNOWFLAKE_MCP
הגדרת OAuth
בחרו באפשרות ה-OAuth שזמינה בחשבון שלכם ועומדת בדרישות הארגון. שתי האפשרויות משתמשות בהגדרת שרת ה-MCP המשותפת שלעיל ובבדיקות החיבור ובבקרות הגישה שבהמשך.
בשתי אפשרויות ה-OAuth, בעת שימוש ב-session:role:all, Snowflake משתמש בתפקיד ברירת המחדל של כל משתמש. תפקיד ברירת המחדל חייב להיות מותר ברשימת התפקידים המורשים של אינטגרציית ה-OAuth, אם היא מוגדרת, ואסור שיהיה חסום. אם יש לכם תפקיד מאושר נוסף, הוא לא ייבחר אוטומטית.
OAuth מובנה
לפני שתמשיכו, השלימו את הסעיפים המשותפים שלעיל כדי ליצור את שרת ה-MCP, להעניק הרשאות, לבדוק את השרת ולהזין את פרטיו ב-ChatGPT. יש לעשות זאת גם אם הגעתם ישירות לסעיף הזה.
השתמשו באפשרות זו רק כאשר אפליקציית השותף של ChatGPT זמינה בחשבון Snowflake שלכם, ו-OAuth מובנה זמין בחלון ההגדרה של ChatGPT.
בקשו ממנהל Snowflake להפעיל את אינטגרציית השותף של ChatGPT באותו חשבון Snowflake שמארח את שרת ה-MCP. השתמשו באינטגרציית שותף קיימת ומופעלת של ChatGPT.
בחלון ההגדרה של ChatGPT, השתמשו ב-OAuth מובנה. אין צורך להזין מזהה לקוח או סוד לקוח, או לרשום כתובת URL לחזרה.
המשיכו לסעיף חיבור וניהול של Snowflake בהמשך כדי להיכנס, לתת הסכמה ולהגדיר גישה. לאחר מכן השלימו את הסעיף בדיקת האפליקציה, כולל בדיקות עם חברים מורשים שאינם מנהלים.
הכללים שתוארו לעיל לגבי תפקיד ברירת המחדל, רשימת התפקידים המורשים והתפקידים החסומים חלים גם על אפשרות זו.
לקוח OAuth מותאם אישית
לפני שתמשיכו, השלימו את הסעיפים המשותפים שלעיל כדי ליצור את שרת ה-MCP, להעניק הרשאות, לבדוק את השרת ולהזין את פרטיו ב-ChatGPT. יש לעשות זאת גם אם הגעתם ישירות לסעיף הזה.
ללקוח OAuth מותאם אישית נדרשים מזהה לקוח וסוד לקוח מ-Snowflake. הכללים שתוארו לעיל לגבי תפקיד ברירת המחדל, רשימת התפקידים המורשים והתפקידים החסומים חלים גם על אפשרות זו.
בחלון ההגדרה של ChatGPT, בחרו הגדרות OAuth מתקדמות > לקוח OAuth בהגדרת המשתמש, והעתיקו במדויק את כתובת ה-URL לחזרה המוצגת ב-ChatGPT.
צרו אינטגרציית אבטחה מותאמת אישית של OAuth עם
OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'והגדירו אתOAUTH_REDIRECT_URIלאותה כתובת URL לחזרה בדיוק.הריצו את הפקודה הבאה ב-Snowflake, וכתבו את שם האינטגרציה באותיות גדולות:
SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');מתוך תוצאת ה-JSON, הדביקו ב-ChatGPT את
oauth_client_idבשדה מזהה לקוח OAuth ואתoauth_client_secretבשדה סוד לקוח OAuth.הגדירו את שיטת האימות של endpoint האסימון לערך
client_secret_basic.
לאחר הזנת פרטי האימות של הלקוח המותאם אישית, המשיכו לסעיפים חיבור וניהול של Snowflake ובדיקת האפליקציה בהמשך.
חיבור וניהול של Snowflake
בשתי אפשרויות ה-OAuth, באותו חלון הגדרה של ChatGPT, בחרו המשך, היכנסו ל-Snowflake ואשרו את החיבור. אפשר להשתמש ב-SSO של הארגון אם הוא מוגדר.
בהגדרה עבור workspace, ודאו שגם Snowflake וגם Snowflake - תבנית רשמית מופעלים. ב-Enterprise וב-Edu, הגדירו את מדיניות ההתקנה של התוסף ואת גישת המשתמשים בכל אפליקציה הכלולה בו, עבור התפקידים שהוקצו לחברים או לקבוצות הרלוונטיים. ב-Business, נהלו את מדיניות התקנת התוספים ואת זמינות האפליקציות בכל ה-workspace.
מנהלי ה-workspace אחראים לבדוק את בקרת הפעולות עבור הכלים שנחשפו.
מנהלי ה-workspace אחראים לבדוק את הרשאות האפליקציה כדי לבחור מתי ChatGPT יבקש אישור מהחברים לפני השימוש באפליקציה.
הרשאות האפליקציה האלה חלות על שיחות ב-ChatGPT. סוכני workspace משתמשים בבקרות שיוצר הסוכן מגדיר לכל סוכן בנפרד, כדי לקבוע אילו פעולות של האפליקציה זמינות ומתי משתמשי הקצה מתבקשים לאשר אותן. למידע על אופן הפעולה של סוכנים, ראו: סוכני workspace ב-ChatGPT עבור Enterprise ו-Business.
בדיקת האפליקציה
פתחו שיחה, בחרו Snowflake ובדקו את החיבור.
ודאו ש-ChatGPT מגלה את הכלים שהגדרתם.
תחילה הריצו פעולת קריאה בסיכון נמוך, למשל חיפוש או שאילתה לקריאה בלבד על נתונים מאושרים.
ודאו שההרשאות ב-Snowflake מונעות גישה שחורגת מהתפקיד ומהאובייקטים שאושרו.
בהגדרה עבור workspace, בצעו בדיקות עם חברים מורשים שאינם מנהלים ושיש להם תפקידי ברירת מחדל שונים ב-Snowflake. חיבור מוצלח של מנהל אינו מעיד שכל חבר יכול להתחבר.
למנהלי workspace, הפעלת Snowflake בלבד אינה מספיקה. אם Snowflake - תבנית רשמית לא הופעלה וחוברה, התוסף עשוי להופיע כמושבת אצל החברים.
כתובת ה-URL של שרת ה-MCP ואופן הפעולה של OAuth
ChatGPT מתחבר לכתובת ה-URL המלאה של שרת ה-MCP בניהול Snowflake:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
ChatGPT משתמש בקידומת המארח של Snowflake מתוך כתובת ה-URL הזו כדי לקבוע את כתובות ה-endpoint הבאות של OAuth ב-Snowflake:
הרשאה:
https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/authorizeאסימון:
https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/token-request
אל תדביקו כתובת URL של Snowsight, את כתובת הבסיס של חשבון Snowflake לבדה או כתובת URL עם מקטעי נתיב נוספים. כתובת ה-URL של MCP חייבת לכלול את /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server} ולהתאים בדיוק לאובייקטים שלכם ב-Snowflake.
פתרון בעיות
Snowflake מופעל עבור מנהל אך מושבת עבור חבר
ודאו שגם Snowflake וגם Snowflake - תבנית רשמית מופעלים תחת מסוף הניהול > תוספים.
פתחו את Snowflake - תבנית רשמית והשלימו את תהליך החיבור שלה. הפעלת התבנית ללא חיבור שלה אינה מספיקה.
פתחו את Snowflake וודאו שהתבנית מופיעה כאפליקציה הנדרשת עבורו.
ודאו שהתפקיד או הקבוצה של החבר שנתקל בבעיה מורשים לפי מדיניות התקנת התוסף.
שרת ה-MCP לא נמצא
בדקו שוב את כתובת ה-URL המלאה של שרת ה-MCP, או את ארבעת שדות התבנית אם הם נדרשים במסך ההגדרה שלכם.
ודאו ששרת ה-MCP קיים בדיוק באותו מסד נתונים ובאותה סכמה.
לא מופיעים כלים ב-ChatGPT
ודאו שהמפרט של שרת ה-MCP כולל כלים.
ודאו שלתפקיד יש הרשאת
USAGEבשרת ה-MCP.
כלי מופיע אך נכשל בעת השימוש
ודאו שלתפקיד יש את ההרשאה הנדרשת באובייקט Snowflake שבו הכלי משתמש, למשל שירות החיפוש, התצוגה הסמנטית, מחסן החישוב, הפרוצדורה או ה-UDF.
כלי ה-SQL נכשל
ודאו ששם מחסן החישוב נכון ושמחסן החישוב פועל.
ודאו שלתפקיד יש הרשאת
USAGEבמחסן החישוב.ודאו שהוגדר
read_only: trueאם התכוונתם לאפשר גישה לקריאה בלבד.
התפקיד המבוקש ALL נחסם במפורש
בקשו ממנהל Snowflake להשוות את תפקיד ברירת המחדל שלכם לתפקידים המורשים והחסומים באינטגרציית ה-OAuth. אם יש לכם תפקיד מורשה נוסף, הוא לא ייבחר אוטומטית. אם מתאים, שנו את תפקיד ברירת המחדל לתפקיד מאושר והתחברו מחדש. שינוי תפקיד ברירת המחדל משפיע גם על הפעלות Snowflake שלכם מחוץ ל-ChatGPT.
ההרשאה נכשלת
ודאו שהמשתמש יכול להיכנס ל-Snowflake.
בעת שימוש ב-
session:role:all, ודאו שתפקיד ברירת המחדל של המשתמש מותר באינטגרציית ה-OAuth.ודאו שההגדרה משתמשת בתהליך ה-OAuth של שרת MCP בניהול Snowflake.
אם אתם משתמשים בלקוח OAuth מותאם אישית, ודאו שמזהה הלקוח וסוד הלקוח תואמים לאינטגרציית ה-OAuth של Snowflake, וש-URI ההפניה שלה תואם בדיוק לכתובת ה-URL לחזרה המוצגת ב-ChatGPT.
אם אתם משתמשים ב-OAuth מובנה, בקשו ממנהל Snowflake לבדוק שאינטגרציית השותף של ChatGPT זמינה ומופעלת בחשבון שמארח את שרת ה-MCP.
מדיניות הרשת או רשימת כתובות ה-IP המורשות ב-Snowflake חוסמת את האפליקציה
בקשו ממנהל Snowflake לעדכן את מדיניות הרשת או את כללי הגישה ב-Snowflake.
אפשרו חיבורים נכנסים מטווחי כתובות ה-IP היוצאות של אפליקציות ChatGPT העדכניים.
הגדירו את רשימת הכתובות המורשות הזו ב-Snowflake. היא נפרדת מרשימת כתובות ה-IP המורשות של ה-workspace ב-ChatGPT.
במידת האפשר, הגדירו עדכונים אוטומטיים מתוך קובץ ה-JSON שפורסם, מכיוון שהטווחים עשויים להשתנות.
בעיית חיבור הקשורה לשם המארח
השתמשו בקידומת המארח הנכונה של Snowflake. שמות מארח ב-Snowflake שמכילים קווים תחתונים עלולים לגרום לבעיות; העדיפו מקפים.
