Կարգավորեք Snowflake հավելվածի ձևանմուշը ChatGPT-ում

Օգտվեք այս ուղեցույցից, եթե ChatGPT աշխատատարածքի ադմինիստրատոր եք կամ ChatGPT Plus կամ Pro օգտատեր և ցանկանում եք ChatGPT-ը միացնել Snowflake-ին՝ Snowflake-ի կողմից կառավարվող MCP սերվերի միջոցով։

Կարգավորման մեծ մասը կատարվում է Snowflake-ում։ Երբ Snowflake-ը պատրաստ լինի, ChatGPT-ում ավարտեք Snowflake ձևանմուշի միացումը, ապա միացրեք այդ ձևանմուշն օգտագործող Snowflake փլագինը։

• Ներկառուցված OAuth․ եթե այն հասանելի է ձեր Snowflake հաշվի համար և ChatGPT-ում, օգտագործեք Snowflake-ի ադմինիստրատորի միացրած ChatGPT գործընկերային հավելվածը։ Մուտք գործեք Snowflake՝ օգտագործելով ձեր կազմակերպության SSO-ն, եթե այն կարգավորված է։ ChatGPT-ում հաճախորդի ID կամ գաղտնի բանալի մուտքագրելու կարիք չկա։ Հետևեք ստորև ներկայացված «Ներկառուցված OAuth» բաժնի հրահանգներին։

• Անհատական OAuth հաճախորդ․ ընտրեք այս տարբերակը, եթե ձեր կազմակերպությունը պահանջում է սեփական OAuth հաճախորդ, կամ ներկառուցված OAuth-ը հասանելի չէ։ Հետևեք ստորև ներկայացված «Անհատական OAuth հաճախորդ» բաժնի հրահանգներին։

OAuth-ի երկու տարբերակների համար էլ անհրաժեշտ են ստորև նկարագրված MCP սերվերի ընդհանուր կարգավորումը, հիմքում ընկած օբյեկտների թույլտվությունները և ցանցային հասանելիությունը։ Նախքան OAuth-ը կարգավորելը կատարեք ընդհանուր կարգավորման քայլերը՝ մինչև «Մուտքագրեք Snowflake սերվերի տվյալները ChatGPT-ում» բաժինը ներառյալ։

Ինչ եք կարգավորում

Դուք ստեղծում եք Snowflake-ի կողմից կառավարվող MCP սերվեր, որը ChatGPT-ի համար ծառայում է որպես միակցիչի վերջնակետ։ MCP սերվերը սահմանում է՝

• Ինչ գործողություններ կարող է օգտագործել ChatGPT-ը։

• Snowflake-ի որ տվյալներին կամ օբյեկտներին կարող են հասանելիություն ունենալ այդ գործիքները։

• Snowflake-ի որ դերով է յուրաքանչյուր օգտատեր կատարում լիազորումը։

• Snowflake-ի որ տվյալների բազան, սխեման և MCP սերվերի անունն են նույնականացնում վերջնակետը։

Այնուհետև ChatGPT-ում կարգավորում եք Snowflake - Պաշտոնական ձևանմուշ տարբերակը՝ նշելով կառավարվող MCP սերվերի ամբողջական URL-ը։ Ձևանմուշի կարգավորման էկրանը կարող է URL-ը ներկայացնել չորս առանձին դաշտերով․

• Snowflake հոսթի նախածանց։

• Տվյալների բազա։

• Սխեմա։

• MCP սերվերի անուն։

ChatGPT-ը կարող է հայտնաբերել և օգտագործել միայն այն գործիքները, որոնք հասանելի են դարձված MCP սերվերի կողմից և թույլատրված են այն Snowflake դերով, որով օգտատերը կատարում է լիազորումը։

Նախքան սկսելը

Ձեզ անհրաժեշտ է՝

• ChatGPT աշխատատարածքի ադմինիստրատորի կամ սեփականատիրոջ հասանելիություն, կամ ChatGPT Plus կամ 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 սերվերի օբյեկտի անունը։

• Կառավարվող MCP սերվերի ամբողջական URL-ը, եթե ChatGPT-ի կարգավորման էկրանը URL է պահանջում։

• Snowflake դեր՝ այն դերը, որն օգտատերերը պետք է օգտագործեն հավելվածը լիազորելիս։

• Գործիքների ցանկ՝ Snowflake-ի այն օբյեկտներն ու գործողությունները, որոնք ցանկանում եք, որ ChatGPT-ն օգտագործի։

Որոշեք՝ ինչ կարող է անել ChatGPT-ը

Ընտրեք միայն այն հնարավորությունները, որոնք ցանկանում եք հասանելի դարձնել։ Տարածված տարբերակներն են՝

• Որոնում Cortex Search-ով՝ ինդեքսավորված Snowflake տվյալներում կամ բովանդակության մեջ պատասխաններ գտնելու համար։

• Հարց ու պատասխան 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 թույլտվությունը։

