Notaðu þessar leiðbeiningar ef þú ert stjórnandi ChatGPT-vinnusvæðis eða notandi ChatGPT Plus eða ChatGPT Pro og vilt tengja ChatGPT við Snowflake í gegnum MCP-þjón sem Snowflake hefur umsjón með.

Uppsetningin fer að mestu fram í Snowflake. Þegar Snowflake er tilbúið skaltu ljúka við tengingu Snowflake-sniðmátsins í ChatGPT og virkja síðan Snowflake-viðbótina sem notar sniðmátið.

Það sem þú ert að setja upp

Þú ert að búa til MCP-þjón sem Snowflake hefur umsjón með og virkar sem endapunktur tengingarinnar fyrir ChatGPT. MCP-þjónninn skilgreinir:

• Hvaða aðgerðir ChatGPT getur notað.

• Að hvaða Snowflake-gögnum eða -hlutum þessi verkfæri hafa aðgang.

• Með hvaða Snowflake-hlutverki hver notandi veitir heimild.

• Hvaða Snowflake-gagnagrunnur, skema og heiti MCP-þjóns auðkenna endapunktinn.

Síðan grunnstillirðu Snowflake – opinbert sniðmát í ChatGPT með fullri vefslóð MCP-þjónsins. Á uppsetningarskjánum gæti vefslóðin birst sem fjórir aðskildir reitir:

• Hýsilforskeyti Snowflake.

• Gagnagrunnur.

• Skema.

• Heiti MCP-þjóns.

ChatGPT getur aðeins fundið og notað verkfæri sem MCP-þjónninn birtir og Snowflake-hlutverkið sem notandinn veitir heimild með leyfir.

Áður en hafist er handa

Þú þarft:

• Aðgang stjórnanda eða eiganda ChatGPT-vinnusvæðis, eða aðgang að ChatGPT Plus eða ChatGPT Pro.

• Snowflake-aðgang sem heimilar stofnun MCP-þjónshluta og úthlutun heimilda.

• Snowflake-gagnagrunninn og skemað þar sem MCP-þjónninn verður vistaður.

• Ákvörðun um hvað ChatGPT má gera, svo sem að nota Cortex Search, Cortex Analyst, skrifvarða SQL-vinnslu eða tiltekið ferli eða fall.

• Snowflake-hlutverk með lágmarksheimildum sem notendur nota þegar þeir veita forritinu heimild.

• Hýsilforskeyti Snowflake-reikningsins, ásamt hugsanlegu svæðis- eða skýjaviðskeyti.

Ef Snowflake-reikningurinn þinn takmarkar aðgang með netstefnu eða lista yfir leyfðar IP-tölur skaltu biðja Snowflake-stjórnanda að leyfa tengingar inn frá núverandi IP-bilum útleiðartenginga ChatGPT-tengilsins. Listinn breytist og þarf að halda honum uppfærðum.

Gildi sem þarf að undirbúa

• Hýsilforskeyti Snowflake: allt sem kemur á undan .snowflakecomputing.com í vefslóð Snowflake-reikningsins.

• Gagnagrunnur: gagnagrunnurinn sem inniheldur MCP-þjóninn.

• Skema: skemað sem inniheldur MCP-þjóninn.

• Heiti MCP-þjóns: heiti MCP-þjónshlutarins í Snowflake.

• Full vefslóð MCP-þjónsins ef uppsetningarskjár ChatGPT biður um vefslóð.

• Snowflake-hlutverk: hlutverkið sem notendur eiga að nota þegar þeir veita forritinu heimild.

• Verkfæralisti: Snowflake-hlutirnir og aðgerðirnar sem þú vilt að ChatGPT noti.

Ákveddu hvað ChatGPT má gera

Veldu aðeins eiginleikana sem þú vilt birta. Algengir valkostir eru meðal annars:

• Leit með Cortex Search til að finna svör í atriðaskráðum Snowflake-gögnum eða -efni.

• Spurningar og svör með Cortex Analyst í gegnum samþykkt merkingarlegt yfirlit.

• Skrifvarin SQL-vinnsla fyrir stýrðan fyrirspurnaaðgang.

• Snowflake Agent, vistað ferli eða UDF fyrir tiltekið verkflæði.

Ef þú virkjar SQL skaltu hafa aðganginn skrifvarinn nema fyrirtækið hafi yfirfarið og samþykkt skrifaðgang.

