Tato stránka byla přeložena strojově. Zobrazit původní článek v angličtině.

Nastavení šablony aplikace Snowflake v ChatGPT

Zjistěte, jak mohou správci pracovního prostoru ChatGPT a uživatelé ChatGPT Plus nebo ChatGPT Pro připojit ChatGPT k serveru MCP spravovanému službou Snowflake.

Aktualizováno: 25 days ago

Tento průvodce je určen správcům pracovního prostoru ChatGPT a uživatelům ChatGPT Plus nebo Pro, kteří chtějí propojit ChatGPT se Snowflake prostřednictvím serveru MCP spravovaného službou Snowflake.

Většina nastavení probíhá ve Snowflake. Jakmile je Snowflake připravený, dokončete v ChatGPT připojení šablony Snowflake a poté povolte plugin Snowflake, který tuto šablonu používá.

  • Vestavěný OAuth: Pokud je tato možnost dostupná pro váš účet Snowflake a v ChatGPT, použijte partnerskou aplikaci ChatGPT povolenou správcem Snowflake. Přihlaste se do Snowflake. Pokud má vaše organizace nastavené SSO, použijte ho. V ChatGPT nemusíte zadávat ID klienta ani tajný klíč klienta. Postupujte podle níže uvedené části Vestavěný OAuth.

  • Vlastní klient OAuth: Tuto možnost použijte, pokud vaše organizace vyžaduje vlastního klienta OAuth nebo pokud vestavěný OAuth není dostupný. Postupujte podle níže uvedené části Vlastní klient OAuth.

Obě možnosti OAuth vyžadují níže popsané společné nastavení serveru MCP, oprávnění k podkladovým objektům a síťový přístup. Před konfigurací OAuth dokončete společné nastavení až po část Zadejte údaje o serveru Snowflake do ChatGPT včetně.

Co budete nastavovat

Vytvoříte server MCP spravovaný službou Snowflake, který slouží jako koncový bod MCP pro ChatGPT. Server MCP určuje:

  • Které akce může ChatGPT používat.

  • Ke kterým datům nebo objektům ve Snowflake mají tyto nástroje přístup.

  • Jakou roli ve Snowflake jednotliví uživatelé používají při autorizaci.

  • Která databáze, schéma a název serveru MCP ve Snowflake identifikují koncový bod.

Poté v ChatGPT nakonfigurujete položku Snowflake – Oficiální šablona pomocí úplné URL adresy spravovaného serveru MCP. Na obrazovce nastavení šablony může být URL adresa rozdělena do čtyř samostatných polí:

  • Prefix názvu hostitele Snowflake.

  • Databáze.

  • Schéma.

  • Název serveru MCP.

ChatGPT může vyhledávat a používat pouze nástroje, které server MCP zpřístupňuje a které povoluje role ve Snowflake použitá uživatelem při autorizaci.

Než začnete

Budete potřebovat:

  • Přístup správce nebo vlastníka pracovního prostoru ChatGPT, případně přístup k ChatGPT Plus nebo Pro.

  • Přístup do Snowflake s oprávněním vytvářet objekty serverů MCP a udělovat oprávnění.

  • Databázi a schéma ve Snowflake, kde bude server MCP umístěn.

  • Rozhodnutí, co má ChatGPT smět používat, například Cortex Search, Cortex Analyst, SQL pouze pro čtení nebo konkrétní proceduru či funkci.

  • Roli ve Snowflake s minimálními nezbytnými oprávněními, kterou budou uživatelé používat při autorizaci aplikace.

  • Prefix názvu hostitele účtu Snowflake včetně případné přípony označující region nebo cloud.

Pokud váš účet Snowflake omezuje přístup pomocí síťových zásad nebo seznamu povolených IP adres, požádejte správce Snowflake, aby povolil příchozí připojení z aktuálních rozsahů odchozích IP adres aplikací ChatGPT. Seznam se průběžně mění a je třeba ho udržovat aktuální.

