तुम्ही ChatGPT वर्कस्पेसचे प्रशासक किंवा ChatGPT Plus किंवा Pro वापरकर्ता असाल आणि Snowflake-व्यवस्थापित MCP सर्व्हरद्वारे ChatGPT ला Snowflake शी जोडू इच्छित असाल, तर हे मार्गदर्शक वापरा.

बहुतेक सेटअप Snowflake मध्ये केला जातो. Snowflake तयार झाल्यानंतर, ChatGPT मधील Snowflake टेम्प्लेटचे कनेक्शन पूर्ण करा आणि नंतर ते टेम्प्लेट वापरणारा Snowflake प्लगइन सुरू करा.

तुम्ही काय सेट करत आहात

तुम्ही Snowflake-व्यवस्थापित MCP सर्व्हर तयार करत आहात, जो ChatGPT साठी कनेक्टर एंडपॉइंट म्हणून काम करतो. MCP सर्व्हर पुढील बाबी निश्चित करतो:

• ChatGPT कोणत्या कृती वापरू शकते.

• ती साधने कोणता Snowflake डेटा किंवा ऑब्जेक्ट वापरू शकतात.

• प्रत्येक वापरकर्ता कोणत्या Snowflake भूमिकेद्वारे अधिकृत करतो.

• कोणता Snowflake डेटाबेस, स्कीमा आणि MCP सर्व्हरचे नाव एंडपॉइंट ओळखतात.

त्यानंतर संपूर्ण व्यवस्थापित MCP सर्व्हर URL वापरून ChatGPT मध्ये Snowflake - अधिकृत टेम्प्लेट कॉन्फिगर करा. टेम्प्लेट सेटअप स्क्रीनवर URL चार स्वतंत्र फील्डमध्ये दिसू शकतो:

• Snowflake होस्ट उपसर्ग.

• डेटाबेस.

• स्कीमा.

• MCP सर्व्हरचे नाव.

MCP सर्व्हरने उपलब्ध केलेली आणि वापरकर्त्याने अधिकृत केलेल्या Snowflake भूमिकेस अनुमती असलेली साधनेच ChatGPT शोधू व वापरू शकते.

सुरू करण्यापूर्वी

तुम्हाला पुढील गोष्टी आवश्यक आहेत:

• ChatGPT वर्कस्पेस प्रशासक किंवा मालक प्रवेश, अथवा ChatGPT Plus किंवा Pro प्रवेश.

• MCP सर्व्हर ऑब्जेक्ट तयार करण्याची आणि परवानग्या देण्याची क्षमता असलेला Snowflake प्रवेश.

• MCP सर्व्हर ज्या Snowflake डेटाबेस आणि स्कीमामध्ये असेल ते.

• ChatGPT ला काय करण्याची अनुमती असावी याचा निर्णय, उदा. Cortex Search, Cortex Analyst, केवळ-वाचन SQL किंवा विशिष्ट प्रक्रिया अथवा फंक्शन.

• अ‍ॅप अधिकृत करताना वापरकर्त्यांनी वापरायची किमान-विशेषाधिकार असलेली Snowflake भूमिका.

• कोणत्याही प्रदेश किंवा क्लाउड प्रत्ययासह Snowflake खात्याचा होस्ट उपसर्ग.

तुमच्या Snowflake खात्यात नेटवर्क धोरण किंवा IP अनुमतीसूचीद्वारे प्रवेश प्रतिबंधित असल्यास, सध्याच्या ChatGPT कनेक्टरच्या निर्गमन IP श्रेणींमधून येणाऱ्या कनेक्शनना अनुमती देण्यास Snowflake प्रशासकाला सांगा. ही सूची गतिशील आहे आणि ती अद्ययावत ठेवली पाहिजे.

तयार ठेवायची मूल्ये

• Snowflake होस्ट उपसर्ग: Snowflake खात्याच्या URL मधील .snowflakecomputing.com च्या आधीचा संपूर्ण भाग.

• डेटाबेस: MCP सर्व्हर असलेला डेटाबेस.