Opnaðu Snowflake-vinnublað

1. Skráðu þig inn í Snowflake-forritið.

2. Skiptu yfir í hlutverk sem getur stofnað MCP-þjóninn og veitt aðgang.

3. Farðu í Vinnusvæði.

   

4. Búðu til vinnusvæði með SQL-skrá.

   

5. Stilltu samhengi vinnusvæðisins á gagnagrunninn og skemað þar sem MCP-þjónninn verður stofnaður.

   

Stofnaðu Snowflake MCP-þjóninn

Skráðu þig inn í Snowflake með hlutverki sem getur stofnað MCP-þjóninn og veitt aðgang. Opnaðu vinnublað í gagnagrunninum og skemanu þar sem stofna á MCP-þjóninn.

Keyrðu skipun á borð við eftirfarandi dæmi. Skiptu heitunum út fyrir eigin Snowflake-gagnagrunn, skema, þjónustur, yfirlit, vöruhús og heiti þjóns.

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

Heiti verkfæranna og Snowflake-hlutirnir í þessari skipun eru dæmi:

• support-search birtir tilgreindu Cortex Search-þjónustuna.

• revenue-analyst birtir tilgreinda merkingarlega yfirlitið. Bættu við verkfærum fyrir önnur yfirlit eftir þörfum.

• sql-readonly birtir skrifvarða SQL-vinnslu með tilgreindu vöruhúsi.

Notaðu stöðug og lýsandi verkfæraheiti svo ChatGPT geti valið rétta verkfærið. Stofnun MCP-þjónsins veitir ekki sjálfkrafa aðgang að undirliggjandi Snowflake-hlutum.

Frekari valkosti fyrir skilgreininguna er að finna hér: Stofna MCP-þjón sem Snowflake hefur umsjón með.

Veittu réttar Snowflake-heimildir

Veldu Snowflake-hlutverkið sem notendur veita heimild með og veittu því síðan aðgang að

1. Gagnagrunninum og skemanu.

2. MCP-þjóninum.

3. Öllum undirliggjandi hlutum sem verkfærin nota, svo sem leitarþjónustu, merkingarlegu yfirliti eða vöruhúsi.

Dæmi:

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;

Ef MCP-þjónninn birtir UDF, vistað ferli eða Cortex Agent skaltu einnig veita nauðsynlegar heimildir fyrir þann hlut.

Gakktu úr skugga um að Snowflake sé tilbúið

Keyrðu:

SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;

Keyrðu síðan:

DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;

Staðfestu eftirfarandi:

• Þjónninn er til í réttum gagnagrunni og réttu skema.

• Verkfæralistinn er eins og til stóð.

• identifier hvers verkfæris vísar á réttan Snowflake-hlut.

• Hlutverkið sem tengist hefur USAGE-heimild fyrir MCP-þjóninn.

• Hlutverkið sem tengist hefur nauðsynlegar heimildir fyrir hvern undirliggjandi hlut.

Sláðu upplýsingar Snowflake-þjónsins inn í ChatGPT

1. Skiptu í ChatGPT yfir á reikninginn eða vinnusvæðið þar sem forritið á að vera tiltækt.

2. Opnaðu Stillingar. Fyrir uppsetningu á öllu vinnusvæðinu skaltu opna Stillingar vinnusvæðis sem stjórnandi vinnusvæðis.

3. Farðu í Viðbætur.

4. Leitaðu að Snowflake.

5. Virkjaðu Snowflake – opinbert sniðmát.

6. Opnaðu Snowflake – opinbert sniðmát, sláðu inn skýrt heiti tengingar og veldu Tengjast.

7. Sláðu inn fulla vefslóð MCP-þjónsins:

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

Dæmi:

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

Ef Snowflake-grunnstillingin birtist sem aðskildir reitir á uppsetningarskjánum skaltu nota sömu gildi og í vefslóðinni:

Hýsilforskeyti Snowflake

Notaðu allt sem kemur á undan .snowflakecomputing.com í vefslóð Snowflake-reikningsins, ásamt hugsanlegu svæðis- eða skýjaviðskeyti.

Ef vefslóð reikningsins hefst til dæmis á:

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

Er hýsilforskeytið:

myorg-myaccount.azure

Gagnagrunnur

Sláðu inn gagnagrunninn sem inniheldur MCP-þjóninn, til dæmis:

CHATGPT_APPS

Skema