Údaje, které si připravte

  • 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 ji obrazovka nastavení ChatGPT vyžaduje.

  • Role Snowflake: role, kterou mají uživatelé používat při autorizaci aplikace.

  • Seznam nástrojů: objekty a akce Snowflake, které má ChatGPT používat.

Určete, co může ChatGPT dělat

Vyberte pouze funkce, které chcete zpřístupnit. Mezi běžné možnosti patří:

  • Vyhledávání odpovědí v indexovaných datech nebo obsahu Snowflake pomocí Cortex Search.

  • Odpovídání na otázky pomocí Cortex Analyst prostřednictvím schváleného sémantického pohledu.

  • SQL pouze pro čtení pro řízený přístup k dotazování.

  • Agent Snowflake, uložená procedura nebo uživatelsky definovaná funkce (UDF) pro konkrétní pracovní postup.

Pokud povolíte SQL, ponechte ho v režimu pouze pro čtení, pokud vaše organizace neposoudila a neschválila přístup pro zápis.

Otevřete pracovní list Snowflake

  1. Přihlaste se do aplikace Snowflake.

  2. Přepněte na roli, která může vytvářet server MCP a udělovat přístup.

  3. Přejděte do části Pracovní prostory.

    Snowflake navigation menu showing Workspaces selected during MCP server setup.
  4. Vytvořte pracovní prostor se souborem SQL.

    Snowflake workspace with a SQL file open for MCP server setup.
  5. Nastavte kontext pracovního prostoru na databázi a schéma, ve kterých bude server MCP vytvořen.

    Snowflake worksheet context picker showing the role, warehouse, database, and schema.

Vytvořte server MCP ve Snowflake

Přihlaste se do Snowflake s rolí, která může vytvářet server MCP a udělovat přístup. Otevřete pracovní list v databázi a schématu, kde má být server MCP vytvořen.

Spusťte příkaz podle následujícího příkladu. Nahraďte názvy vlastními názvy databáze, schématu, služeb, pohledů, výpočetního clusteru a serveru ve 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 result confirming that the MCP server was successfully created.

Názvy nástrojů a objektů Snowflake v tomto příkazu slouží jako příklady:

  • support-search zpřístupňuje zadanou službu Cortex Search.

  • revenue-analyst zpřístupňuje zadaný sémantický pohled. Podle potřeby přidejte nástroje pro další pohledy.

  • sql-readonly zpřístupňuje SQL pouze pro čtení se zadaným výpočetním clusterem.

Používejte stálé a výstižné názvy nástrojů, aby ChatGPT dokázal vybrat správný nástroj. Vytvoření serveru MCP automaticky neuděluje přístup k podkladovým objektům Snowflake.

Další možnosti specifikace najdete v části Vytvoření serveru MCP spravovaného službou Snowflake.

Udělte správná oprávnění ve Snowflake

Vyberte roli Snowflake, se kterou budou uživatelé provádět autorizaci, a poté jí udělte přístup k následujícím objektům:

  1. Databáze a schéma.

  2. Server MCP.

  3. Každý podkladový objekt používaný nástroji, například vyhledávací služba, sémantický pohled nebo výpočetní cluster.

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

Pokud server MCP zpřístupňuje UDF, uloženou proceduru nebo agenta Cortex, udělte požadovaná oprávnění i k tomuto objektu.

Ověřte, že je Snowflake připravený

Spusťte:

SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;

Poté spusťte:

DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;

Ověřte následující:

  • Server existuje v očekávané databázi a schématu.

  • Seznam nástrojů odpovídá vašemu záměru.

  • Hodnota identifier každého nástroje odkazuje na správný objekt Snowflake.

  • Role použitá k připojení má k serveru MCP oprávnění USAGE.

  • Role použitá k připojení má potřebná oprávnění ke každému podkladovému objektu.