• Միացման համար օգտագործվող դերն ունի հիմքում ընկած յուրաքանչյուր օբյեկտի համար անհրաժեշտ թույլտվությունները։

Մուտքագրեք Snowflake սերվերի տվյալները ChatGPT-ում

Աշխատատարածքի համար կարգավորելու դեպքում բացեք admin.openai.com, ընտրեք նախատեսված ChatGPT աշխատատարածքը և բացեք «Փլագիններ» բաժինը։ Աշխատատարածքում նավարկելու և հին հավելվածներին հասանելիության մասին տես՝ Փլագինների և հավելվածների ադմինիստրատիվ կառավարում, անվտանգություն և համապատասխանություն։

1. ChatGPT-ում անցեք այն հաշվին կամ աշխատատարածքին, որտեղ հավելվածը պետք է հասանելի լինի։

2. Անձնական օգտագործման համար անցեք Կարգավորումներ > Փլագիններ, իսկ որպես աշխատատարածքի ադմինիստրատոր՝ աշխատատարածքի համար կարգավորելու դեպքում անցեք Ադմինիստրատորի վահանակ > Փլագիններ։

3. Որոնեք Snowflake։

4. Միացրեք Snowflake - Պաշտոնական ձևանմուշ տարբերակը։

5. Բացեք Snowflake - Պաշտոնական ձևանմուշ տարբերակը, մուտքագրեք կապի հասկանալի անուն և ընտրեք Միացնել։

6. Մուտքագրեք կառավարվող 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-ը

Ընտրեք OAuth-ի այն տարբերակը, որը հասանելի է ձեր հաշվի համար և համապատասխանում է ձեր կազմակերպության պահանջներին։ Երկու տարբերակներն էլ օգտագործում են վերևում նկարագրված MCP սերվերի ընդհանուր կարգավորումը և ստորև ներկայացված կապի փորձարկումներն ու հասանելիության կառավարման միջոցները։

OAuth-ի երկու տարբերակների դեպքում էլ, երբ օգտագործում եք session:role:all, Snowflake-ն օգտագործում է յուրաքանչյուր օգտատիրոջ լռելյայն դերը։ Լռելյայն դերը պետք է ներառված լինի OAuth ինտեգրման թույլատրված դերերի ցանկում, եթե այն կարգավորված է, և չպետք է արգելափակված լինի։ Եթե ունեք մեկ այլ հաստատված դեր, այն ինքնաբերաբար չի ընտրվում։

Ներկառուցված OAuth

Նախքան շարունակելը կատարեք վերևի ընդհանուր բաժինների քայլերը՝ ստեղծելու MCP սերվերը, տրամադրելու թույլտվությունները, ստուգելու սերվերը և դրա տվյալները ChatGPT-ում մուտքագրելու համար։ Սա պարտադիր է, նույնիսկ եթե անմիջապես այս բաժին եք անցել։

Օգտագործեք այս տարբերակը միայն այն դեպքում, երբ ChatGPT գործընկերային հավելվածը հասանելի է ձեր Snowflake հաշվի համար, իսկ ներկառուցված OAuth-ը՝ ChatGPT-ի կարգավորման մոդալ պատուհանում։

1. Խնդրեք Snowflake-ի ադմինիստրատորին միացնել ChatGPT գործընկերային ինտեգրումը նույն Snowflake հաշվում, որտեղ տեղակայված է MCP սերվերը։ Կրկին օգտագործեք արդեն միացված ChatGPT գործընկերային ինտեգրումը։

2. ChatGPT-ի կարգավորման մոդալ պատուհանում օգտագործեք ներկառուցված OAuth-ը։ Կարիք չկա մուտքագրելու հաճախորդի ID կամ գաղտնի բանալի կամ գրանցելու հետադարձ կանչի URL։

3. Շարունակեք ստորև ներկայացված «Միացրեք և կառավարեք Snowflake-ը» բաժնով՝ մուտք գործելու, համաձայնություն տալու և հասանելիությունը կարգավորելու համար։ Այնուհետև կատարեք «Փորձարկեք հավելվածը» բաժնի քայլերը՝ ներառյալ հասանելիություն ունեցող, ադմինիստրատոր չհանդիսացող անդամների հետ փորձարկումները։

Լռելյայն դերի, թույլատրված դերերի ցանկի և արգելափակված դերերի վերաբերյալ վերը նկարագրված կանոնները գործում են նաև այս տարբերակի դեպքում։

Անհատական OAuth հաճախորդ

Նախքան շարունակելը կատարեք վերևի ընդհանուր բաժինների քայլերը՝ ստեղծելու MCP սերվերը, տրամադրելու թույլտվությունները, ստուգելու սերվերը և դրա տվյալները ChatGPT-ում մուտքագրելու համար։ Սա պարտադիր է, նույնիսկ եթե անմիջապես այս բաժին եք անցել։