Sláðu inn skemað sem inniheldur MCP-þjóninn, til dæmis:

TOOLS

Heiti MCP-þjóns

Sláðu inn heiti Snowflake MCP-þjónshlutarins, til dæmis:

CHATGPT_SNOWFLAKE_MCP

Grunnstilltu OAuth-biðlarann

Til að tengjast þarftu biðlaraauðkenni og biðlaraleyndarmál frá Snowflake.

Þegar þú notar session:role:all notar Snowflake sjálfgefið hlutverk hvers notanda. Sjálfgefna hlutverkið þarf að vera leyft á lista OAuth-samþættingarinnar yfir leyfð hlutverk, ef hann er grunnstilltur, og má ekki vera útilokað. Annað samþykkt hlutverk er ekki valið sjálfkrafa.

1. Opnaðu Ítarlegar OAuth-stillingar í uppsetningarglugga ChatGPT, veldu Notandaskilgreindur OAuth-biðlari og afritaðu Bakvísunarslóðina sem birtist í ChatGPT.

2. Búðu til sérsniðna OAuth-öryggissamþættingu með OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' og stilltu OAUTH_REDIRECT_URI á nákvæmlega þessa bakvísunarslóð.

3. Keyrðu eftirfarandi skipun í Snowflake og notaðu heiti samþættingarinnar með hástöfum:

   SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');

4. Límdu oauth_client_id úr JSON-niðurstöðunni í Auðkenni OAuth-biðlara og oauth_client_secret í Leyndarmál OAuth-biðlara í ChatGPT.

5. Stilltu Auðkenningaraðferð tókaendapunkts á client_secret_basic.

Tengdu og stjórnaðu Snowflake

1. Veldu Halda áfram í sama uppsetningarglugga ChatGPT, skráðu þig inn í Snowflake og veittu tengingunni heimild.

2. Fyrir uppsetningu vinnusvæðis skaltu grunnstilla uppsetningarstefnu viðbótarinnar og aðgang hlutverka eða hópa fyrir þá meðlimi sem eiga að nota hana. Gakktu úr skugga um að bæði Snowflake og Snowflake – opinbert sniðmát séu virk.

3. Stjórnendur vinnusvæðis bera ábyrgð á að grunnstilla Notandaaðgang fyrir hlutverkin sem eiga að nota Snowflake.

4. Stjórnendur vinnusvæðis bera ábyrgð á að yfirfara Aðgerðastýringu fyrir birtu verkfærin.

5. Stjórnendur vinnusvæðis bera ábyrgð á að yfirfara Heimildir forrits og velja hvenær ChatGPT biður meðlimi um leyfi áður en forritið er notað.

Þessar forritsheimildir gilda um samtöl í ChatGPT. Fulltrúar vinnusvæðis nota stýringar fyrir hvern fulltrúa, sem höfundur hans stillir, til að ákvarða hvaða forritsaðgerðir eru tiltækar og hvenær endanotendur eru beðnir um að samþykkja þær. Upplýsingar um hegðun fulltrúa eru hér: Fulltrúar ChatGPT-vinnusvæða fyrir Enterprise og Business.

Prófaðu forritið

1. Opnaðu spjall, veldu Snowflake og prófaðu tenginguna.

2. Staðfestu að ChatGPT finni verkfærin sem þú grunnstilltir.

3. Keyrðu fyrst skrifvarða aðgerð með lítilli áhættu, svo sem leit eða skrifvarða fyrirspurn í samþykkt gögn.

4. Staðfestu að Snowflake-heimildir komi í veg fyrir aðgang utan samþykkta hlutverksins og hlutanna.

5. Fyrir uppsetningu vinnusvæðis skaltu prófa með leyfðum meðlimum sem eru ekki stjórnendur og hafa ólík sjálfgefin Snowflake-hlutverk. Þótt tenging stjórnanda takist er ekki þar með staðfest að allir meðlimir geti tengst.

Fyrir stjórnendur vinnusvæðis nægir ekki að virkja aðeins Snowflake. Ef Snowflake – opinbert sniðmát hefur ekki verið virkjað og tengt gæti viðbótin virst óvirk fyrir meðlimi.

Vefslóð MCP-þjóns og hegðun OAuth

ChatGPT tengist fullri vefslóð MCP-þjónsins sem Snowflake hefur umsjón með:

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

ChatGPT notar hýsilforskeyti Snowflake úr vefslóðinni til að finna þessa OAuth-endapunkta Snowflake:

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