• स्कीमा: MCP सर्व्हर असलेला स्कीमा.

• MCP सर्व्हरचे नाव: Snowflake MCP सर्व्हर ऑब्जेक्टचे नाव.

• ChatGPT सेटअप स्क्रीनवर URL विचारला असल्यास, संपूर्ण व्यवस्थापित MCP सर्व्हर URL.

• Snowflake भूमिका: अ‍ॅप अधिकृत करताना वापरकर्त्यांनी वापरायची भूमिका.

• साधनांची सूची: ChatGPT ने वापरावेत असे Snowflake ऑब्जेक्ट आणि कृती.

ChatGPT काय करू शकते ते ठरवा

तुम्हाला उपलब्ध करायच्या असलेल्या क्षमताच निवडा. सामान्य पर्यायांमध्ये पुढील गोष्टी समाविष्ट आहेत:

• अनुक्रमित Snowflake डेटा किंवा आशयामध्ये उत्तरे शोधण्यासाठी Cortex Search वापरून शोध.

• मंजूर अर्थाधारित दृश्याद्वारे Cortex Analyst वापरून प्रश्नोत्तरे.

• नियंत्रित क्वेरी प्रवेशासाठी केवळ-वाचन SQL.

• विशिष्ट कार्यप्रवाहासाठी Snowflake एजंट, संग्रहित प्रक्रिया किंवा UDF.

तुम्ही SQL सुरू केल्यास, तुमच्या संस्थेने लेखन प्रवेशाचे पुनरावलोकन करून त्यास मंजुरी दिली नसेल, तर तो केवळ-वाचन ठेवा.

Snowflake वर्कशीट उघडा

1. Snowflake अ‍ॅपमध्ये साइन इन करा.

2. MCP सर्व्हर तयार करू शकणाऱ्या आणि प्रवेश देऊ शकणाऱ्या भूमिकेवर स्विच करा.

3. वर्कस्पेस वर जा.

   

4. SQL फाइलसह वर्कस्पेस तयार करा.

   

5. ज्या डेटाबेस आणि स्कीमामध्ये MCP सर्व्हर तयार केला जाईल, त्यानुसार वर्कस्पेसचा संदर्भ सेट करा.

   

Snowflake MCP सर्व्हर तयार करा

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 ऑब्जेक्टचा प्रवेश आपोआप मिळत नाही.

अतिरिक्त तपशील पर्यायांसाठी हे पहा: Snowflake-व्यवस्थापित MCP सर्व्हर तयार करा.

योग्य Snowflake परवानग्या द्या

वापरकर्ते ज्या Snowflake भूमिकेद्वारे अधिकृत करतील ती निवडा आणि त्या भूमिकेला पुढील गोष्टींचा प्रवेश द्या.

1. डेटाबेस आणि स्कीमा.

2. MCP सर्व्हर.

3. साधनांनी वापरलेले प्रत्येक अंतर्निहित ऑब्जेक्ट, उदा. शोध सेवा, अर्थाधारित दृश्य किंवा वेअरहाउस.

उदाहरण:

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 ऑब्जेक्टकडे निर्देश करतो.

• कनेक्ट करणाऱ्या भूमिकेकडे MCP सर्व्हरसाठी USAGE आहे.

• कनेक्ट करणाऱ्या भूमिकेकडे प्रत्येक अंतर्निहित ऑब्जेक्टसाठी आवश्यक परवानग्या आहेत.

ChatGPT मध्ये Snowflake सर्व्हरचे तपशील प्रविष्ट करा

1. ChatGPT मध्ये, ज्या खात्यात किंवा वर्कस्पेसमध्ये अ‍ॅप उपलब्ध असावे त्यावर स्विच करा.

2. सेटिंग्ज उघडा. संपूर्ण वर्कस्पेससाठी सेटअप करताना, वर्कस्पेस प्रशासक म्हणून वर्कस्पेस सेटिंग्ज उघडा.

3. प्लगइन वर जा.

4. Snowflake शोधा.

5. Snowflake - अधिकृत टेम्प्लेट सुरू करा.