Zadejte údaje o serveru Snowflake do ChatGPT

Při nastavení pracovního prostoru otevřete admin.openai.com, vyberte požadovaný pracovní prostor ChatGPT a otevřete Pluginy. Informace o navigaci v pracovním prostoru a přístupu ke starším aplikacím najdete v článku Správa, zabezpečení a dodržování předpisů pro pluginy a aplikace.

  1. V ChatGPT přepněte na účet nebo pracovní prostor, ve kterém má být aplikace dostupná.

  2. Pro osobní nastavení přejděte do Nastavení > Pluginy. Jako správce pracovního prostoru přejděte pro nastavení pracovního prostoru do Konzole správce > Pluginy.

  3. Vyhledejte Snowflake.

  4. Povolte Snowflake – oficiální šablona.

  5. Otevřete Snowflake – oficiální šablona, zadejte výstižný název připojení a vyberte Připojit.

  6. Zadejte úplnou URL spravovaného serveru MCP:

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

Příklad:

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

ChatGPT Snowflake Template connection form with name, managed MCP server URL, and OAuth settings.

Pokud se na obrazovce nastavení zobrazuje konfigurace Snowflake v samostatných polích, použijte stejné hodnoty jako v URL:

Prefix hostitele Snowflake

Použijte vše před .snowflakecomputing.com v URL vašeho účtu Snowflake včetně případné přípony oblasti nebo cloudu.

Pokud například URL účtu začíná takto:

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

Prefix hostitele je:

myorg-myaccount.azure

Databáze

Zadejte databázi obsahující server MCP, například:

CHATGPT_APPS

Schéma

Zadejte schéma obsahující server MCP, například:

TOOLS

Název serveru MCP

Zadejte název objektu serveru MCP ve Snowflake, například:

CHATGPT_SNOWFLAKE_MCP

Nakonfigurujte OAuth

Vyberte možnost OAuth, která je dostupná pro váš účet a splňuje požadavky vaší organizace. Obě možnosti používají výše uvedené společné nastavení serveru MCP a níže uvedené testy připojení a nastavení řízení přístupu.

U obou možností OAuth používá Snowflake při nastavení session:role:all výchozí roli každého uživatele. Výchozí role musí být na seznamu povolených rolí integrace OAuth, pokud je tento seznam nastavený, a nesmí být blokovaná. To, že máte jinou schválenou roli, neznamená, že se automaticky vybere.

Vestavěný OAuth

Než budete pokračovat, dokončete výše uvedené společné části: vytvořte server MCP, udělte oprávnění, ověřte server a zadejte jeho údaje do ChatGPT. Tento postup je nutný i v případě, že jste přešli přímo do této části.

Tuto možnost použijte pouze tehdy, pokud je pro váš účet Snowflake dostupná partnerská aplikace ChatGPT a v dialogovém okně nastavení ChatGPT je dostupný vestavěný OAuth.

  1. Požádejte správce Snowflake, aby povolil partnerskou integraci ChatGPT ve stejném účtu Snowflake, který hostuje server MCP. Použijte stávající povolenou partnerskou integraci ChatGPT.

  2. V dialogovém okně nastavení ChatGPT použijte vestavěný OAuth. Nemusíte zadávat ID klienta ani tajný klíč klienta nebo registrovat URL zpětného volání.

  3. Pokračujte níže uvedenou částí Připojte a spravujte Snowflake, kde se přihlásíte, udělíte souhlas a nastavíte přístup. Poté dokončete část Otestujte aplikaci včetně testů s členy, kteří mají povolený přístup a nejsou správci.

I pro tuto možnost platí výše popsaná pravidla pro výchozí roli, seznam povolených rolí a blokované role.

Vlastní klient OAuth

Než budete pokračovat, dokončete výše uvedené společné části: vytvořte server MCP, udělte oprávnění, ověřte server a zadejte jeho údaje do ChatGPT. Tento postup je nutný i v případě, že jste přešli přímo do této části.

