راه‌اندازی قالب برنامه Snowflake در ChatGPT

اگر مدیر فضای کاری ChatGPT یا کاربر ChatGPT Plus یا Pro هستید و می‌خواهید ChatGPT را از طریق یک سرور MCP تحت مدیریت Snowflake به 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 ایجاد می‌کنید که به‌عنوان نقطه پایان MCP برای ChatGPT عمل می‌کند. سرور MCP مشخص می‌کند:

• ChatGPT می‌تواند از کدام اقدامات استفاده کند.

• این ابزارها می‌توانند به کدام داده‌ها یا اشیای Snowflake دسترسی داشته باشند.

• هر کاربر با کدام نقش Snowflake مجوز دسترسی می‌دهد.

• کدام پایگاه داده و الگوی Snowflake و نام سرور MCP، نقطه پایان را مشخص می‌کنند.

سپس Snowflake - قالب رسمی را در ChatGPT با نشانی اینترنتی کامل سرور MCP مدیریت‌شده پیکربندی می‌کنید. ممکن است صفحهٔ راه‌اندازی قالب، نشانی اینترنتی را در چهار فیلد جداگانه نمایش دهد:

• پیشوند میزبان Snowflake.

• پایگاه داده.

• الگو.

• نام سرور MCP.

ChatGPT فقط می‌تواند ابزارهایی را شناسایی و استفاده کند که سرور MCP ارائه می‌دهد و نقش Snowflake مورد استفادهٔ کاربر برای اعطای مجوز، استفاده از آن‌ها را مجاز می‌داند.

پیش از شروع

به موارد زیر نیاز دارید:

• دسترسی مدیر یا مالک فضای کاری ChatGPT، یا دسترسی به ChatGPT Plus یا Pro.

• دسترسی به Snowflake با امکان ایجاد اشیای سرور MCP و اعطای مجوزها.

• پایگاه داده و الگوی Snowflake که سرور MCP در آن قرار خواهد گرفت.

• تصمیم‌گیری دربارهٔ کارهایی که ChatGPT مجاز به انجام آن‌ها خواهد بود؛ مانند استفاده از Cortex Search،‏ Cortex Analyst،‏ SQL فقط‌خواندنی یا یک رویه یا تابع مشخص.

• یک نقش Snowflake با حداقل سطح دسترسی لازم که کاربران هنگام دادن مجوز به برنامه از آن استفاده خواهند کرد.

• پیشوند میزبان حساب Snowflake، شامل هرگونه پسوند منطقه یا سرویس ابری.

اگر حساب Snowflake شما دسترسی را از طریق خط‌مشی شبکه یا فهرست IPهای مجاز محدود می‌کند، از یکی از مدیران Snowflake بخواهید اتصال‌های ورودی از بازه‌های فعلی IP خروجی برنامه‌های ChatGPT را مجاز کند. این فهرست متغیر است و باید به‌روز نگه داشته شود.

مقادیری که باید آماده کنید

• پیشوند میزبان Snowflake: تمام بخش پیش از .snowflakecomputing.com در نشانی حساب Snowflake.

• پایگاه داده: پایگاه داده حاوی سرور MCP.

• اسکیما: اسکیمای حاوی سرور MCP.

• نام سرور MCP: نام شیء سرور MCP در Snowflake.

• نشانی کامل سرور MCP مدیریت‌شده، اگر صفحه راه‌اندازی ChatGPT از شما نشانی می‌خواهد.

• نقش Snowflake: نقشی که کاربران باید هنگام اعطای مجوز به برنامه از آن استفاده کنند.

• فهرست ابزارها: اشیا و اقدامات Snowflake که می‌خواهید ChatGPT از آن‌ها استفاده کند.

تعیین کنید ChatGPT چه کارهایی می‌تواند انجام دهد

فقط قابلیت‌هایی را انتخاب کنید که می‌خواهید در دسترس قرار دهید. گزینه‌های رایج عبارت‌اند از:

• جستجو با Cortex Search برای یافتن پاسخ در داده‌ها یا محتوای نمایه‌شده Snowflake.

