Tento průvodce použijte, pokud jste správcem pracovního prostoru ChatGPT a nastavujete šablonu aplikace Snowflake pro svou organizaci. Šablona není finální aplikace, kterou členové používají. Jde o postup nastavení, který po zadání požadované konfigurace Snowflake vytvoří koncept aplikace specifický pro pracovní prostor.
U Snowflake probíhá většina nastavení ve Snowflake. Vytvoříte server MCP spravovaný Snowflake, udělíte příslušné roli přístup k serveru MCP a jeho podkladovým objektům a potom v postupu nastavení šablony ChatGPT zadáte URL spravovaného serveru MCP nebo pole jeho komponent. Jakmile ChatGPT vytvoří koncept aplikace, můžete ji publikovat a spravovat stejně jako ostatní aplikace pracovního prostoru.
Co nastavujete
Vytváříte aplikaci Snowflake specifickou pro pracovní prostor v ChatGPT. Aplikace se připojuje k serveru MCP spravovanému Snowflake, který definuje:
Které akce může ChatGPT používat, označované jako nástroje.
Ke kterým datům nebo objektům Snowflake mají tyto nástroje přístup.
Pomocí které role Snowflake by se uživatelé měli autorizovat.
Která databáze, schéma a název serveru MCP ve Snowflake identifikují koncový bod konektoru.
ChatGPT může objevit a používat pouze nástroje vystavené serverem MCP a povolené rolí Snowflake, pomocí které se uživatel autorizuje.
Než začnete
Potřebujete:
Přístup správce nebo vlastníka pracovního prostoru ChatGPT.
Přístup ke Snowflake, který umožňuje vytvářet objekty serveru MCP a udělovat oprávnění.
Databázi a schéma Snowflake, kde bude server MCP umístěn.
Rozhodnutí, co má mít ChatGPT povoleno dělat, například Cortex Search, Cortex Analyst, SQL jen pro čtení nebo konkrétní proceduru či funkci.
Roli Snowflake s nejnižšími potřebnými oprávněními, kterou uživatelé použijí při autorizaci aplikace.
Prefix hostitele účtu Snowflake, včetně případné přípony regionu nebo cloudu.
Hodnoty k přípravě
Prefix hostitele Snowflake: vše před .snowflakecomputing.com v URL účtu Snowflake.
Databáze: databáze obsahující server MCP.
Schéma: schéma obsahující server MCP.
Název serveru MCP: název objektu serveru MCP ve Snowflake.
Úplná URL spravovaného serveru MCP, pokud obrazovka nastavení ChatGPT požaduje URL.
Role Snowflake: role, kterou by uživatelé měli použít při autorizaci aplikace.
Seznam nástrojů: objekty a akce Snowflake, které má ChatGPT používat.
Rozhodněte, co může ChatGPT dělat
Vyberte jen funkce, které chcete zpřístupnit. Mezi běžné možnosti patří:
Vyhledávání pomocí Cortex Search pro nalezení odpovědí v indexovaných datech nebo obsahu Snowflake.
Otázky a odpovědi s Cortex Analyst prostřednictvím schváleného sémantického zobrazení.
SQL jen pro čtení pro řízený přístup k dotazům.
Snowflake Agent, uložená procedura nebo UDF pro konkrétní pracovní postupy.
Pokud povolíte SQL, ponechte ho jen pro čtení, pokud vaše organizace nezkontrolovala a neschválila přístup pro zápis.
Vytvoření serveru MCP ve Snowflake
Ve Snowflake se přihlaste s rolí, která může vytvořit server MCP a udělit přístup. Otevřete pracovní list v databázi a schématu, kde má být server MCP vytvořen.
Vytvořte server MCP, který uvádí pouze nástroje, které má ChatGPT používat. Nahraďte názvy objektů vlastní databází, schématem, službami, zobrazeními, warehousem a názvem serveru ve Snowflake.
Pří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ástrojů by měly být stabilní a popisné, aby ChatGPT mohl vybrat správný nástroj. Vytvoření serveru MCP automaticky neuděluje přístup k podkladovým objektům Snowflake.
Udělení správných oprávnění Snowflake
Vyberte roli Snowflake, pomocí které se uživatelé budou autorizovat, a potom této roli udělte přístup k databázi, schématu, serveru MCP a každému podkladovému objektu používanému nástroji.
Pří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;
Pokud server MCP zpřístupňuje sémantické zobrazení, UDF, uloženou proceduru nebo Cortex Agent, udělte požadovaná oprávnění i pro tyto objekty.
Ověření, že je Snowflake připraven
Spusťte:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Potom spusťte:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Potvrďte:
Server existuje v očekávané databázi a schématu.
Seznam nástrojů odpovídá vašemu záměru.
Každý identifikátor nástroje odkazuje na správný objekt Snowflake.
Připojující se role má oprávnění USAGE na serveru MCP.
Připojující se role má potřebná oprávnění ke každému podkladovému objektu.
Zahájení nastavení šablony v ChatGPT
V ChatGPT přepněte do pracovního prostoru, kde má být aplikace dostupná.
Otevřete Nastavení pracovního prostoru > Aplikace.
Vyberte Adresář.
Vyhledejte Snowflake.
Vyberte šablonu aplikace Snowflake a spusťte nastavení.
Zadejte jasný název a popis aplikace, například Snowflake nebo Snowflake - Analytics.
Zadejte údaje spravovaného serveru MCP vyžádané postupem nastavení.
Pokud obrazovka nastavení požaduje úplnou URL spravovaného serveru MCP, použijte tento formát:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Pokud obrazovka nastavení požaduje samostatná pole, použijte stejné hodnoty z této URL:
Prefix hostitele Snowflake.
Databáze.
Schéma.
Název serveru MCP.
Vytvoření a publikování konceptu aplikace
Uložte nastavení šablony Snowflake v ChatGPT.
Vytvořte koncept aplikace.
Zkontrolujte podrobnosti konceptu aplikace, nastavení ověřování a dostupné akce.
Až bude koncept aplikace připraven, publikujte ho.
Potvrďte, že se aplikace zobrazuje v části Nastavení pracovního prostoru > Aplikace > Povoleno.
Nakonfigurujte Přístup uživatelů pro role, které ji mají používat.
Zkontrolujte Řízení akcí pro zpřístupněné nástroje.
V části Oprávnění aplikace zvolte, kdy se ChatGPT členů zeptá před použitím aplikace.
Tato oprávnění aplikace se vztahují na konverzace ChatGPT. Agenti pracovního prostoru používají ovládací prvky pro jednotlivé agenty nastavené tvůrcem agenta k určení, které akce aplikace jsou dostupné a kdy jsou koncoví uživatelé požádáni o jejich schválení. Chování agentů najdete zde: ChatGPT Workspace Agents pro Enterprise a Business.
Testování aplikace
Spusťte postup připojení z ChatGPT jako povolený testovací uživatel.
Přihlaste se ke Snowflake a po výzvě vyberte zamýšlenou roli.
Potvrďte, že ChatGPT objeví očekávané nástroje ze serveru MCP.
Nejprve spusťte nízkorizikovou akci čtení, například vyhledávání nebo dotaz jen pro čtení nad schválenými daty.
Potvrďte, že oprávnění Snowflake brání přístupu mimo schválenou roli a objekty.
URL serveru MCP a chování OAuth
ChatGPT se připojuje k úplné URL serveru MCP spravovaného Snowflake. ChatGPT používá prefix hostitele Snowflake z této URL k vyřešení koncových bodů OAuth pro Snowflake.
Nevkládejte URL Snowsight, samotnou kořenovou URL účtu Snowflake ani žádnou URL s dalšími segmenty cesty. URL MCP musí obsahovat databázi, schéma a cestu k serveru MCP a musí přesně odpovídat vašim objektům Snowflake.
Řešení potíží
Server MCP nebyl nalezen: znovu zkontrolujte úplnou URL serveru MCP nebo samostatná pole prefixu hostitele, databáze, schématu a serveru.
V ChatGPT se nezobrazují žádné nástroje: potvrďte, že specifikace serveru MCP obsahuje nástroje a že role má oprávnění USAGE na serveru MCP.
Nástroj se zobrazuje, ale při použití selže: potvrďte, že role má správné oprávnění k podkladovému objektu Snowflake.
Nástroj SQL selže: potvrďte, že název warehousu je správný, warehouse je dostupný, role na něm má oprávnění USAGE a read_only je true, pokud jste zamýšleli přístup jen pro čtení.
Autorizace selže: potvrďte, že se uživatel může přihlásit ke Snowflake a používat zamýšlenou roli.
Problém s připojením k názvu hostitele: použijte správný prefix hostitele Snowflake. Názvy hostitelů Snowflake s podtržítky mohou způsobovat problémy; upřednostněte spojovníky.