Túto príručku použite, ak ste správca pracovného priestoru ChatGPT a nastavujete šablónu aplikácie Snowflake pre svoju organizáciu. Šablóna nie je finálna aplikácia, ktorú členovia používajú. Je to postup nastavenia, ktorý po zadaní požadovanej konfigurácie Snowflake vytvorí koncept aplikácie špecifický pre pracovný priestor.
V prípade Snowflake sa väčšina nastavenia vykonáva v Snowflake. Vytvoríte server MCP spravovaný službou Snowflake, udelíte správnej role prístup k serveru MCP a jeho podkladovým objektom a potom v postupe nastavenia šablóny ChatGPT zadáte URL spravovaného servera MCP alebo jeho čiastkové polia. Keď ChatGPT vytvorí koncept aplikácie, môžete ho publikovať a spravovať ako iné aplikácie pracovného priestoru.
Čo nastavujete
Vytvárate aplikáciu Snowflake v ChatGPT špecifickú pre pracovný priestor. Aplikácia sa pripája k serveru MCP spravovanému službou Snowflake, ktorý definuje:
Ktoré akcie môže ChatGPT používať, nazývané nástroje.
Ku ktorým údajom alebo objektom Snowflake môžu tieto nástroje pristupovať.
S ktorou rolou Snowflake sa majú používatelia autorizovať.
Ktorá databáza, schéma a názov servera MCP v Snowflake identifikujú koncový bod konektora.
ChatGPT môže objaviť a používať iba nástroje vystavené serverom MCP a povolené rolou Snowflake, s ktorou sa používateľ autorizuje.
Skôr než začnete
Potrebujete:
Prístup správcu alebo vlastníka pracovného priestoru ChatGPT.
Prístup k Snowflake, ktorý umožňuje vytvárať objekty servera MCP a udeľovať povolenia.
Databázu a schému Snowflake, v ktorej bude server MCP umiestnený.
Rozhodnutie o tom, čo má mať ChatGPT povolené robiť, napríklad Cortex Search, Cortex Analyst, SQL iba na čítanie alebo konkrétnu procedúru či funkciu.
Rolu Snowflake s minimálnymi oprávneniami, ktorú budú používatelia používať pri autorizácii aplikácie.
Predponu hostiteľa účtu Snowflake vrátane prípadnej prípony regiónu alebo cloudu.
Hodnoty na prípravu
Predpona hostiteľa Snowflake: všetko pred .snowflakecomputing.com v URL účtu Snowflake.
Databáza: databáza obsahujúca server MCP.
Schéma: schéma obsahujúca server MCP.
Názov servera MCP: názov objektu servera MCP v Snowflake.
Úplná URL spravovaného servera MCP, ak obrazovka nastavenia ChatGPT požaduje URL.
Rola Snowflake: rola, ktorú majú používatelia používať pri autorizácii aplikácie.
Zoznam nástrojov: objekty a akcie Snowflake, ktoré chcete, aby ChatGPT používal.
Rozhodnite, čo môže ChatGPT robiť
Vyberte iba funkcie, ktoré chcete sprístupniť. Bežné možnosti zahŕňajú:
Vyhľadávanie pomocou Cortex Search na nájdenie odpovedí v indexovaných údajoch alebo obsahu Snowflake.
Otázky a odpovede s Cortex Analyst prostredníctvom schváleného sémantického zobrazenia.
SQL iba na čítanie na kontrolovaný prístup k dotazom.
Snowflake Agent, uložená procedúra alebo UDF pre konkrétne pracovné postupy.
Ak povolíte SQL, ponechajte ho iba na čítanie, pokiaľ vaša organizácia neskontrolovala a neschválila prístup na zápis.
Vytvorenie servera MCP v Snowflake
V Snowflake sa prihláste s rolou, ktorá môže vytvoriť server MCP a udeliť prístup. Otvorte pracovný hárok v databáze a schéme, v ktorej sa má server MCP vytvoriť.
Vytvorte server MCP, ktorý uvádza iba nástroje, ktoré má ChatGPT používať. Nahraďte názvy objektov vlastnou databázou, schémou, službami, zobrazeniami, skladom a názvom servera v Snowflake.
Príklad:
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: "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" $$;
Názvy nástrojov by mali byť stabilné a opisné, aby si ChatGPT vedel vybrať správny nástroj. Vytvorenie servera MCP automaticky neudeľuje prístup k podkladovým objektom Snowflake.
Udelenie správnych povolení Snowflake
Vyberte rolu Snowflake, s ktorou sa používatelia budú autorizovať, a potom tejto role udeľte prístup k databáze, schéme, serveru MCP a každému podkladovému objektu používanému nástrojmi.
Príklad:
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 USAGE ON WAREHOUSE CHATGPT_WH TO ROLE CHATGPT_CONNECTOR_ROLE;
Ak server MCP vystavuje sémantické zobrazenie, UDF, uloženú procedúru alebo Cortex Agent, udeľte potrebné povolenia aj pre tieto objekty.
Overenie pripravenosti Snowflake
Spustite:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Potom spustite:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Potvrďte:
Server existuje v očakávanej databáze a schéme.
Zoznam nástrojov zodpovedá vášmu zámeru.
Každý identifikátor nástroja odkazuje na správny objekt Snowflake.
Pripájajúca sa rola má na serveri MCP oprávnenie USAGE.
Pripájajúca sa rola má potrebné povolenia ku každému podkladovému objektu.
Spustenie nastavenia šablóny v ChatGPT
V ChatGPT prepnite na pracovný priestor, v ktorom má byť aplikácia dostupná.
Otvorte Nastavenia pracovného priestoru > Aplikácie.
Vyberte Adresár.
Vyhľadajte Snowflake.
Vyberte šablónu aplikácie Snowflake a spustite nastavenie.
Zadajte jasný názov a opis aplikácie, napríklad Snowflake alebo Snowflake – Analytics.
Zadajte podrobnosti spravovaného servera MCP požadované postupom nastavenia.
Ak obrazovka nastavenia požaduje úplnú URL spravovaného servera MCP, použite tento formát:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Ak obrazovka nastavenia požaduje samostatné polia, použite rovnaké hodnoty z tejto URL:
Predpona hostiteľa Snowflake.
Databáza.
Schéma.
Názov servera MCP.
Vytvorenie a publikovanie konceptu aplikácie
Uložte nastavenie šablóny Snowflake v ChatGPT.
Vytvorte koncept aplikácie.
Skontrolujte podrobnosti konceptu aplikácie, nastavenia overovania a dostupné akcie.
Keď bude koncept aplikácie pripravený, publikujte ho.
Potvrďte, že sa aplikácia zobrazuje v časti Nastavenia pracovného priestoru > Aplikácie > Povolené.
Nakonfigurujte Prístup používateľov pre roly, ktoré ju majú používať.
Skontrolujte Riadenie akcií pre vystavené nástroje.
Skontrolujte Povolenia aplikácie a vyberte, kedy sa ChatGPT opýta členov pred použitím aplikácie.
Tieto povolenia aplikácie sa vzťahujú na konverzácie ChatGPT. Agenti pracovného priestoru používajú ovládacie prvky pre jednotlivých agentov nastavené tvorcom agenta na určenie, ktoré akcie aplikácie sú dostupné a kedy sú koncoví používatelia požiadaní o ich schválenie. Správanie agentov nájdete v časti: Agenti pracovného priestoru ChatGPT pre Enterprise a Business.
Testovanie aplikácie
Spustite postup pripojenia z ChatGPT ako povolený testovací používateľ.
Prihláste sa do Snowflake a ak sa zobrazí výzva, vyberte zamýšľanú rolu.
Potvrďte, že ChatGPT objaví očakávané nástroje zo servera MCP.
Najprv spustite nízkorizikovú akciu čítania, napríklad vyhľadávanie alebo dotaz iba na čítanie nad schválenými údajmi.
Potvrďte, že povolenia Snowflake bránia prístupu mimo schválenej roly a objektov.
URL servera MCP a správanie OAuth
ChatGPT sa pripája k úplnej URL servera MCP spravovaného službou Snowflake. ChatGPT používa predponu hostiteľa Snowflake z tejto URL na vyriešenie koncových bodov Snowflake OAuth.
Nevkladajte URL Snowsight, samotnú koreňovú URL účtu Snowflake ani žiadnu URL s dodatočnými segmentmi cesty. URL MCP musí obsahovať cestu k databáze, schéme a serveru MCP a musí presne zodpovedať vašim objektom Snowflake.
Riešenie problémov
Server MCP sa nenašiel: znovu skontrolujte úplnú URL servera MCP alebo samostatné polia predpony hostiteľa, databázy, schémy a servera.
V ChatGPT sa nezobrazujú žiadne nástroje: potvrďte, že špecifikácia servera MCP obsahuje nástroje a rola má na serveri MCP oprávnenie USAGE.
Nástroj sa zobrazuje, ale pri použití zlyhá: potvrďte, že rola má správne povolenie k podkladovému objektu Snowflake.
Nástroj SQL zlyhá: potvrďte, že názov skladu je správny, sklad je dostupný, rola má na ňom oprávnenie USAGE a read_only je true, ak ste zamýšľali prístup iba na čítanie.
Autorizácia zlyhá: potvrďte, že používateľ sa môže prihlásiť do Snowflake a použiť zamýšľanú rolu.
Problém s pripojením k názvu hostiteľa: použite správnu predponu hostiteľa Snowflake. Názvy hostiteľov Snowflake s podčiarkovníkmi môžu spôsobovať problémy; uprednostnite spojovníky.