Pro vlastního klienta OAuth potřebujete ID klienta a tajný klíč klienta ze Snowflake. I pro tuto možnost platí výše popsaná pravidla pro výchozí roli, seznam povolených rolí a blokované role.

  1. V dialogovém okně nastavení ChatGPT vyberte Pokročilá nastavení OAuth > Uživatelsky definovaný klient OAuth a zkopírujte přesnou hodnotu URL zpětného volání zobrazenou v ChatGPT.

  2. Vytvořte vlastní bezpečnostní integraci OAuth s nastavením OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' a nastavte OAUTH_REDIRECT_URI přesně na tuto URL zpětného volání.

  3. Ve Snowflake spusťte následující příkaz a název integrace zadejte velkými písmeny:

    SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');

  4. Z výsledku ve formátu JSON vložte v ChatGPT hodnotu oauth_client_id do pole ID klienta OAuth a hodnotu oauth_client_secret do pole Tajný klíč klienta OAuth.

  5. Nastavte Metodu ověřování koncového bodu pro tokeny na client_secret_basic.

Po zadání přihlašovacích údajů vlastního klienta pokračujte níže uvedenými částmi Připojte a spravujte Snowflake a Otestujte aplikaci.

Připojení a správa Snowflake

  1. U obou variant OAuth vyberte ve stejném dialogovém okně nastavení ChatGPT možnost Pokračovat, přihlaste se do Snowflake a autorizujte připojení. Pokud má vaše organizace nakonfigurované SSO, můžete ho použít.

  2. Při nastavení pracovního prostoru ověřte, že jsou povolené položky Snowflake i Snowflake – Oficiální šablona. V tarifech Enterprise a Edu nakonfigurujte zásady instalace pluginu a Přístup uživatelů u každé zahrnuté aplikace pro role přiřazené příslušným členům nebo skupinám. V tarifu Business spravujte zásady instalace pluginu a dostupnost aplikací v celém pracovním prostoru.

  3. Správci pracovního prostoru odpovídají za kontrolu nastavení Řízení akcí u zpřístupněných nástrojů.

  4. Správci pracovního prostoru odpovídají za kontrolu nastavení Oprávnění aplikace, kde určí, kdy má ChatGPT před použitím aplikace požádat členy o souhlas.

Tato oprávnění aplikace platí pro konverzace v ChatGPT. Agenti pracovního prostoru používají nastavení, která pro každého agenta určuje jeho tvůrce. Ta určují, které akce aplikace jsou dostupné a kdy mají být koncoví uživatelé požádáni o jejich schválení. Informace o chování agentů najdete v článku Agenti pracovního prostoru ChatGPT pro Enterprise a Business.

Otestujte aplikaci

  1. Otevřete chat, vyberte Snowflake a otestujte připojení.

  2. Ověřte, že ChatGPT najde nástroje, které jste nastavili.

  3. Nejprve spusťte málo rizikovou akci čtení, například vyhledávání nebo dotaz pouze pro čtení nad schválenými daty.

  4. Ověřte, že oprávnění Snowflake brání přístupu nad rámec schválené role a objektů.

  5. Při nastavení pracovního prostoru proveďte testy s členy, kteří mají povolený přístup, nejsou správci a mají různé výchozí role Snowflake. Úspěšné připojení správce nepotvrzuje, že se může připojit každý člen.

Správcům pracovního prostoru nestačí povolit pouze Snowflake. Pokud není Snowflake – oficiální šablona povolená a připojená, může se plugin členům zobrazovat jako zakázaný.

URL serveru MCP a fungování OAuth

ChatGPT se připojuje pomocí úplné URL serveru MCP spravovaného službou Snowflake:

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

ChatGPT používá prefix hostitele Snowflake z této URL k určení následujících koncových bodů OAuth ve Snowflake:

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

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