6. Snowflake - अधिकृत टेम्प्लेट उघडा, स्पष्ट कनेक्शन नाव प्रविष्ट करा आणि कनेक्ट करा निवडा.

7. संपूर्ण व्यवस्थापित MCP सर्व्हर URL प्रविष्ट करा:

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 होस्ट उपसर्ग

तुमच्या Snowflake खात्याच्या URL मधील .snowflakecomputing.com च्या आधीचा संपूर्ण भाग वापरा. त्यात प्रदेश किंवा क्लाउड प्रत्यय असल्यास तोही समाविष्ट करा.

उदाहरणार्थ, खात्याचा URL पुढीलप्रमाणे सुरू होत असल्यास:

https://myorg-myaccount.azure.snowflakecomputing.com

होस्ट उपसर्ग असा आहे:

myorg-myaccount.azure

डेटाबेस

MCP सर्व्हर असलेला डेटाबेस प्रविष्ट करा, उदा.:

CHATGPT_APPS

स्कीमा

MCP सर्व्हर असलेला स्कीमा प्रविष्ट करा, उदा.:

TOOLS

MCP सर्व्हरचे नाव

Snowflake MCP सर्व्हर ऑब्जेक्टचे नाव प्रविष्ट करा, उदा.:

CHATGPT_SNOWFLAKE_MCP

OAuth क्लायंट कॉन्फिगर करा

कनेक्ट करण्यासाठी तुम्हाला Snowflake कडून क्लायंट आयडी आणि क्लायंट सिक्रेट आवश्यक आहे.

तुम्ही session:role:all वापरता तेव्हा Snowflake प्रत्येक वापरकर्त्याची डीफॉल्ट भूमिका वापरते. कॉन्फिगर केले असल्यास, डीफॉल्ट भूमिकेला OAuth एकत्रीकरणाच्या भूमिका अनुमतीसूचीत परवानगी असली पाहिजे आणि ती अवरोधित नसली पाहिजे. दुसरी मंजूर भूमिका असल्याने ती आपोआप निवडली जात नाही.

1. ChatGPT सेटअप संवादामध्ये प्रगत OAuth सेटिंग्ज उघडा, वापरकर्त्याने परिभाषित केलेला OAuth क्लायंट निवडा आणि ChatGPT मध्ये दिसणारा कॉलबॅक URL कॉपी करा.

2. OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' सह सानुकूल OAuth सुरक्षा एकत्रीकरण तयार करा आणि OAUTH_REDIRECT_URI त्या अचूक कॉलबॅक URL वर सेट करा.

3. एकत्रीकरणाचे नाव मोठ्या अक्षरांत वापरून Snowflake मध्ये पुढील विधान चालवा:

   SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');

4. JSON निकालामधील oauth_client_id ChatGPT मधील OAuth क्लायंट आयडी मध्ये आणि oauth_client_secret OAuth क्लायंट सिक्रेट मध्ये पेस्ट करा.

5. टोकन एंडपॉइंट प्रमाणीकरण पद्धत client_secret_basic वर सेट करा.

Snowflake कनेक्ट आणि व्यवस्थापित करा

1. त्याच ChatGPT सेटअप संवादामध्ये पुढे सुरू ठेवा निवडा, Snowflake मध्ये साइन इन करा आणि कनेक्शन अधिकृत करा.

2. वर्कस्पेस सेटअपसाठी, प्लगइन स्थापना धोरण आणि ते वापरणाऱ्या सदस्यांसाठी भूमिका किंवा गट प्रवेश कॉन्फिगर करा. Snowflake आणि Snowflake - अधिकृत टेम्प्लेट दोन्ही सुरू असल्याची खात्री करा.

3. Snowflake वापरणाऱ्या भूमिकांसाठी वापरकर्ता प्रवेश कॉन्फिगर करण्याची जबाबदारी वर्कस्पेस प्रशासकांची आहे.

4. उपलब्ध केलेल्या साधनांसाठी कृती नियंत्रण तपासण्याची जबाबदारी वर्कस्पेस प्रशासकांची आहे.