• پرسش‌وپاسخ با Cortex Analyst از طریق یک نمای معنایی تأییدشده.

• SQL فقط‌خواندنی برای دسترسی کنترل‌شده به اجرای پرس‌وجو.

• یک عامل Snowflake، رویه ذخیره‌شده یا تابع تعریف‌شده توسط کاربر (UDF) برای یک گردش‌کار مشخص.

اگر SQL را فعال می‌کنید، آن را در حالت فقط‌خواندنی نگه دارید، مگر اینکه سازمان شما دسترسی نوشتن را بررسی و تأیید کرده باشد.

یک کاربرگ Snowflake باز کنید

1. وارد برنامه Snowflake شوید.

2. به نقشی تغییر دهید که بتواند سرور MCP ایجاد کند و دسترسی بدهد.

3. به فضاهای کاری بروید.

   

4. یک فضای کاری با یک فایل SQL ایجاد کنید.

   

5. پایگاه داده و اسکیمایی را که قرار است سرور 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 را که کاربران با آن مجوز می‌دهند انتخاب کنید، سپس به آن نقش دسترسی به موارد زیر را بدهید:

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 اشاره می‌کند.

• نقش مورد استفاده برای اتصال، مجوز USAGE روی سرور MCP دارد.

• نقش مورد استفاده برای اتصال، مجوزهای لازم را روی هر شیء زیربنایی دارد.

جزئیات سرور Snowflake را در ChatGPT وارد کنید

برای راه‌اندازی در فضای کاری، admin.openai.com را باز کنید، فضای کاری موردنظر ChatGPT را انتخاب کنید و بخش افزونه‌ها را باز کنید. برای آشنایی با پیمایش فضای کاری و دسترسی به برنامه‌های قدیمی، به کنترل‌های مدیریتی، امنیت و انطباق برای افزونه‌ها و برنامه‌ها مراجعه کنید.

1. در ChatGPT، به حساب یا فضای کاری‌ای بروید که برنامه باید در آن در دسترس باشد.

2. برای راه‌اندازی شخصی به تنظیمات > افزونه‌ها بروید؛ برای راه‌اندازی در فضای کاری، به‌عنوان مدیر فضای کاری به کنسول مدیریت > افزونه‌ها بروید.

3. Snowflake را جستجو کنید.

4. Snowflake - قالب رسمی را فعال کنید.

5. Snowflake - قالب رسمی را باز کنید، نامی گویا برای اتصال وارد کنید و اتصال را انتخاب کنید.

6. نشانی کامل سرور 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 را به‌صورت فیلدهای جداگانه نشان می‌دهد، از همان مقادیر موجود در نشانی استفاده کنید:

پیشوند میزبان Snowflake

از تمام بخش پیش از .snowflakecomputing.com در نشانی حساب Snowflake خود، شامل هرگونه پسوند منطقه یا سرویس ابری، استفاده کنید.

برای مثال، اگر نشانی حساب با این عبارت شروع می‌شود:

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 ارائه شود.

1. از مدیر Snowflake بخواهید یکپارچه‌سازی شریک ChatGPT را در همان حساب Snowflake که میزبان سرور MCP است فعال کند. از یکپارچه‌سازی شریک ChatGPT که از قبل فعال شده است، دوباره استفاده کنید.

2. در پنجره راه‌اندازی ChatGPT از OAuth داخلی استفاده کنید. نیازی نیست شناسه کلاینت یا رمز کلاینت وارد کنید یا نشانی بازگشت ثبت کنید.

3. برای ورود، اعلام رضایت و پیکربندی دسترسی، مراحل بخش «Snowflake را متصل و مدیریت کنید» را در ادامه دنبال کنید. سپس بخش «برنامه را آزمایش کنید» را، از جمله آزمایش با اعضای غیرمدیرِ مجاز، تکمیل کنید.

نحوه عملکرد نقش پیش‌فرض، فهرست مجاز و نقش‌های مسدودشده که در بالا توضیح داده شد، برای این روش نیز صدق می‌کند.