Nevkládejte URL rozhraní Snowsight, samotnou kořenovou URL účtu Snowflake ani URL s nadbytečnými částmi cesty. URL serveru MCP musí obsahovat /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server} a přesně odpovídat vašim objektům Snowflake.

Řešení problémů

Snowflake je pro správce povolený, ale pro člena zakázaný

  • Ověřte, že jsou v části Konzole správce > Pluginy povolené jak Snowflake, tak Snowflake – oficiální šablona.

  • Otevřete Snowflake – oficiální šablona a dokončete postup Připojit. Samotné povolení šablony bez jejího připojení nestačí.

  • Otevřete Snowflake a ověřte, že se šablona zobrazuje jako aplikace, kterou vyžaduje.

  • Ověřte, že zásady instalace pluginů povolují roli nebo skupinu dotčeného člena.

Server MCP nebyl nalezen

  • Znovu zkontrolujte úplnou URL serveru MCP nebo čtyři pole šablony, pokud je obrazovka nastavení vyžaduje.

  • Ověřte, že server MCP existuje právě v této databázi a schématu.

V ChatGPT se nezobrazují žádné nástroje

  • Ověřte, že specifikace serveru MCP obsahuje nástroje.

  • Ověřte, že role má k serveru MCP oprávnění USAGE.

Nástroj se zobrazuje, ale při použití selže

  • Ověřte, že role má požadované oprávnění k podkladovému objektu Snowflake, například vyhledávací službě, sémantickému pohledu, výpočetnímu clusteru, proceduře nebo UDF.

Nástroj SQL selhává

  • Ověřte, že je název výpočetního clusteru správný a že cluster běží.

  • Ověřte, že role má k výpočetnímu clusteru oprávnění USAGE.

  • Pokud jste zamýšleli přístup pouze pro čtení, ověřte, že je nastaveno read_only: true.

Požadovaná role ALL byla výslovně zablokována

Požádejte správce Snowflake, aby porovnal vaši výchozí roli s povolenými a blokovanými rolemi integrace OAuth. To, že máte jinou povolenou roli, neznamená, že se automaticky vybere. Pokud je to vhodné, změňte výchozí roli na schválenou roli a znovu se připojte. Změna výchozí role ovlivní i vaše relace Snowflake mimo ChatGPT.

Autorizace selhává

  • Ověřte, že se uživatel může přihlásit do Snowflake.

  • Při použití session:role:all ověřte, že integrace OAuth povoluje výchozí roli uživatele.

  • Ověřte, že nastavení používá autorizační postup OAuth pro server MCP spravovaný službou Snowflake.

  • Pokud používáte vlastního klienta OAuth, ověřte, že ID klienta a Tajný klíč klienta odpovídají integraci OAuth ve Snowflake a že její URI přesměrování přesně odpovídá hodnotě URL zpětného volání zobrazené v ChatGPT.

    Pokud používáte vestavěný OAuth, požádejte správce Snowflake, aby zkontroloval, zda je partnerská integrace ChatGPT dostupná a povolená v účtu, který hostuje server MCP.

Síťové zásady nebo seznam povolených IP adres ve Snowflake blokují aplikaci

  • Požádejte správce Snowflake o aktualizaci síťových zásad nebo pravidel přístupu ve Snowflake.

  • Povolte příchozí připojení z aktuálních rozsahů odchozích IP adres aplikací ChatGPT.

  • Tento seznam povolených adres nakonfigurujte ve Snowflake. Je nezávislý na seznamu povolených IP adres pracovního prostoru ChatGPT.

  • Pokud je to možné, automatizujte aktualizace podle zveřejněného souboru JSON, protože se rozsahy mohou měnit.

Problém s připojením kvůli názvu hostitele

Použijte správný prefix hostitele Snowflake. Názvy hostitelů Snowflake s podtržítky mohou způsobovat problémy. Upřednostňujte spojovníky.

Byl tento článek užitečný?