Kuruluşunuz için Snowflake uygulama şablonunu ayarlayan bir ChatGPT çalışma alanı yöneticisiyseniz bu kılavuzu kullanın. Şablon, üyelerin kullandığı nihai uygulama değildir. Gerekli Snowflake yapılandırmasını sağladıktan sonra çalışma alanına özgü bir taslak uygulama oluşturan bir kurulum akışıdır.
Snowflake için kurulumun çoğu Snowflake’te gerçekleşir. Snowflake tarafından yönetilen bir MCP sunucusu oluşturur, doğru role MCP sunucusuna ve onun temel nesnelerine erişim verirsiniz; ardından yönetilen MCP sunucusu URL’sini veya bileşen alanlarını ChatGPT şablon kurulum akışına girersiniz. ChatGPT taslak uygulamayı oluşturduktan sonra, onu yayımlayabilir ve diğer çalışma alanı uygulamaları gibi yönetebilirsiniz.
Ayarladığınız şey
ChatGPT’de çalışma alanına özgü bir Snowflake uygulaması oluşturuyorsunuz. Uygulama, şunları tanımlayan Snowflake tarafından yönetilen bir MCP sunucusuna bağlanır:
ChatGPT’nin kullanabileceği, araçlar olarak adlandırılan eylemler.
Bu araçların hangi Snowflake verilerine veya nesnelerine erişebileceği.
Kullanıcıların hangi Snowflake rolüyle yetkilendirme yapması gerektiği.
Bağlayıcı uç noktasını hangi Snowflake veritabanı, şema ve MCP sunucusu adının tanımladığı.
ChatGPT yalnızca MCP sunucusu tarafından kullanıma sunulan ve kullanıcının yetkilendirme yaptığı Snowflake rolü tarafından izin verilen araçları keşfedip kullanabilir.
Başlamadan önce
Şunlara ihtiyacınız var:
ChatGPT çalışma alanı yöneticisi veya sahibi erişimi.
MCP sunucusu nesneleri oluşturabilen ve izin verebilen Snowflake erişimi.
MCP sunucusunun bulunacağı Snowflake veritabanı ve şema.
ChatGPT’nin ne yapmasına izin verilmesi gerektiğine ilişkin bir karar; örneğin Cortex Search, Cortex Analyst, salt okunur SQL veya belirli bir prosedür ya da işlev.
Kullanıcıların uygulamayı yetkilendirirken kullanacağı en az ayrıcalıklı Snowflake rolü.
Herhangi bir bölge veya bulut soneki dahil Snowflake hesabı ana makine öneki.
Hazırlanacak değerler
Snowflake ana makine öneki: Snowflake hesabı URL’sinde .snowflakecomputing.com’dan önce gelen her şey.
Veritabanı: MCP sunucusunu içeren veritabanı.
Şema: MCP sunucusunu içeren şema.
MCP sunucusu adı: Snowflake MCP sunucusu nesne adı.
ChatGPT kurulum ekranı bir URL isterse tam yönetilen MCP sunucusu URL’si.
Snowflake rolü: kullanıcıların uygulamayı yetkilendirirken kullanması gereken rol.
Araç listesi: ChatGPT’nin kullanmasını istediğiniz Snowflake nesneleri ve eylemleri.
ChatGPT’nin ne yapabileceğine karar verin
Yalnızca açığa çıkarmak istediğiniz özellikleri seçin. Yaygın seçenekler şunları içerir:
Dizine eklenmiş Snowflake verilerinde veya içeriğinde yanıt bulmak için Cortex Search ile arama.
Onaylı bir anlamsal görünüm üzerinden Cortex Analyst ile soru-cevap.
Denetimli sorgu erişimi için salt okunur SQL.
Belirli iş akışları için Snowflake otonom ajanı, saklı yordam veya UDF.
SQL’i etkinleştirirseniz, kuruluşunuz yazma erişimini inceleyip onaylamadığı sürece salt okunur tutun.
Snowflake MCP sunucusunu oluşturma
Snowflake’te, MCP sunucusunu oluşturabilen ve erişim verebilen bir rolle oturum açın. MCP sunucusunun oluşturulması gereken veritabanı ve şemada bir çalışma sayfası açın.
Yalnızca ChatGPT’nin kullanması gereken araçları listeleyen bir MCP sunucusu oluşturun. Nesne adlarını kendi Snowflake veritabanınız, şemanız, hizmetleriniz, görünümleriniz, deponuz ve sunucu adınızla değiştirin.
Örnek:
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" $$;
ChatGPT’nin doğru aracı seçebilmesi için araç adları tutarlı ve açıklayıcı olmalıdır. MCP sunucusunu oluşturmak, temel Snowflake nesnelerine otomatik olarak erişim vermez.
Doğru Snowflake izinlerini verin
Kullanıcıların yetkilendirme yapacağı Snowflake rolünü seçin; ardından bu role veritabanına, şemaya, MCP sunucusuna ve araçların kullandığı tüm temel nesnelere erişim verin.
Örnek:
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;
MCP sunucusu anlamsal bir görünümü, UDF’yi, saklı yordamı veya Cortex Agent’ı kullanıma sunuyorsa bu nesneler için gereken izinleri de verin.
Snowflake’in hazır olduğunu doğrulayın
Çalıştırın:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Ardından çalıştırın:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Şunları doğrulayın:
Sunucu beklenen veritabanı ve şemada mevcut.
Araç listesi amaçladığınız gibi.
Her araç tanımlayıcısı doğru Snowflake nesnesini işaret ediyor.
Bağlanan rolün MCP sunucusunda USAGE izni var.
Bağlanan rolün her temel nesnede gerekli izinleri var.
ChatGPT’de şablon kurulumunu başlatma
ChatGPT’de, uygulamanın kullanılabilir olması gereken çalışma alanına geçin.
Çalışma alanı ayarları > Uygulamalar’ı açın.
Dizin’i seçin.
Snowflake’i arayın.
Snowflake uygulama şablonunu seçin ve kurulumu başlatın.
Snowflake veya Snowflake - Analitik gibi anlaşılır bir uygulama adı ve açıklaması girin.
Kurulum akışı tarafından istenen yönetilen MCP sunucusu ayrıntılarını girin.
Kurulum ekranı tam yönetilen MCP sunucusu URL’sini isterse şu biçimi kullanın:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Kurulum ekranı ayrı alanlar isterse, bu URL’deki aynı değerleri kullanın:
Snowflake ana makine öneki.
Veritabanı.
Şema.
MCP sunucusu adı.
Taslak uygulamayı oluşturma ve yayımlama
ChatGPT’de Snowflake şablon kurulumunu kaydedin.
Taslak uygulamayı oluşturun.
Taslak uygulama ayrıntılarını, kimlik doğrulama ayarlarını ve kullanılabilir eylemleri inceleyin.
Hazır olduğunda taslak uygulamayı yayımlayın.
Uygulamanın Çalışma alanı ayarları > Uygulamalar > Etkin bölümünde göründüğünü doğrulayın.
Bunu kullanması gereken roller için Kullanıcı erişimi’ni yapılandırın.
Kullanıma sunulan araçlar için Eylem denetimi’ni inceleyin.
ChatGPT’nin uygulamayı kullanmadan önce üyelere ne zaman soracağını seçmek için Uygulama izinleri’ni inceleyin.
Bu uygulama izinleri ChatGPT konuşmaları için geçerlidir. Çalışma Alanı Otonom Ajanları, hangi uygulama eylemlerinin kullanılabilir olduğunu ve son kullanıcılardan ne zaman onay isteneceğini belirlemek için otonom ajanın oluşturucusu tarafından ayarlanan otonom ajan bazlı denetimleri kullanır. Otonom ajan davranışı için bkz.: Enterprise ve Business için ChatGPT Çalışma Alanı Otonom Ajanları.
Uygulamayı test etme
İzin verilen bir test kullanıcısı olarak ChatGPT’den bağlantı akışını başlatın.
Snowflake’te oturum açın ve istenirse amaçlanan rolü seçin.
ChatGPT’nin MCP sunucusundan beklenen araçları keşfettiğini doğrulayın.
Önce, onaylı verilere karşı arama veya salt okunur sorgu gibi düşük riskli bir okuma eylemi çalıştırın.
Snowflake izinlerinin onaylı rol ve nesnelerin dışındaki erişimi engellediğini doğrulayın.
MCP sunucusu URL’si ve OAuth davranışı
ChatGPT, tam Snowflake tarafından yönetilen MCP sunucusu URL’sine bağlanır. ChatGPT, Snowflake OAuth uç noktalarını çözümlemek için bu URL’deki Snowflake ana makine önekini kullanır.
Snowsight URL’si, tek başına Snowflake hesabı kök URL’si veya ek yol segmentleri içeren herhangi bir URL yapıştırmayın. MCP URL’si veritabanı, şema ve MCP sunucusu yolunu içermeli ve Snowflake nesnelerinizle tam olarak eşleşmelidir.
Sorun giderme
MCP sunucusu bulunamadı: tam MCP sunucusu URL’sini veya ayrı ana makine öneki, veritabanı, şema ve sunucu alanlarını yeniden kontrol edin.
ChatGPT’de araç görünmüyor: MCP sunucusu belirtiminin araçlar içerdiğini ve rolün MCP sunucusunda USAGE iznine sahip olduğunu doğrulayın.
Bir araç görünüyor ancak kullanıldığında başarısız oluyor: rolün temel Snowflake nesnesinde doğru izne sahip olduğunu doğrulayın.
SQL aracı başarısız oluyor: depo adının doğru olduğunu, deponun kullanılabilir olduğunu, rolün üzerinde USAGE iznine sahip olduğunu ve salt okunur erişim amaçladıysanız read_only değerinin true olduğunu doğrulayın.
Yetkilendirme başarısız oluyor: kullanıcının Snowflake’te oturum açabildiğini ve amaçlanan rolü kullanabildiğini doğrulayın.
Ana makine adı bağlantı sorunu: doğru Snowflake ana makine önekini kullanın. Alt çizgi içeren Snowflake ana makine adları sorunlara neden olabilir; tireleri tercih edin.