Անհատական OAuth հաճախորդի համար անհրաժեշտ են Snowflake-ից ստացված հաճախորդի ID և գաղտնի բանալի։ Լռելյայն դերի, թույլատրված դերերի ցանկի և արգելափակված դերերի վերաբերյալ վերը նկարագրված կանոնները գործում են նաև այս տարբերակի դեպքում։

1. ChatGPT-ի կարգավորման մոդալ պատուհանում ընտրեք OAuth-ի ընդլայնված կարգավորումներ > Օգտատիրոջ սահմանած OAuth հաճախորդ և ճշգրտորեն պատճենեք ChatGPT-ում ցուցադրվող Հետադարձ կանչի URL արժեքը։

2. Ստեղծեք անհատական OAuth անվտանգության ինտեգրում՝ OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' պարամետրով, իսկ 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-ը» և «Փորձարկեք հավելվածը» բաժիններին։

Միացրեք և կառավարեք Snowflake-ը

1. OAuth-ի երկու տարբերակների դեպքում էլ ChatGPT-ի կարգավորման նույն մոդալ պատուհանում ընտրեք Շարունակել, մուտք գործեք Snowflake և լիազորեք կապը։ Կարող եք օգտագործել ձեր կազմակերպության SSO-ն, եթե այն կարգավորված է։

2. Աշխատատարածքի համար կարգավորելու դեպքում սահմանեք փլագինի տեղադրման քաղաքականությունը և ըստ դերի կամ խմբի հասանելիությունը այն անդամների համար, որոնք պետք է օգտագործեն այն։ Ստուգեք, որ միացված են և՛ Snowflake, և՛ Snowflake - Պաշտոնական ձևանմուշ տարբերակները։

3. Աշխատատարածքի ադմինիստրատորները պատասխանատու են Օգտատերերի հասանելիություն կարգավորումը սահմանելու համար՝ այն դերերի համար, որոնք պետք է օգտագործեն Snowflake-ը։

4. Աշխատատարածքի ադմինիստրատորները պատասխանատու են հասանելի դարձված գործիքների Գործողությունների կառավարում կարգավորումը վերանայելու համար։

5. Աշխատատարածքի ադմինիստրատորները պատասխանատու են Հավելվածի թույլտվություններ կարգավորումը վերանայելու համար՝ որոշելու, թե երբ ChatGPT-ը պետք է անդամների թույլտվությունը հարցնի նախքան հավելվածն օգտագործելը։

Հավելվածի այս թույլտվությունները գործում են ChatGPT զրույցներում։ Աշխատատարածքի ագենտներն օգտագործում են յուրաքանչյուր ագենտի ստեղծողի սահմանած կառավարման կարգավորումները՝ որոշելու, թե հավելվածի որ գործողություններն են հասանելի և երբ պետք է վերջնական օգտատերերից պահանջել դրանց հաստատումը։ Ագենտների վարքագծի մասին տես՝ ChatGPT աշխատատարածքի ագենտներ Enterprise-ի և Business-ի համար։

Փորձարկեք հավելվածը

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 ընթացակարգը։

• Եթե օգտագործում եք անհատական OAuth հաճախորդ, համոզվեք, որ Հաճախորդի ID և Հաճախորդի գաղտնի բանալի արժեքները համապատասխանում են Snowflake OAuth ինտեգրմանը, իսկ դրա վերահղման URI-ն ճշգրտորեն համընկնում է ChatGPT-ում ցուցադրվող Հետադարձ կանչի URL արժեքին։

  Եթե օգտագործում եք ներկառուցված OAuth, խնդրեք Snowflake-ի ադմինիստրատորին ստուգել, որ ChatGPT գործընկերային ինտեգրումը հասանելի է և միացված է այն հաշվում, որտեղ տեղակայված է MCP սերվերը։

Snowflake-ի ցանցային քաղաքականությունը կամ թույլատրված IP հասցեների ցանկն արգելափակում է միակցիչը

• Խնդրեք Snowflake-ի ադմինիստրատորին թարմացնել Snowflake-ի ցանցային քաղաքականությունը կամ հասանելիության կանոնները։

• Թույլատրեք մուտքային կապերը ChatGPT միակցիչի ելքային IP հասցեների ընթացիկ տիրույթներից։

• Այս թույլատրված հասցեների ցանկը կարգավորեք Snowflake-ում։ Այն առանձին է ChatGPT աշխատատարածքի թույլատրված IP հասցեների ցանկից։

• Հնարավորության դեպքում ավտոմատացրեք թարմացումները հրապարակված JSON-ից, քանի որ տիրույթները կարող են փոխվել։

Հոսթի անվան հետ կապված միացման խնդիր

Օգտագործեք Snowflake հոսթի ճիշտ նախածանցը։ Ընդգծման նշաններ պարունակող Snowflake հոսթերի անունները կարող են խնդիրներ առաջացնել․ նախընտրեք գծիկներ։

Հղումներ

• Snowflake-ի կողմից կառավարվող MCP սերվեր

• CREATE MCP SERVER

• DESCRIBE MCP SERVER

• SHOW MCP SERVERS