• Tókar: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/token-request

Ekki líma inn Snowsight-vefslóð, aðeins grunnvefslóð Snowflake-reikningsins eða vefslóð með viðbótarslóðarhlutum. MCP-vefslóðin verður að innihalda /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server} og samsvara Snowflake-hlutunum þínum nákvæmlega.

Úrræðaleit

Snowflake er virkt fyrir stjórnanda en óvirkt fyrir meðlim

• Staðfestu að bæði Snowflake og Snowflake – opinbert sniðmát séu virk í Stillingar vinnusvæðis > Viðbætur.

• Opnaðu Snowflake – opinbert sniðmát og ljúktu ferlinu undir Tengjast. Það nægir ekki að virkja sniðmátið án þess að tengja það.

• Opnaðu Snowflake og staðfestu að sniðmátið birtist sem nauðsynlegt forrit.

• Staðfestu að hlutverk eða hópur viðkomandi meðlims sé leyfður samkvæmt uppsetningarstefnu viðbótarinnar.

MCP-þjónn fannst ekki

• Athugaðu aftur fulla vefslóð MCP-þjónsins eða reitina fjóra ef uppsetningarskjárinn biður um þá.

• Staðfestu að MCP-þjónninn sé til í nákvæmlega þessum gagnagrunni og þessu skema.

Engin verkfæri birtast í ChatGPT

• Staðfestu að skilgreining MCP-þjónsins innihaldi verkfæri.

• Staðfestu að hlutverkið hafi USAGE-heimild fyrir MCP-þjóninn.

Verkfæri birtist en bregst við notkun

• Staðfestu að hlutverkið hafi nauðsynlega heimild fyrir undirliggjandi Snowflake-hlut, svo sem leitarþjónustu, merkingarlegu yfirliti, vöruhúsi, ferli eða UDF.

SQL-verkfærið bregst

• Staðfestu að heiti vöruhússins sé rétt og að vöruhúsið sé í gangi.

• Staðfestu að hlutverkið hafi USAGE-heimild fyrir vöruhúsið.

• Staðfestu að read_only: true sé stillt ef skrifvarinn aðgangur var ætlunin.

Umbeðna hlutverkið ALL hefur verið útilokað sérstaklega

Biddu Snowflake-stjórnandann að bera sjálfgefna hlutverkið þitt saman við leyfð og útilokuð hlutverk OAuth-samþættingarinnar. Annað leyft hlutverk er ekki valið sjálfkrafa. Ef við á skaltu breyta sjálfgefna hlutverkinu í samþykkt hlutverk og tengjast aftur. Breyting á sjálfgefna hlutverkinu hefur einnig áhrif á Snowflake-lotur utan ChatGPT.

Heimildarveiting mistekst

• Staðfestu að notandinn geti skráð sig inn í Snowflake.

• Þegar session:role:all er notað skaltu staðfesta að sjálfgefið hlutverk notandans sé leyft af OAuth-samþættingunni.

• Staðfestu að uppsetningin noti OAuth-flæði MCP-þjóns sem Snowflake hefur umsjón með.

• Staðfestu að biðlaraauðkennið og biðlaraleyndarmálið samsvari OAuth-samþættingu Snowflake og að bakvísunarslóð hennar samsvari Bakvísunarslóðinni sem birtist í ChatGPT.

Netstefna Snowflake eða listi yfir leyfðar IP-tölur lokar á tengilinn

• Biddu Snowflake-stjórnanda að uppfæra netstefnu eða aðgangsreglur Snowflake.

• Leyfðu tengingar inn frá núverandi IP-bilum útleiðartenginga ChatGPT-tengilsins.

• Grunnstilltu þennan lista yfir leyfðar IP-tölur í Snowflake. Hann er aðskilinn frá lista ChatGPT-vinnusvæðisins yfir leyfðar IP-tölur.

• Gerðu uppfærslur úr útgefnu JSON-skránni sjálfvirkar þegar hægt er, því bilin geta breyst.

Vandamál við tengingu við hýsilheiti

Notaðu rétt hýsilforskeyti Snowflake. Undirstrik í Snowflake-hýsilheitum geta valdið vandamálum; notaðu frekar bandstrik.

Tilvísanir

• MCP-þjónn sem Snowflake hefur umsjón með

• CREATE MCP SERVER

• DESCRIBE MCP SERVER

• SHOW MCP SERVERS