Uża din il-gwida jekk int amministratur ta’ workspace ta’ ChatGPT jew utent ta’ ChatGPT Plus jew Pro u trid tqabbad ChatGPT ma’ Snowflake permezz ta’ server MCP immaniġġjat minn Snowflake.

Il-biċċa l-kbira tal-konfigurazzjoni ssir fi Snowflake. Meta Snowflake jkun lest, lesti l-konnessjoni tal-mudell ta’ Snowflake fi ChatGPT, imbagħad attiva l-plugin ta’ Snowflake li juża dak il-mudell.

Dak li qed tikkonfigura

Qed toħloq server MCP immaniġġjat minn Snowflake li jservi bħala l-punt ta’ tmiem tal-konnettur għal ChatGPT. Is-server MCP jiddefinixxi:

• Liema azzjonijiet jista’ juża ChatGPT

• Għal liema data jew oġġetti ta’ Snowflake jistgħu jaċċessaw dawk l-għodod.

• B’liema rwol ta’ Snowflake jawtorizza kull utent.

• Liema database, skemi u isem tas-server MCP ta’ Snowflake jidentifikaw il-punt ta’ tmiem.

Imbagħad tikkonfigura Snowflake - Mudell Uffiċjali fi ChatGPT bil-URL sħiħ tas-server MCP immaniġġjat. L-iskrin tal-konfigurazzjoni tal-mudell jista’ juri l-URL bħala erba’ oqsma separati:

• Prefiss tal-host ta’ Snowflake.

• Database.

• Skemi.

• Isem tas-server MCP.

ChatGPT jista’ jsib u juża biss l-għodod esposti mis-server MCP u permessi mir-rwol ta’ Snowflake li bih jawtorizza l-utent.

Qabel tibda

Għandek bżonn:

• Aċċess bħala amministratur jew sid ta’ workspace ta’ ChatGPT, jew aċċess għal ChatGPT Plus jew Pro.

• Aċċess għal Snowflake li jista’ joħloq oġġetti ta’ server MCP u jagħti permessi.

• Id-database u l-iskemi ta’ Snowflake fejn se jkun jinsab is-server MCP.

• Deċiżjoni dwar x’għandu jitħalla jagħmel ChatGPT, bħal Cortex Search, Cortex Analyst, SQL għall-qari biss, jew proċedura jew funzjoni speċifika.

• Rwol ta’ Snowflake bl-inqas privileġġi li l-utenti jużaw meta jawtorizzaw l-app.

• Il-prefiss tal-host tal-kont Snowflake, inkluż kwalunkwe suffiss tar-reġjun jew tal-cloud.

Jekk il-kont Snowflake tiegħek jirrestrinġi l-aċċess permezz ta’ politika tan-network jew lista ta’ IPs permessi, itlob lil amministratur ta’ Snowflake jippermetti konnessjonijiet deħlin mill-firxiet attwali tal-IP tal-ħruġ tal-konnettur ta’ ChatGPT. Il-lista hija dinamika u għandha tinżamm aġġornata.

Valuri li għandek tipprepara

• Prefiss tal-host ta’ Snowflake: dak kollu li jiġi qabel .snowflakecomputing.com fil-URL tal-kont Snowflake.

• Database: id-database li fiha s-server MCP.

• Skemi: l-iskemi li fiha s-server MCP.

• Isem tas-server MCP: l-isem tal-oġġett tas-server MCP ta’ Snowflake.

• Il-URL sħiħ tas-server MCP immaniġġjat, jekk l-iskrin tal-konfigurazzjoni ta’ ChatGPT jitlob URL.

• Rwol ta’ Snowflake: ir-rwol li l-utenti għandhom jużaw meta jawtorizzaw l-app.

• Lista tal-għodod: l-oġġetti u l-azzjonijiet ta’ Snowflake li trid li juża ChatGPT.

Iddeċiedi x’jista’ jagħmel ChatGPT

Agħżel biss il-kapaċitajiet li trid tesponi. L-għażliet komuni jinkludu:

• Tiftix b’Cortex Search biex issib tweġibiet f’data jew kontenut indiċjati ta’ Snowflake.

• Mistoqsijiet u tweġibiet b’Cortex Analyst permezz ta’ dehra semantika approvata.

• SQL għall-qari biss għal aċċess ikkontrollat għall-mistoqsijiet.

• Aġent ta’ Snowflake, proċedura maħżuna jew UDF għal fluss tax-xogħol speċifiku.

Jekk tattiva SQL, żommu għall-qari biss sakemm l-organizzazzjoni tiegħek ma tkunx eżaminat u approvat l-aċċess għall-kitba.

Iftaħ worksheet ta’ Snowflake