5. अ‍ॅप वापरण्यापूर्वी ChatGPT ने सदस्यांची अनुमती कधी मागावी हे निवडण्यासाठी अ‍ॅप परवानग्या तपासण्याची जबाबदारी वर्कस्पेस प्रशासकांची आहे.

या अ‍ॅप परवानग्या ChatGPT संभाषणांना लागू होतात. कोणत्या अ‍ॅप कृती उपलब्ध आहेत आणि अंतिम वापरकर्त्यांना त्या मंजूर करण्यास कधी विचारले जाते हे ठरवण्यासाठी वर्कस्पेस एजंट, एजंटच्या निर्मात्याने सेट केलेली प्रति-एजंट नियंत्रणे वापरतात. एजंटच्या वर्तनासाठी हे पहा: Enterprise आणि Business साठी ChatGPT वर्कस्पेस एजंट.

अ‍ॅपची चाचणी करा

1. चॅट उघडा, Snowflake निवडा आणि कनेक्शनची चाचणी करा.

2. ChatGPT तुम्ही कॉन्फिगर केलेली साधने शोधत असल्याची खात्री करा.

3. प्रथम कमी जोखमीची वाचन कृती चालवा, उदा. मंजूर डेटामध्ये शोध किंवा केवळ-वाचन क्वेरी.

4. मंजूर भूमिका आणि ऑब्जेक्टच्या बाहेरील प्रवेश Snowflake परवानग्या रोखतात याची खात्री करा.

5. वर्कस्पेस सेटअपसाठी, वेगवेगळ्या डीफॉल्ट Snowflake भूमिका असलेल्या अनुमत गैर-प्रशासक सदस्यांसह चाचणी करा. प्रशासकाचे कनेक्शन यशस्वी झाल्याने प्रत्येक सदस्य कनेक्ट करू शकतो असे सिद्ध होत नाही.

वर्कस्पेस प्रशासकांसाठी केवळ Snowflake सुरू करणे पुरेसे नाही. Snowflake - अधिकृत टेम्प्लेट सुरू करून कनेक्ट केले नसल्यास, सदस्यांना प्लगइन बंद असल्यासारखे दिसू शकते.

MCP सर्व्हर URL आणि OAuth चे वर्तन

ChatGPT संपूर्ण Snowflake-व्यवस्थापित MCP सर्व्हर URL शी कनेक्ट होते:

https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}

हे Snowflake OAuth एंडपॉइंट निर्धारित करण्यासाठी ChatGPT त्या URL मधील Snowflake होस्ट उपसर्ग वापरते:

• अधिकृतता: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/authorize

• टोकन: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/token-request

Snowsight URL, केवळ Snowflake खात्याचा मूळ URL किंवा अतिरिक्त पथ खंड असलेला URL पेस्ट करू नका. MCP URL मध्ये /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server} असणे आणि तो तुमच्या Snowflake ऑब्जेक्टशी तंतोतंत जुळणे आवश्यक आहे.

समस्यानिवारण

Snowflake प्रशासकासाठी सुरू आहे, पण सदस्यासाठी बंद आहे

• वर्कस्पेस सेटिंग्ज > प्लगइन मध्ये Snowflake आणि Snowflake - अधिकृत टेम्प्लेट दोन्ही सुरू असल्याची खात्री करा.

• Snowflake - अधिकृत टेम्प्लेट उघडा आणि त्याची कनेक्ट करा प्रक्रिया पूर्ण करा. टेम्प्लेट कनेक्ट न करता केवळ सुरू करणे पुरेसे नाही.

• Snowflake उघडा आणि आवश्यक अ‍ॅप म्हणून टेम्प्लेट दिसत असल्याची खात्री करा.

• प्रभावित सदस्याच्या भूमिकेला किंवा गटाला प्लगइन स्थापना धोरणात अनुमती असल्याची खात्री करा.

MCP सर्व्हर सापडला नाही

• संपूर्ण MCP सर्व्हर URL पुन्हा तपासा किंवा तुमच्या सेटअप स्क्रीनवर विचारले असल्यास टेम्प्लेटची चार फील्ड तपासा.