کلاینت OAuth سفارشی

پیش از ادامه، بخش‌های مشترک بالا را تکمیل کنید تا سرور MCP ایجاد شود، مجوزها اعطا شوند، سرور بررسی شود و جزئیات آن در ChatGPT وارد شود. حتی اگر مستقیماً به این بخش آمده‌اید، انجام این مراحل الزامی است.

برای کلاینت OAuth سفارشی، به شناسه کلاینت و رمز کلاینت از Snowflake نیاز دارید. نحوه عملکرد نقش پیش‌فرض، فهرست مجاز و نقش‌های مسدودشده که در بالا توضیح داده شد، برای این روش نیز صدق می‌کند.

1. در پنجره راه‌اندازی ChatGPT، تنظیمات پیشرفته OAuth > کلاینت OAuth تعریف‌شده توسط کاربر را انتخاب کنید و نشانی بازگشت نمایش‌داده‌شده در ChatGPT را دقیقاً کپی کنید.

2. یک یکپارچه‌سازی امنیتی OAuth سفارشی ایجاد کنید که در آن OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' باشد و OAUTH_REDIRECT_URI دقیقاً روی همان نشانی بازگشت تنظیم شده باشد.

3. دستور زیر را در Snowflake اجرا کنید و نام یکپارچه‌سازی را با حروف بزرگ بنویسید:

   SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');

4. از نتیجه JSON، مقدار oauth_client_id را در شناسه کلاینت OAuth و مقدار oauth_client_secret را در رمز کلاینت OAuth در ChatGPT جای‌گذاری کنید.

5. روش احراز هویت نقطه پایان توکن را روی client_secret_basic تنظیم کنید.

پس از وارد کردن اطلاعات احراز هویت کلاینت سفارشی، مراحل بخش‌های «Snowflake را متصل و مدیریت کنید» و «برنامه را آزمایش کنید» را در ادامه دنبال کنید.

اتصال به Snowflake و مدیریت آن

1. برای هر یک از دو روش OAuth، در همان پنجرهٔ راه‌اندازی ChatGPT، ادامه را انتخاب کنید، وارد Snowflake شوید و مجوز اتصال را بدهید. اگر سیستم تک نشانه ای (SSO) سازمانتان پیکربندی شده باشد، می‌توانید از آن استفاده کنید.

2. برای راه‌اندازی در فضای کاری، مطمئن شوید که هم Snowflake و هم Snowflake - قالب رسمی فعال هستند. در Enterprise و Edu، خط‌مشی نصب افزونه و دسترسی کاربر برای هر برنامهٔ موجود در آن را برای نقش‌های اختصاص‌یافته به اعضا یا گروه‌های موردنظر پیکربندی کنید. در Business، خط‌مشی نصب افزونه و در دسترس بودن برنامه‌ها را در سراسر فضای کاری مدیریت کنید.

3. مدیران فضای کاری مسئول بررسی کنترل اقدامات برای ابزارهای ارائه‌شده هستند.

4. مدیران فضای کاری مسئول بررسی مجوزهای برنامه هستند تا مشخص کنند ChatGPT چه زمانی باید پیش از استفاده از برنامه از اعضا اجازه بگیرد.

این مجوزهای برنامه در گفتگوهای ChatGPT اعمال می‌شوند. عامل‌های فضای کاری از تنظیمات کنترلیِ مختص هر عامل که سازندهٔ آن تعیین می‌کند استفاده می‌کنند تا مشخص شود کدام اقدامات برنامه در دسترس هستند و چه زمانی از کاربران نهایی خواسته می‌شود آن‌ها را تأیید کنند. برای آشنایی با نحوهٔ عملکرد عامل‌ها، به عامل‌های فضای کاری ChatGPT برای Enterprise و Business مراجعه کنید.

برنامه را آزمایش کنید

1. یک گفتگو باز کنید، Snowflake را انتخاب کنید و اتصال را آزمایش کنید.

2. مطمئن شوید که ChatGPT ابزارهایی را که پیکربندی کرده‌اید شناسایی می‌کند.