1. Idħol fl-app Snowflake.

2. Aqleb għal rwol li jista’ joħloq is-server MCP u jagħti aċċess.

3. Mur f’Workspaces.

   

4. Oħloq workspace b’fajl SQL.

   

5. Issettja l-kuntest tal-workspace għad-database u l-iskemi fejn se jinħoloq is-server MCP.

   

Oħloq is-server MCP ta’ Snowflake

Fi Snowflake, idħol bi rwol li jista’ joħloq is-server MCP u jagħti aċċess. Iftaħ worksheet fid-database u l-iskemi fejn għandu jinħoloq is-server MCP.

Ħaddem dikjarazzjoni bħall-eżempju li ġej. Ibdel l-ismijiet b’dawk tad-database, l-iskemi, is-servizzi, id-dehriet, il-warehouse u s-server Snowflake tiegħek.

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"
$$;

L-ismijiet tal-għodod u l-oġġetti ta’ Snowflake f’din id-dikjarazzjoni huma eżempji:

• support-search jesponi s-servizz Cortex Search speċifikat.

• revenue-analyst jesponi d-dehra semantika speċifikata. Żid għodod għal dehriet oħra skont il-bżonn.

• sql-readonly jesponi SQL għall-qari biss bil-warehouse speċifikat.

Uża ismijiet tal-għodod stabbli u deskrittivi biex ChatGPT ikun jista’ jagħżel l-għodda t-tajba. Il-ħolqien tas-server MCP ma jagħtix awtomatikament aċċess għall-oġġetti sottostanti ta’ Snowflake.

Għal aktar għażliet tal-ispeċifikazzjoni, ara: Oħloq server MCP immaniġġjat minn Snowflake.

Agħti l-permessi t-tajba ta’ Snowflake

Agħżel ir-rwol ta’ Snowflake li bih se jawtorizzaw l-utenti, imbagħad agħti lil dak ir-rwol aċċess għal

1. Id-database u l-iskemi.

2. Is-server MCP.

3. Kull oġġett sottostanti użat mill-għodod, bħal servizz tat-tiftix, dehra semantika jew warehouse.

Eżempju:

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;

Jekk is-server MCP jesponi UDF, proċedura maħżuna jew Cortex Agent, agħti wkoll il-permessi meħtieġa għal dak l-oġġett.

Ivverifika li Snowflake huwa lest

Ħaddem:

SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;

Imbagħad ħaddem:

DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;

Ikkonferma li:

• Is-server jeżisti fid-database u l-iskemi mistennija.

• Il-lista tal-għodod hija dik li ridt.

• L-identifier ta’ kull għodda jindika l-oġġett it-tajjeb ta’ Snowflake.

• Ir-rwol li qed jikkonnettja għandu USAGE fuq is-server MCP.

• Ir-rwol li qed jikkonnettja għandu l-permessi meħtieġa fuq kull oġġett sottostanti.

Daħħal id-dettalji tas-server Snowflake fi ChatGPT

1. Fi ChatGPT, aqleb għall-kont jew il-workspace fejn għandha tkun disponibbli l-app.

2. Iftaħ Settings. Għal konfigurazzjoni għall-workspace kollu, iftaħ Workspace settings bħala amministratur tal-workspace.

3. Mur f’Plugins.

4. Fittex Snowflake.

5. Attiva Snowflake - Mudell Uffiċjali.

6. Iftaħ Snowflake - Mudell Uffiċjali, daħħal isem ċar għall-konnessjoni u agħżel Qabbad.

7. Daħħal il-URL sħiħ tas-server MCP immaniġġjat:

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

Eżempju:

https://myorg-myaccount.azure.snowflakecomputing.com/api/v2/databases/CHATGPT_APPS/schemas/TOOLS/mcp-servers/CHATGPT_SNOWFLAKE_MCP

Jekk l-iskrin tal-konfigurazzjoni juri l-konfigurazzjoni ta’ Snowflake bħala oqsma separati, uża l-istess valuri mill-URL:

Prefiss tal-host ta’ Snowflake

Uża dak kollu li jiġi qabel .snowflakecomputing.com fil-URL tal-kont Snowflake tiegħek, inkluż kwalunkwe suffiss tar-reġjun jew tal-cloud.

Pereżempju, jekk il-URL tal-kont jibda b’:

https://myorg-myaccount.azure.snowflakecomputing.com

Il-prefiss tal-host huwa:

myorg-myaccount.azure

Database

Daħħal id-database li fiha s-server MCP, bħal:

CHATGPT_APPS

Skemi

Daħħal l-iskemi li fiha s-server MCP, bħal:

TOOLS

Isem tas-server MCP

