अगर आप ChatGPT वर्कस्पेस के एडमिन या ChatGPT Plus या ChatGPT 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 सर्वर का नाम.

ChatGPT केवल उन्हीं टूल को खोज और उपयोग कर सकता है जिन्हें MCP सर्वर उपलब्ध कराता है और उपयोगकर्ता द्वारा अधिकृत Snowflake भूमिका अनुमति देती है.

शुरू करने से पहले

आपको इनकी ज़रूरत होगी:

• ChatGPT वर्कस्पेस एडमिन या मालिक का ऐक्सेस, अथवा ChatGPT Plus या ChatGPT Pro का ऐक्सेस.

• ऐसा Snowflake ऐक्सेस, जिससे MCP सर्वर ऑब्जेक्ट बनाए और अनुमतियां दी जा सकें.

• वह Snowflake डेटाबेस और स्कीमा, जहां MCP सर्वर रहेगा.

• यह निर्णय कि ChatGPT को क्या करने की अनुमति होगी, जैसे Cortex Search, Cortex Analyst, केवल पढ़ने योग्य SQL या कोई खास प्रक्रिया या फ़ंक्शन.

• न्यूनतम विशेषाधिकार वाली Snowflake भूमिका, जिसका उपयोग उपयोगकर्ता ऐप को अधिकृत करते समय करेंगे.

• Snowflake खाते का होस्ट प्रीफ़िक्स, जिसमें क्षेत्र या क्लाउड सफ़िक्स शामिल हो.

अगर आपका Snowflake खाता नेटवर्क नीति या IP अनुमति-सूची से ऐक्सेस सीमित करता है, तो Snowflake एडमिन से मौजूदा ChatGPT कनेक्टर आउटगोइंग IP रेंज से आने वाले कनेक्शन की अनुमति देने को कहें. यह सूची बदलती रहती है और इसे अद्यतित रखना चाहिए.

तैयार रखने वाले मान

• Snowflake होस्ट प्रीफ़िक्स: Snowflake खाते के URL में .snowflakecomputing.com से पहले का पूरा भाग.

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

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

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

• अगर ChatGPT सेटअप स्क्रीन URL मांगती है, तो पूरा प्रबंधित MCP सर्वर URL.

• Snowflake भूमिका: ऐप को अधिकृत करते समय उपयोगकर्ताओं द्वारा इस्तेमाल की जाने वाली भूमिका.

• टूल सूची: वे Snowflake ऑब्जेक्ट और कार्रवाइयां, जिनका उपयोग ChatGPT से कराना है.

तय करें कि 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 Agent उपलब्ध कराता है, तो उस ऑब्जेक्ट के लिए भी आवश्यक अनुमतियां दें.

पुष्टि करें कि 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 से क्लाइंट ID और क्लाइंट सीक्रेट चाहिए.

जब आप 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 क्लाइंट ID में और 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}

ChatGPT इस URL के Snowflake होस्ट प्रीफ़िक्स से इन Snowflake OAuth एंडपॉइंट का पता लगाता है:

• प्राधिकरण: 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 अनुमति है.

टूल दिखाई देता है, लेकिन उपयोग करने पर विफल हो जाता है

• पुष्टि करें कि भूमिका के पास अंतर्निहित Snowflake ऑब्जेक्ट के लिए आवश्यक अनुमति है, जैसे खोज सेवा, सिमैंटिक व्यू, वेयरहाउस, प्रक्रिया या UDF.

SQL टूल विफल हो जाता है

• पुष्टि करें कि वेयरहाउस का नाम सही है और वेयरहाउस चल रहा है.

• पुष्टि करें कि भूमिका के पास वेयरहाउस पर USAGE अनुमति है.

• अगर आप केवल पढ़ने योग्य ऐक्सेस चाहते थे, तो पुष्टि करें कि read_only: true सेट है.

अनुरोधित ALL भूमिका को स्पष्ट रूप से अवरुद्ध किया गया है

अपने Snowflake एडमिन से अपनी डिफ़ॉल्ट भूमिका की तुलना OAuth एकीकरण में अनुमत और अवरुद्ध भूमिकाओं से करने को कहें. कोई दूसरी अनुमत भूमिका होने पर वह अपने-आप नहीं चुनी जाती. अगर उचित हो, तो डिफ़ॉल्ट भूमिका को किसी स्वीकृत भूमिका में बदलें और फिर से कनेक्ट करें. डिफ़ॉल्ट भूमिका बदलने से ChatGPT के बाहर आपके Snowflake सत्र भी प्रभावित होते हैं.

प्राधिकरण विफल हो जाता है

• पुष्टि करें कि उपयोगकर्ता Snowflake में साइन इन कर सकता है.

• session:role:all का उपयोग करते समय पुष्टि करें कि OAuth एकीकरण उपयोगकर्ता की डिफ़ॉल्ट भूमिका को अनुमति देता है.

• पुष्टि करें कि सेटअप Snowflake द्वारा प्रबंधित MCP OAuth प्रक्रिया का उपयोग करता है.

• पुष्टि करें कि क्लाइंट ID और क्लाइंट सीक्रेट, 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