3. ابتدا یک عملیات خواندن کم‌خطر، مانند جستجو یا پرس‌وجوی فقط‌خواندنی روی داده‌های تأییدشده، اجرا کنید.

4. مطمئن شوید که مجوزهای Snowflake از دسترسی خارج از محدوده نقش و اشیای تأییدشده جلوگیری می‌کنند.

5. برای راه‌اندازی در فضای کاری، اتصال را با اعضای غیرمدیرِ مجاز که نقش‌های پیش‌فرض متفاوتی در Snowflake دارند آزمایش کنید. اتصال موفق مدیر به این معنا نیست که همه اعضا می‌توانند متصل شوند.

برای مدیران فضای کاری، فعال کردن Snowflake به‌تنهایی کافی نیست. اگر Snowflake - قالب رسمی فعال و متصل نشده باشد، ممکن است افزونه برای اعضا غیرفعال نمایش داده شود.

نشانی سرور MCP و نحوه عملکرد OAuth

ChatGPT به نشانی کامل سرور MCP تحت مدیریت Snowflake متصل می‌شود:

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

ChatGPT از پیشوند میزبان Snowflake در آن نشانی برای تعیین این نقطه‌های پایان OAuth در Snowflake استفاده می‌کند:

• اعطای مجوز: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/authorize

• توکن: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/token-request

نشانی Snowsight، نشانی ریشه حساب Snowflake به‌تنهایی، یا نشانی دارای بخش‌های اضافی در مسیر را جای‌گذاری نکنید. نشانی MCP باید شامل /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server} باشد و دقیقاً با اشیای Snowflake شما مطابقت داشته باشد.

عیب‌یابی

Snowflake برای مدیر فعال است، اما برای عضو غیرفعال است

• مطمئن شوید که هم Snowflake و هم Snowflake - قالب رسمی در کنسول مدیریت > افزونه‌ها فعال هستند.

• Snowflake - قالب رسمی را باز کنید و مراحل اتصال آن را تکمیل کنید. فعال کردن قالب بدون برقراری اتصال آن کافی نیست.

• Snowflake را باز کنید و مطمئن شوید که قالب به‌عنوان برنامه موردنیاز آن نمایش داده می‌شود.

• مطمئن شوید که نقش یا گروه عضوی که با مشکل مواجه شده است، در خط‌مشی نصب افزونه مجاز است.

سرور MCP پیدا نشد

• نشانی کامل سرور 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 تغییرمسیر آن دقیقاً با نشانی بازگشت نمایش‌داده‌شده در ChatGPT یکسان است.

  اگر از OAuth داخلی استفاده می‌کنید، از مدیر Snowflake بخواهید بررسی کند که یکپارچه‌سازی شریک ChatGPT در حساب میزبان سرور MCP در دسترس و فعال باشد.

خط‌مشی شبکه یا فهرست IPهای مجاز Snowflake، دسترسی برنامه را مسدود می‌کند

• از یکی از مدیران Snowflake بخواهید خط‌مشی شبکه یا قواعد دسترسی Snowflake را به‌روزرسانی کند.

• اتصال‌های ورودی از بازه‌های فعلی IP خروجی برنامه‌های ChatGPT را مجاز کنید.

• این فهرست مجاز را در Snowflake پیکربندی کنید. این فهرست از فهرست IPهای مجاز فضای کاری ChatGPT جداست.

• در صورت امکان، به‌روزرسانی از فایل JSON منتشرشده را خودکار کنید، زیرا این بازه‌ها ممکن است تغییر کنند.

مشکل اتصال مربوط به نام میزبان

از پیشوند صحیح میزبان Snowflake استفاده کنید. وجود زیرخط در نام میزبان Snowflake می‌تواند مشکل‌ساز شود؛ بهتر است از خط تیره استفاده کنید.

منابع

• سرور MCP تحت مدیریت Snowflake

• CREATE MCP SERVER

• DESCRIBE MCP SERVER

• SHOW MCP SERVERS