Daħħal l-isem tal-oġġett tas-server MCP ta’ Snowflake, bħal:

CHATGPT_SNOWFLAKE_MCP

Ikkonfigura l-klijent OAuth

Biex tikkonnettja, għandek bżonn Client ID u Client Secret mingħand Snowflake.

Meta tuża session:role:all, Snowflake juża r-rwol predefinit ta’ kull utent. Ir-rwol predefinit irid ikun permess mil-lista ta’ rwoli permessi tal-integrazzjoni OAuth, jekk tkun ikkonfigurata, u ma jridx ikun imblukkat. Il-fatt li hemm rwol approvat ieħor ma jagħżlux awtomatikament.

1. Fit-tieqa tal-konfigurazzjoni ta’ ChatGPT, iftaħ Settings avvanzati ta’ OAuth, agħżel Klijent OAuth definit mill-utent u kkopja l-URL tar-ritorn muri fi ChatGPT.

2. Oħloq integrazzjoni tas-sigurtà OAuth personalizzata b’OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' u ssettja OAUTH_REDIRECT_URI għal dak il-URL tar-ritorn eżatt.

3. Ħaddem id-dikjarazzjoni li ġejja fi Snowflake, bl-isem tal-integrazzjoni b’ittri kapitali:

   SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');

4. Mir-riżultat JSON, waħħal oauth_client_id f’ID tal-klijent OAuth u oauth_client_secret f’Sigriet tal-klijent OAuth fi ChatGPT.

5. Issettja Metodu ta’ awtentikazzjoni tal-punt ta’ tmiem tat-token għal client_secret_basic.

Qabbad u mmaniġġja Snowflake

1. Fl-istess tieqa tal-konfigurazzjoni ta’ ChatGPT, agħżel Kompli, idħol fi Snowflake u awtorizza l-konnessjoni.

2. Għal konfigurazzjoni ta’ workspace, ikkonfigura l-politika tal-installazzjoni tal-plugin u l-aċċess skont ir-rwol jew il-grupp għall-membri li għandhom jużawh. Ivverifika li kemm Snowflake kif ukoll Snowflake - Mudell Uffiċjali huma attivati.

3. L-amministraturi tal-workspace huma responsabbli biex jikkonfiguraw Aċċess tal-utenti għar-rwoli li għandhom jużaw Snowflake.

4. L-amministraturi tal-workspace huma responsabbli biex jeżaminaw Kontroll tal-azzjonijiet għall-għodod esposti.

5. L-amministraturi tal-workspace huma responsabbli biex jeżaminaw Permessi tal-app u jagħżlu meta ChatGPT jistaqsi lill-membri qabel juża l-app.

Dawn il-permessi tal-app japplikaw għall-konverżazzjonijiet ta’ ChatGPT. L-Aġenti tal-Workspace jużaw kontrolli għal kull aġent, stabbiliti mill-bennej tal-aġent, biex jiddeterminaw liema azzjonijiet tal-app huma disponibbli u meta l-utenti finali jintalbu japprovawhom. Għall-imġiba tal-aġent, ara: Aġenti tal-Workspace ta’ ChatGPT għal Enterprise u Business.

Ittestja l-app

1. Iftaħ chat, agħżel Snowflake u ttestja l-konnessjoni.

2. Ikkonferma li ChatGPT isib l-għodod li kkonfigurajt.

3. L-ewwel ħaddem azzjoni ta’ qari b’riskju baxx, bħal tiftix jew mistoqsija għall-qari biss fuq data approvata.

4. Ikkonferma li l-permessi ta’ Snowflake jipprevjenu aċċess lil hinn mir-rwol u l-oġġetti approvati.

5. Għal konfigurazzjoni ta’ workspace, ittestja b’membri permessi li mhumiex amministraturi u li għandhom rwoli predefiniti differenti ta’ Snowflake. Konnessjoni b’suċċess minn amministratur ma tikkonfermax li kull membru jista’ jikkonnettja.

Għall-amministraturi tal-workspace, mhux biżżejjed li jiġi attivat biss Snowflake. Jekk Snowflake - Mudell Uffiċjali ma jkunx ġie attivat u mqabbad, il-plugin jista’ jidher diżattivat għall-membri.

Il-URL tas-server MCP u l-imġiba ta’ OAuth

ChatGPT jikkonnettja mal-URL sħiħ tas-server MCP immaniġġjat minn Snowflake:

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

ChatGPT juża l-prefiss tal-host ta’ Snowflake minn dak il-URL biex isib dawn il-punti ta’ tmiem OAuth ta’ Snowflake:

• Awtorizzazzjoni: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/authorize

• Token: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/token-request

