यदि आप ChatGPT वर्कस्पेस एडमिन हैं और अपने संगठन के लिए Snowflake ऐप टेम्पलेट सेट अप कर रहे हैं, तो इस गाइड का उपयोग करें. टेम्पलेट वह अंतिम ऐप नहीं है जिसका सदस्य उपयोग करते हैं. यह एक सेटअप फ़्लो है, जो आपके द्वारा आवश्यक Snowflake कॉन्फ़िगरेशन देने के बाद वर्कस्पेस-विशिष्ट ड्राफ़्ट ऐप बनाता है.
Snowflake के लिए, अधिकांश सेटअप Snowflake में होता है. आप Snowflake-प्रबंधित MCP सर्वर बनाते हैं, MCP सर्वर और उसके अंतर्निहित ऑब्जेक्ट्स तक सही भूमिका को एक्सेस देते हैं, फिर ChatGPT टेम्पलेट सेटअप फ़्लो में प्रबंधित MCP सर्वर URL या उसके घटक फ़ील्ड दर्ज करते हैं. ChatGPT द्वारा ड्राफ़्ट ऐप बनाने के बाद, आप उसे प्रकाशित कर सकते हैं और अन्य वर्कस्पेस ऐप्स की तरह प्रबंधित कर सकते हैं.
आप क्या सेट अप कर रहे हैं
आप ChatGPT में वर्कस्पेस-विशिष्ट Snowflake ऐप बना रहे हैं. ऐप Snowflake-प्रबंधित MCP सर्वर से कनेक्ट होता है, जो इन्हें परिभाषित करता है:
ChatGPT कौन-सी कार्रवाइयां उपयोग कर सकता है, जिन्हें टूल कहा जाता है.
वे टूल किस Snowflake डेटा या ऑब्जेक्ट्स तक पहुंच सकते हैं.
यूज़र्स को किस Snowflake भूमिका से अधिकृत करना चाहिए.
कौन-सा Snowflake डेटाबेस, स्कीमा और MCP सर्वर नाम कनेक्टर एंडपॉइंट की पहचान करते हैं.
ChatGPT केवल उन टूल्स को खोज और उपयोग कर सकता है जो MCP सर्वर द्वारा उपलब्ध कराए गए हैं और उस Snowflake भूमिका द्वारा अनुमत हैं जिससे यूज़र अधिकृत करता है.
शुरू करने से पहले
आपको चाहिए:
ChatGPT वर्कस्पेस एडमिन या मालिक की एक्सेस.
Snowflake एक्सेस जो MCP सर्वर ऑब्जेक्ट्स बना सके और अनुमतियां दे सके.
Snowflake डेटाबेस और स्कीमा जहां MCP सर्वर रहेगा.
यह निर्णय कि ChatGPT को क्या करने की अनुमति होनी चाहिए, जैसे Cortex Search, Cortex Analyst, रीड-ओनली SQL, या कोई विशिष्ट प्रक्रिया या फ़ंक्शन.
न्यूनतम-विशेषाधिकार वाली Snowflake भूमिका, जिसका उपयोग यूज़र्स ऐप को अधिकृत करते समय करेंगे.
Snowflake अकाउंट होस्ट प्रीफ़िक्स, जिसमें कोई भी क्षेत्र या क्लाउड सफ़िक्स शामिल हो.
तैयार करने योग्य मान
Snowflake होस्ट प्रीफ़िक्स: Snowflake अकाउंट URL में .snowflakecomputing.com से पहले की हर चीज़.
डेटाबेस: वह डेटाबेस जिसमें MCP सर्वर है.
स्कीमा: वह स्कीमा जिसमें MCP सर्वर है.
MCP सर्वर नाम: Snowflake MCP सर्वर ऑब्जेक्ट का नाम.
पूरा प्रबंधित MCP सर्वर URL, यदि ChatGPT सेटअप स्क्रीन URL मांगती है.
Snowflake भूमिका: वह भूमिका जिसका उपयोग यूज़र्स ऐप को अधिकृत करते समय करेंगे.
टूल सूची: Snowflake ऑब्जेक्ट्स और कार्रवाइयां जिनका उपयोग आप ChatGPT से कराना चाहते हैं.
तय करें कि ChatGPT क्या कर सकता है
केवल वे क्षमताएं चुनें जिन्हें आप एक्सपोज़ करना चाहते हैं. आम विकल्पों में शामिल हैं:
इंडेक्स किए गए Snowflake डेटा या सामग्री में उत्तर खोजने के लिए Cortex Search से खोज.
स्वीकृत सिमेंटिक व्यू के माध्यम से Cortex Analyst के साथ प्रश्नोत्तर.
नियंत्रित क्वेरी एक्सेस के लिए रीड-ओनली SQL.
विशिष्ट वर्कफ़्लो के लिए Snowflake एजेंट, स्टोर्ड प्रोसीजर या UDF.
यदि आप SQL सक्षम करते हैं, तो इसे रीड-ओनली रखें, जब तक आपके संगठन ने लिखने की एक्सेस की समीक्षा और स्वीकृति न दी हो.
Snowflake MCP सर्वर बनाएं
Snowflake में, ऐसी भूमिका से साइन इन करें जो MCP सर्वर बना सके और एक्सेस दे सके. उस डेटाबेस और स्कीमा में वर्कशीट खोलें जहां MCP सर्वर बनाया जाना चाहिए.
ऐसा MCP सर्वर बनाएं जो केवल वे टूल सूचीबद्ध करे जिनका उपयोग ChatGPT को करना चाहिए. ऑब्जेक्ट नामों को अपने 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: "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" $$;
टूल नाम स्थिर और वर्णनात्मक होने चाहिए, ताकि ChatGPT सही टूल चुन सके. 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 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;
पुष्टि करें:
सर्वर अपेक्षित डेटाबेस और स्कीमा में मौजूद है.
टूल सूची वैसी ही है जैसी आपने चाही थी.
हर टूल पहचानकर्ता सही Snowflake ऑब्जेक्ट की ओर इशारा करता है.
कनेक्टिंग भूमिका के पास MCP सर्वर पर USAGE है.
कनेक्टिंग भूमिका के पास हर अंतर्निहित ऑब्जेक्ट पर आवश्यक अनुमतियां हैं.
ChatGPT में टेम्पलेट सेटअप शुरू करें
ChatGPT में, उस वर्कस्पेस पर स्विच करें जहां ऐप उपलब्ध होना चाहिए.
वर्कस्पेस सेटिंग्स > ऐप्स खोलें.
डायरेक्टरी चुनें.
Snowflake खोजें.
Snowflake ऐप टेम्पलेट चुनें और सेटअप शुरू करें.
ऐप का स्पष्ट नाम और विवरण दर्ज करें, जैसे Snowflake या Snowflake - Analytics.
सेटअप फ़्लो द्वारा मांगे गए प्रबंधित MCP सर्वर विवरण दर्ज करें.
यदि सेटअप स्क्रीन पूरा प्रबंधित MCP सर्वर URL मांगती है, तो यह फ़ॉर्मैट उपयोग करें:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
यदि सेटअप स्क्रीन अलग-अलग फ़ील्ड मांगती है, तो उसी URL से वही मान उपयोग करें:
Snowflake होस्ट प्रीफ़िक्स.
डेटाबेस.
स्कीमा.
MCP सर्वर नाम.
ड्राफ़्ट ऐप बनाएं और प्रकाशित करें
ChatGPT में Snowflake टेम्पलेट सेटअप सहेजें.
ड्राफ़्ट ऐप बनाएं.
ड्राफ़्ट ऐप विवरण, ऑथ सेटिंग्स और उपलब्ध कार्रवाइयों की समीक्षा करें.
तैयार होने पर ड्राफ़्ट ऐप प्रकाशित करें.
पुष्टि करें कि ऐप वर्कस्पेस सेटिंग्स > ऐप्स > सक्षम में दिखाई देता है.
उन भूमिकाओं के लिए यूज़र एक्सेस कॉन्फ़िगर करें जिन्हें इसका उपयोग करना चाहिए.
एक्सपोज़ किए गए टूल्स के लिए कार्रवाई नियंत्रण की समीक्षा करें.
यह चुनने के लिए ऐप अनुमतियों की समीक्षा करें कि ChatGPT ऐप का उपयोग करने से पहले सदस्यों से कब पूछे.
ये ऐप अनुमतियां ChatGPT बातचीत पर लागू होती हैं. वर्कस्पेस एजेंट यह तय करने के लिए एजेंट के बिल्डर द्वारा सेट किए गए प्रति-एजेंट नियंत्रणों का उपयोग करते हैं कि कौन-सी ऐप कार्रवाइयां उपलब्ध हैं और अंतिम यूज़र्स से उन्हें मंज़ूर करने के लिए कब पूछा जाता है. एजेंट व्यवहार के लिए, देखें: Enterprise और Business के लिए ChatGPT वर्कस्पेस एजेंट.
ऐप का परीक्षण करें
अनुमत परीक्षण यूज़र के रूप में ChatGPT से कनेक्ट फ़्लो शुरू करें.
Snowflake में साइन इन करें और संकेत मिलने पर इच्छित भूमिका चुनें.
पुष्टि करें कि ChatGPT MCP सर्वर से अपेक्षित टूल्स खोजता है.
पहले कम जोखिम वाली रीड कार्रवाई चलाएं, जैसे स्वीकृत डेटा पर खोज या रीड-ओनली क्वेरी.
पुष्टि करें कि Snowflake अनुमतियां स्वीकृत भूमिका और ऑब्जेक्ट्स के बाहर एक्सेस रोकती हैं.
MCP सर्वर URL और OAuth व्यवहार
ChatGPT पूरे Snowflake-प्रबंधित MCP सर्वर URL से कनेक्ट होता है. ChatGPT Snowflake OAuth एंडपॉइंट्स को हल करने के लिए उस URL से Snowflake होस्ट प्रीफ़िक्स का उपयोग करता है.
Snowsight URL, Snowflake अकाउंट रूट URL अकेले, या अतिरिक्त पाथ सेगमेंट वाला कोई भी URL पेस्ट न करें. MCP URL में डेटाबेस, स्कीमा और MCP सर्वर पाथ शामिल होना चाहिए और यह आपके Snowflake ऑब्जेक्ट्स से बिल्कुल मेल खाना चाहिए.
समस्या निवारण
MCP सर्वर नहीं मिला: पूरा MCP सर्वर URL या अलग होस्ट प्रीफ़िक्स, डेटाबेस, स्कीमा और सर्वर फ़ील्ड दोबारा जांचें.
ChatGPT में कोई टूल दिखाई नहीं देता: पुष्टि करें कि MCP सर्वर स्पेक में टूल्स शामिल हैं और भूमिका के पास MCP सर्वर पर USAGE है.
टूल दिखाई देता है लेकिन उपयोग करने पर विफल होता है: पुष्टि करें कि भूमिका के पास अंतर्निहित Snowflake ऑब्जेक्ट पर सही अनुमति है.
SQL टूल विफल होता है: पुष्टि करें कि वेयरहाउस नाम सही है, वेयरहाउस उपलब्ध है, भूमिका के पास उस पर USAGE है, और यदि आप रीड-ओनली एक्सेस चाहते थे तो read_only true है.
प्राधिकरण विफल होता है: पुष्टि करें कि यूज़र Snowflake में साइन इन कर सकता है और इच्छित भूमिका उपयोग कर सकता है.
होस्टनेम कनेक्शन समस्या: सही Snowflake होस्ट प्रीफ़िक्स का उपयोग करें. अंडरस्कोर वाले Snowflake होस्टनेम समस्याएं पैदा कर सकते हैं; हाइफ़न को प्राथमिकता दें.