Brug denne vejledning, hvis du er administrator af et ChatGPT-arbejdsområde og konfigurerer Snowflake-appskabelonen til din organisation. En skabelon er ikke den endelige app, som medlemmerne bruger. Det er et konfigurationsflow, der opretter en arbejdsområdespecifik kladdeapp, når du har angivet den nødvendige Snowflake-konfiguration.
For Snowflake foregår det meste af konfigurationen i Snowflake. Du opretter en Snowflake-administreret MCP-server, giver den rette rolle adgang til MCP-serveren og dens underliggende objekter og angiver derefter den administrerede MCP-server-URL eller dens komponentfelter i ChatGPT-skabelonens konfigurationsflow. Når ChatGPT har oprettet kladdeappen, kan du udgive den og administrere den som andre apps i arbejdsområdet.
Det konfigurerer du
Du opretter en arbejdsområdespecifik Snowflake-app i ChatGPT. Appen opretter forbindelse til en Snowflake-administreret MCP-server, der definerer:
Hvilke handlinger ChatGPT kan bruge, kaldet værktøjer.
Hvilke Snowflake-data eller -objekter disse værktøjer kan få adgang til.
Hvilken Snowflake-rolle brugere skal godkende med.
Hvilken Snowflake-database, hvilket skema og hvilket MCP-servernavn der identificerer connector-endepunktet.
ChatGPT kan kun finde og bruge de værktøjer, der eksponeres af MCP-serveren og tillades af den Snowflake-rolle, som brugeren godkender med.
Før du går i gang
Du skal bruge:
Administrator- eller ejeradgang til ChatGPT-arbejdsområdet.
Snowflake-adgang, der kan oprette MCP-serverobjekter og tildele tilladelser.
Den Snowflake-database og det skema, hvor MCP-serveren skal være.
En beslutning om, hvad ChatGPT skal have lov til at gøre, f.eks. Cortex Search, Cortex Analyst, skrivebeskyttet SQL eller en bestemt procedure eller funktion.
En Snowflake-rolle med mindst mulige rettigheder, som brugere skal bruge, når de godkender appen.
Snowflake-kontoens værtspræfiks, inklusive eventuelt regions- eller cloud-suffiks.
Værdier, der skal klargøres
Snowflake-værtspræfiks: alt før .snowflakecomputing.com i Snowflake-kontoens URL.
Database: databasen, der indeholder MCP-serveren.
Skema: skemaet, der indeholder MCP-serveren.
MCP-servernavn: objektnavnet på Snowflake MCP-serveren.
Fuld administreret MCP-server-URL, hvis ChatGPT-konfigurationsskærmen beder om en URL.
Snowflake-rolle: den rolle, brugere skal bruge, når de godkender appen.
Værktøjsliste: de Snowflake-objekter og handlinger, du vil have ChatGPT til at bruge.
Beslut, hvad ChatGPT kan gøre
Vælg kun de funktioner, du vil eksponere. Almindelige muligheder omfatter:
Søg med Cortex Search for at finde svar i indekserede Snowflake-data eller -indhold.
Spørgsmål og svar med Cortex Analyst via en godkendt semantisk visning.
Skrivebeskyttet SQL til kontrolleret forespørgselsadgang.
En Snowflake-agent, gemt procedure eller UDF til specifikke workflows.
Hvis du aktiverer SQL, skal du holde det skrivebeskyttet, medmindre din organisation har gennemgået og godkendt skriveadgang.
Opret Snowflake MCP-serveren
Log ind i Snowflake med en rolle, der kan oprette MCP-serveren og give adgang. Åbn et worksheet i den database og det skema, hvor MCP-serveren skal oprettes.
Opret en MCP-server, der kun angiver de værktøjer, ChatGPT skal bruge. Erstat objektnavne med dine egne Snowflake-database-, skema-, tjeneste-, visnings-, warehouse- og servernavne.
Eksempel:
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" $$;
Værktøjsnavne skal være stabile og beskrivende, så ChatGPT kan vælge det rigtige værktøj. Oprettelse af MCP-serveren giver ikke automatisk adgang til de underliggende Snowflake-objekter.
Tildel de rette Snowflake-tilladelser
Vælg den Snowflake-rolle, brugere skal godkende med, og giv derefter rollen adgang til databasen, skemaet, MCP-serveren og alle underliggende objekter, som værktøjerne bruger.
Eksempel:
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;
Hvis MCP-serveren eksponerer en semantisk visning, UDF, gemt procedure eller Cortex Agent, skal du også tildele de nødvendige tilladelser til disse objekter.
Bekræft, at Snowflake er klar
Kør:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Kør derefter:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Bekræft:
Serveren findes i den forventede database og det forventede skema.
Værktøjslisten er som tiltænkt.
Hver værktøjsidentifikator peger på det rigtige Snowflake-objekt.
Den forbindende rolle har USAGE på MCP-serveren.
Den forbindende rolle har de nødvendige tilladelser til hvert underliggende objekt.
Start skabelonkonfigurationen i ChatGPT
Skift i ChatGPT til det arbejdsområde, hvor appen skal være tilgængelig.
Åbn Arbejdsområdeindstillinger > Apps.
Vælg Katalog.
Søg efter Snowflake.
Vælg Snowflake-appskabelonen, og start konfigurationen.
Angiv et tydeligt appnavn og en tydelig beskrivelse, f.eks. Snowflake eller Snowflake - Analytics.
Angiv de oplysninger om den administrerede MCP-server, som konfigurationsflowet anmoder om.
Hvis konfigurationsskærmen beder om den fulde administrerede MCP-server-URL, skal du bruge dette format:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Hvis konfigurationsskærmen beder om separate felter, skal du bruge de samme værdier fra denne URL:
Snowflake-værtspræfiks.
Database.
Skema.
MCP-servernavn.
Opret og udgiv kladdeappen
Gem Snowflake-skabelonkonfigurationen i ChatGPT.
Opret kladdeappen.
Gennemgå kladdeappens oplysninger, godkendelsesindstillinger og tilgængelige handlinger.
Udgiv kladdeappen, når den er klar.
Bekræft, at appen vises under Arbejdsområdeindstillinger > Apps > Aktiveret.
Konfigurer Brugeradgang for de roller, der skal bruge den.
Gennemgå Handlingskontrol for de eksponerede værktøjer.
Gennemgå Apptilladelser for at vælge, hvornår ChatGPT spørger medlemmer, før appen bruges.
Disse apptilladelser gælder for ChatGPT-samtaler. Arbejdsområde-agenter bruger kontrolelementer pr. agent, som angives af agentens opretter, til at afgøre, hvilke apphandlinger der er tilgængelige, og hvornår slutbrugere bliver bedt om at godkende dem. For agentadfærd, se: ChatGPT-arbejdsområde-agenter til Enterprise og Business.
Test appen
Start forbindelsesflowet fra ChatGPT som en tilladt testbruger.
Log ind på Snowflake, og vælg den tilsigtede rolle, hvis du bliver bedt om det.
Bekræft, at ChatGPT finder de forventede værktøjer fra MCP-serveren.
Kør først en læsehandling med lav risiko, f.eks. en søgning eller skrivebeskyttet forespørgsel mod godkendte data.
Bekræft, at Snowflake-tilladelser forhindrer adgang uden for den godkendte rolle og de godkendte objekter.
MCP-server-URL og OAuth-adfærd
ChatGPT opretter forbindelse til den fulde Snowflake-administrerede MCP-server-URL. ChatGPT bruger Snowflake-værtspræfikset fra denne URL til at finde Snowflake OAuth-endepunkter.
Indsæt ikke en Snowsight-URL, Snowflake-kontoens rod-URL alene eller en URL med ekstra stisegmenter. MCP-URL’en skal inkludere databasen, skemaet og MCP-serverstien og skal matche dine Snowflake-objekter nøjagtigt.
Fejlfinding
MCP-server ikke fundet: Kontrollér den fulde MCP-server-URL eller de separate felter for værtspræfiks, database, skema og server igen.
Der vises ingen værktøjer i ChatGPT: Bekræft, at MCP-serverspecifikationen indeholder værktøjer, og at rollen har USAGE på MCP-serveren.
Et værktøj vises, men fejler ved brug: Bekræft, at rollen har den rette tilladelse til det underliggende Snowflake-objekt.
SQL-værktøjet fejler: Bekræft, at warehouse-navnet er korrekt, at warehouse er tilgængeligt, at rollen har USAGE på det, og at read_only er true, hvis du havde til hensigt at give skrivebeskyttet adgang.
Godkendelse fejler: Bekræft, at brugeren kan logge ind på Snowflake og bruge den tilsigtede rolle.
Problem med værtsnavnforbindelse: Brug det korrekte Snowflake-værtspræfiks. Snowflake-værtsnavne med understregninger kan give problemer; brug helst bindestreger.