Twaħħalx URL ta’ Snowsight, il-URL ewlieni tal-kont Snowflake waħdu, jew URL b’segmenti addizzjonali tal-mogħdija. Il-URL tal-MCP irid jinkludi /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server} u jaqbel eżatt mal-oġġetti ta’ Snowflake tiegħek.

Soluzzjoni tal-problemi

Snowflake huwa attivat għal amministratur iżda diżattivat għal membru

• Ikkonferma li kemm Snowflake kif ukoll Snowflake - Mudell Uffiċjali huma attivati f’Settings tal-workspace > Plugins.

• Iftaħ Snowflake - Mudell Uffiċjali u lesti l-proċess ta’ Qabbad. Mhux biżżejjed li tattiva l-mudell mingħajr ma tqabbdu.

• Iftaħ Snowflake u kkonferma li l-mudell jidher bħala l-app meħtieġa tiegħu.

• Ikkonferma li r-rwol jew il-grupp tal-membru affettwat huwa permess mill-politika tal-installazzjoni tal-plugin.

Is-server MCP ma nstabx

• Erġa’ ċċekkja l-URL sħiħ tas-server MCP, jew l-erba’ oqsma tal-mudell jekk l-iskrin tal-konfigurazzjoni tiegħek jitlobhom.

• Ikkonferma li s-server MCP jeżisti eżatt f’dik id-database u f’dik l-iskemi.

Ma tidher l-ebda għodda fi ChatGPT

• Ikkonferma li l-ispeċifikazzjoni tas-server MCP tinkludi għodod.

• Ikkonferma li r-rwol għandu USAGE fuq is-server MCP.

Għodda tidher iżda ma taħdimx meta tintuża

• Ikkonferma li r-rwol għandu l-permess meħtieġ fuq l-oġġett sottostanti ta’ Snowflake, bħas-servizz tat-tiftix, id-dehra semantika, il-warehouse, il-proċedura jew il-UDF.

L-għodda SQL ma taħdimx

• Ikkonferma li l-isem tal-warehouse huwa korrett u li l-warehouse qed jaħdem.

• Ikkonferma li r-rwol għandu USAGE fuq il-warehouse.

• Ikkonferma li read_only: true huwa ssettjat jekk ridt aċċess għall-qari biss.

Ir-rwol ALL mitlub ġie mblukkat espliċitament

Itlob lill-amministratur ta’ Snowflake jqabbel ir-rwol predefinit tiegħek mar-rwoli permessi u mblukkati tal-integrazzjoni OAuth. Il-fatt li hemm rwol permess ieħor ma jagħżlux awtomatikament. Jekk xieraq, ibdel ir-rwol predefinit għal rwol approvat u erġa’ qabbad. Il-bidla fir-rwol predefinit tiegħek taffettwa wkoll is-sessjonijiet Snowflake tiegħek barra ChatGPT.

L-awtorizzazzjoni ma tirnexxix

• Ikkonferma li l-utent jista’ jidħol fi Snowflake.

• Meta tuża session:role:all, ikkonferma li r-rwol predefinit tal-utent huwa permess mill-integrazzjoni OAuth.

• Ikkonferma li l-konfigurazzjoni tuża l-fluss OAuth tal-MCP immaniġġjat minn Snowflake.

• Ikkonferma li l-Client ID u l-Client Secret jaqblu mal-integrazzjoni OAuth ta’ Snowflake u li l-URI tar-ridirezzjoni tagħha jaqbel mal-URL tar-ritorn muri fi ChatGPT.

Il-politika tan-network jew il-lista ta’ IPs permessi ta’ Snowflake timblokka l-konnettur

• Itlob lil amministratur ta’ Snowflake jaġġorna l-politika tan-network jew ir-regoli tal-aċċess ta’ Snowflake.

• Ippermetti konnessjonijiet deħlin mill-firxiet attwali tal-IP tal-ħruġ tal-konnettur ta’ ChatGPT.

• Ikkonfigura din il-lista ta’ permessi fi Snowflake. Din hija separata mil-lista ta’ IPs permessi tal-workspace ta’ ChatGPT.

• Meta jkun possibbli, awtomatizza l-aġġornamenti mill-JSON ippubblikat għax il-firxiet jistgħu jinbidlu.

Problema ta’ konnessjoni mal-isem tal-host

Uża l-prefiss korrett tal-host ta’ Snowflake. Ismijiet tal-host ta’ Snowflake b’linji taħt jistgħu joħolqu problemi; ippreferi sings.

Referenzi

• Server MCP immaniġġjat minn Snowflake

• CREATE MCP SERVER

• DESCRIBE MCP SERVER

• SHOW MCP SERVERS