• त्या अचूक डेटाबेस आणि स्कीमामध्ये MCP सर्व्हर अस्तित्वात असल्याची खात्री करा.

ChatGPT मध्ये कोणतीही साधने दिसत नाहीत

• MCP सर्व्हरच्या तपशीलामध्ये साधने समाविष्ट असल्याची खात्री करा.

• भूमिकेकडे MCP सर्व्हरसाठी USAGE असल्याची खात्री करा.

साधन दिसते, पण वापरल्यावर अयशस्वी होते

• शोध सेवा, अर्थाधारित दृश्य, वेअरहाउस, प्रक्रिया किंवा UDF यांसारख्या अंतर्निहित Snowflake ऑब्जेक्टसाठी भूमिकेकडे आवश्यक परवानगी असल्याची खात्री करा.

SQL साधन अयशस्वी होते

• वेअरहाउसचे नाव योग्य असून वेअरहाउस चालू असल्याची खात्री करा.

• भूमिकेकडे वेअरहाउससाठी USAGE असल्याची खात्री करा.

• तुम्हाला केवळ-वाचन प्रवेश हवा असल्यास read_only: true सेट केले असल्याची खात्री करा.

विनंती केलेली ALL भूमिका स्पष्टपणे अवरोधित केली आहे

तुमच्या डीफॉल्ट भूमिकेची OAuth एकत्रीकरणातील अनुमत आणि अवरोधित भूमिकांशी तुलना करण्यास Snowflake प्रशासकाला सांगा. दुसरी अनुमत भूमिका असल्याने ती आपोआप निवडली जात नाही. योग्य असल्यास, डीफॉल्ट भूमिका मंजूर भूमिकेत बदला आणि पुन्हा कनेक्ट करा. डीफॉल्ट भूमिका बदलल्याने ChatGPT बाहेरील तुमच्या Snowflake सत्रांवरही परिणाम होतो.

अधिकृतता अयशस्वी होते

• वापरकर्ता Snowflake मध्ये साइन इन करू शकत असल्याची खात्री करा.

• session:role:all वापरताना, OAuth एकत्रीकरणात वापरकर्त्याच्या डीफॉल्ट भूमिकेला अनुमती असल्याची खात्री करा.

• सेटअप Snowflake-व्यवस्थापित MCP OAuth प्रक्रिया वापरत असल्याची खात्री करा.

• क्लायंट आयडी आणि क्लायंट सिक्रेट Snowflake OAuth एकत्रीकरणाशी जुळतात आणि त्याचा पुनर्निर्देशन URI ChatGPT मध्ये दिसणाऱ्या कॉलबॅक URL शी जुळतो याची खात्री करा.

Snowflake नेटवर्क धोरण किंवा IP अनुमतीसूची कनेक्टरला अवरोधित करते

• Snowflake नेटवर्क धोरण किंवा प्रवेश नियम अद्ययावत करण्यास Snowflake प्रशासकाला सांगा.

• सध्याच्या ChatGPT कनेक्टरच्या निर्गमन IP श्रेणींमधून येणाऱ्या कनेक्शनना अनुमती द्या.

• ही अनुमतीसूची Snowflake मध्ये कॉन्फिगर करा. ती ChatGPT वर्कस्पेसच्या IP अनुमतीसूचीपासून स्वतंत्र आहे.

• श्रेणी बदलू शकत असल्याने, शक्य असेल तेव्हा प्रकाशित JSON वरून अद्यतने स्वयंचलित करा.

होस्टनाव कनेक्शनची समस्या

योग्य Snowflake होस्ट उपसर्ग वापरा. अधोरेषा असलेल्या Snowflake होस्टनावांमुळे समस्या येऊ शकतात. त्याऐवजी संयोगचिन्हे वापरा.

संदर्भ

• Snowflake-व्यवस्थापित MCP सर्व्हर

• CREATE MCP SERVER

• DESCRIBE MCP SERVER

• SHOW MCP SERVERS