اگر آپ 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 ایجنٹ پیش کرتا ہے تو اس آبجیکٹ کے لیے بھی مطلوبہ اجازتیں دیں.

تصدیق کریں کہ 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 سرور

• MCP سرور بنائیں

• MCP سرور کی وضاحت کریں

• MCP سرورز دکھائیں