ChatGPT’de Snowflake uygulama şablonunu ayarlama

ChatGPT çalışma alanı yöneticilerinin ve ChatGPT Plus veya Pro kullanıcılarının ChatGPT'yi Snowflake tarafından yönetilen bir MCP sunucusuna nasıl bağlayacağını öğrenin.

ChatGPT’yi Snowflake tarafından yönetilen bir MCP sunucusu üzerinden Snowflake’e bağlamak isteyen bir ChatGPT çalışma alanı yöneticisi veya ChatGPT Plus ya da Pro kullanıcısıysanız bu kılavuzu kullanın.

Kurulumun büyük bölümü Snowflake’te yapılır. Snowflake hazır olduğunda ChatGPT’de Snowflake şablonunun bağlantısını tamamlayın, ardından bu şablonu kullanan Snowflake eklentisini etkinleştirin.

Yerleşik OAuth: Snowflake hesabınızda ve ChatGPT’de kullanılabiliyorsa bir Snowflake yöneticisinin etkinleştirdiği ChatGPT iş ortağı uygulamasını kullanın. Yapılandırılmışsa kuruluşunuzun SSO (çoklu oturum açma) özelliğini kullanarak Snowflake’te oturum açın. ChatGPT’de istemci kimliği veya istemci gizli anahtarı girmeniz gerekmez. Aşağıdaki Yerleşik OAuth bölümünü izleyin.
Özel OAuth istemcisi: Kuruluşunuz kendi OAuth istemcisini gerektiriyorsa veya yerleşik OAuth kullanılamıyorsa bu yöntemi kullanın. Aşağıdaki Özel OAuth istemcisi bölümünü izleyin.

Her iki OAuth yöntemi de aşağıda açıklanan ortak MCP sunucusu kurulumunu, temel nesnelere yönelik izinleri ve ağ erişimini gerektirir. OAuth’u yapılandırmadan önce, Snowflake sunucusu bilgilerini ChatGPT’ye girin bölümü dahil olmak üzere ortak kurulum adımlarını tamamlayın.

Neyi kuruyorsunuz?

ChatGPT için MCP uç noktası görevi gören, Snowflake tarafından yönetilen bir MCP sunucusu oluşturuyorsunuz. MCP sunucusu şunları tanımlar:

ChatGPT’nin hangi eylemleri kullanabileceği.
Bu araçların hangi Snowflake verilerine veya nesnelerine erişebileceği.
Her kullanıcının hangi Snowflake rolüyle yetkilendirme yapacağı.
Uç noktanın hangi Snowflake veritabanı, şema ve MCP sunucusu adıyla tanımlandığı.

Ardından ChatGPT’de Snowflake - Resmî Şablon seçeneğini, yönetilen MCP sunucusunun tam URL’siyle yapılandırırsınız. Şablon kurulum ekranında URL dört ayrı alan olarak gösterilebilir:

Snowflake ana makine öneki.
Veritabanı.
Şema.
MCP sunucusu adı.

ChatGPT yalnızca MCP sunucusunun kullanıma sunduğu ve kullanıcının yetkilendirme yaptığı Snowflake rolünün izin verdiği araçları keşfedip kullanabilir.

Başlamadan önce

Gerekenler:

ChatGPT çalışma alanı yöneticisi veya sahibi yetkisi ya da ChatGPT Plus veya Pro erişimi.
MCP sunucusu nesneleri oluşturma ve izin verme yetkisine sahip Snowflake erişimi.
MCP sunucusunun yer alacağı Snowflake veritabanı ve şeması.
ChatGPT’nin neleri kullanmasına izin verileceğine dair bir karar: örneğin Cortex Search, Cortex Analyst, salt okunur SQL ya da belirli bir prosedür veya işlev.
Kullanıcıların uygulamayı yetkilendirirken kullanacağı, yalnızca gerekli asgari yetkilere sahip bir Snowflake rolü.
Varsa bölge veya bulut son eki dahil, Snowflake hesabının ana makine öneki.

Snowflake hesabınız bir ağ politikası veya IP izin listesi aracılığıyla erişimi kısıtlıyorsa bir Snowflake yöneticisinden güncel ChatGPT uygulaması çıkış IP aralıklarından gelen bağlantılara izin vermesini isteyin. Liste değişken olduğundan güncel tutulmalıdır.

Hazırlanacak değerler

Snowflake ana makine ön eki: Snowflake hesabı URL’sinde .snowflakecomputing.com öncesindeki kısmın tamamı.
Veritabanı: MCP sunucusunu içeren veritabanı.
Şema: MCP sunucusunu içeren şema.
MCP sunucusu adı: Snowflake MCP sunucusu nesnesinin adı.
ChatGPT kurulum ekranında URL isteniyorsa yönetilen MCP sunucusunun tam URL’si.
Snowflake rolü: Kullanıcıların uygulamaya yetki verirken kullanması gereken rol.
Araç listesi: ChatGPT’nin kullanmasını istediğiniz Snowflake nesneleri ve eylemleri.

ChatGPT’nin neler yapabileceğine karar verin

Yalnızca kullanıma sunmak istediğiniz özellikleri seçin. Yaygın seçenekler şunlardır:

Dizine eklenmiş Snowflake verileri veya içerikleri içinde yanıt bulmak için Cortex Search ile arama.
Onaylanmış bir anlamsal görünüm üzerinden Cortex Analyst ile soru-cevap.
Kontrollü sorgu erişimi için salt okunur SQL.
Belirli bir iş akışı için Snowflake ajanı, saklı yordam veya UDF.

SQL’i etkinleştirirseniz kuruluşunuz yazma erişimini inceleyip onaylamadıkça salt okunur olarak tutun.

Bir Snowflake çalışma sayfası açın

Snowflake uygulamasında oturum açın.
MCP sunucusu oluşturabilen ve erişim izni verebilen bir role geçin.
Çalışma alanları bölümüne gidin.
SQL dosyası içeren bir çalışma alanı oluşturun.
Çalışma alanı bağlamını, MCP sunucusunun oluşturulacağı veritabanı ve şema olarak ayarlayın.

Snowflake MCP sunucusunu oluşturun

Snowflake’te MCP sunucusu oluşturabilen ve erişim izni verebilen bir rolle oturum açın. MCP sunucusunun oluşturulacağı veritabanında ve şemada bir çalışma sayfası açın.

Aşağıdaki örneğe benzer bir komut çalıştırın. Adları kendi Snowflake veritabanınızın, şemanızın, hizmetlerinizin, görünümlerinizin, ambarınızın ve sunucunuzun adlarıyla değiştirin.

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.

Bu komuttaki araç adları ve Snowflake nesneleri örnek olarak verilmiştir:

support-search, belirtilen Cortex Search hizmetini kullanıma sunar.
revenue-analyst, belirtilen anlamsal görünümü kullanıma sunar. Gerektiğinde diğer görünümler için araçlar ekleyin.
sql-readonly, belirtilen ambarla salt okunur SQL’i kullanıma sunar.

ChatGPT’nin doğru aracı seçebilmesi için sabit ve açıklayıcı araç adları kullanın. MCP sunucusunu oluşturmak, sunucunun kullandığı Snowflake nesnelerine otomatik olarak erişim izni vermez.

Ek tanımlama seçenekleri için bkz. Snowflake tarafından yönetilen bir MCP sunucusu oluşturma.

Doğru Snowflake izinlerini verin

Kullanıcıların yetki verirken kullanacağı Snowflake rolünü seçin, ardından bu role şunlara erişim izni verin:

Veritabanı ve şema.
MCP sunucusu.
Arama hizmeti, anlamsal görünüm veya ambar gibi araçların kullandığı tüm temel nesneler.

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

MCP sunucusu bir UDF, saklı yordam veya Cortex ajanı kullanıma sunuyorsa o nesne için de gerekli izinleri verin.

Snowflake’in hazır olduğunu doğrulayın

Şunu çalıştırın:

SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;

Ardından şunu çalıştırın:

DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;

Şunları doğrulayın:

Sunucu, beklenen veritabanında ve şemada bulunuyor.
Araç listesi istediğiniz gibi.
Her aracın identifier değeri doğru Snowflake nesnesini gösteriyor.
Bağlantı için kullanılan rolün MCP sunucusu üzerinde USAGE izni var.
Bağlantı için kullanılan rolün, araçların kullandığı her nesne üzerinde gerekli izinleri var.

Snowflake sunucusu bilgilerini ChatGPT’ye girin

Çalışma alanı kurulumu için admin.openai.com adresini açın, ilgili ChatGPT çalışma alanını seçin ve Eklentiler’i açın. Çalışma alanında gezinme ve eski uygulamalara erişim hakkında bilgi için bkz. Eklentiler ve uygulamalar için yönetici kontrolleri, güvenlik ve uyumluluk.

ChatGPT’de uygulamanın kullanılabileceği hesaba veya çalışma alanına geçin.
Kişisel kurulum için Ayarlar > Eklentiler bölümüne, çalışma alanı kurulumu için ise çalışma alanı yöneticisi olarak Yönetici Konsolu > Eklentiler bölümüne gidin.
Snowflake’i arayın.
Snowflake - Resmî Şablon’u etkinleştirin.
Snowflake - Resmî Şablon’u açın, anlaşılır bir bağlantı adı girin ve Bağlan’ı seçin.
Yönetilen MCP sunucusunun tam URL’sini girin:

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

Örnek:

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.

Kurulum ekranında Snowflake yapılandırması ayrı alanlar olarak gösteriliyorsa URL’deki aynı değerleri kullanın:

Snowflake ana makine ön eki

Snowflake hesabınızın URL’sinde .snowflakecomputing.com öncesindeki kısmın tamamını, varsa bölge veya bulut son eki dahil kullanın.

Örneğin, hesap URL’si şöyle başlıyorsa:

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

Ana makine ön eki şudur:

myorg-myaccount.azure

Veritabanı

MCP sunucusunu içeren veritabanını girin. Örneğin:

CHATGPT_APPS

Şema

MCP sunucusunu içeren şemayı girin. Örneğin:

TOOLS

MCP sunucusu adı

Snowflake MCP sunucusu nesnesinin adını girin. Örneğin:

CHATGPT_SNOWFLAKE_MCP

OAuth’u yapılandırın

Hesabınızda kullanılabilen ve kuruluşunuzun gereksinimlerini karşılayan OAuth yöntemini seçin. Her iki yöntem de yukarıdaki ortak MCP sunucusu kurulumunu ve aşağıdaki bağlantı testleri ile erişim kontrollerini kullanır.

Her iki OAuth yönteminde de session:role:all kullandığınızda Snowflake her kullanıcının varsayılan rolünü kullanır. Varsayılan rol, yapılandırılmışsa OAuth entegrasyonunun rol izin listesinde yer almalı ve engellenmiş olmamalıdır. Onaylanmış başka bir role sahip olmanız, o rolün otomatik olarak seçilmesini sağlamaz.

Yerleşik OAuth

Devam etmeden önce yukarıdaki ortak bölümleri tamamlayarak MCP sunucusunu oluşturun, izinleri verin, sunucuyu doğrulayın ve bilgilerini ChatGPT’ye girin. Doğrudan bu bölüme gelmiş olsanız bile bu adımlar gereklidir.

Bu yöntemi yalnızca ChatGPT iş ortağı uygulaması Snowflake hesabınızda ve yerleşik OAuth ChatGPT kurulum penceresinde kullanılabiliyorsa kullanın.

Bir Snowflake yöneticisinden ChatGPT iş ortağı entegrasyonunu MCP sunucusunu barındıran Snowflake hesabında etkinleştirmesini isteyin. Mevcut ve etkin bir ChatGPT iş ortağı entegrasyonunu yeniden kullanın.
ChatGPT kurulum penceresinde yerleşik OAuth’u kullanın. İstemci kimliği veya istemci gizli anahtarı girmeniz ya da geri çağırma URL’si kaydetmeniz gerekmez.
Oturum açmak, onay vermek ve erişimi yapılandırmak için aşağıdaki Snowflake’i bağlayın ve yönetin bölümüyle devam edin. Ardından erişim izni olan ve yönetici olmayan üyelerle yapılacak testler dahil, Uygulamayı test edin bölümünü tamamlayın.

Yukarıda açıklanan varsayılan rol, izin listesi ve engellenen rollerle ilgili davranışlar bu yöntem için de geçerlidir.

Özel OAuth istemcisi

Özel bir OAuth istemcisi için Snowflake’ten bir istemci kimliği ve istemci gizli anahtarı almanız gerekir. Yukarıda açıklanan varsayılan rol, izin listesi ve engellenen rollerle ilgili davranışlar bu yöntem için de geçerlidir.

ChatGPT kurulum penceresinde Gelişmiş OAuth ayarları > Kullanıcı Tanımlı OAuth İstemcisi seçeneğini seçin ve ChatGPT’de gösterilen Geri Çağırma URL’si değerini aynen kopyalayın.
OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' ayarını kullanarak ve OAUTH_REDIRECT_URI değerini bu geri çağırma URL’siyle birebir aynı olacak şekilde ayarlayarak özel bir OAuth güvenlik entegrasyonu oluşturun.
Entegrasyon adını büyük harflerle yazarak Snowflake’te şu komutu çalıştırın:
SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');
JSON sonucundaki oauth_client_id değerini ChatGPT’deki OAuth istemci kimliği alanına, oauth_client_secret değerini ise OAuth istemci gizli anahtarı alanına yapıştırın.
Belirteç uç noktası kimlik doğrulama yöntemi ayarını client_secret_basic olarak belirleyin.

Özel istemcinin kimlik bilgilerini girdikten sonra aşağıdaki Snowflake’i bağlayın ve yönetin ve Uygulamayı test edin bölümleriyle devam edin.

Snowflake’i bağlama ve yönetme

Her iki OAuth yöntemi için de aynı ChatGPT kurulum penceresinde Devam et’i seçin, Snowflake’te oturum açın ve bağlantıyı yetkilendirin. Yapılandırılmışsa kuruluşunuzun SSO (çoklu oturum açma) özelliğini kullanabilirsiniz.
Çalışma alanı kurulumu için hem Snowflake hem de Snowflake - Resmî Şablon seçeneğinin etkin olduğunu doğrulayın. Enterprise ve Edu’da eklentinin yükleme politikasını ve eklentiye dahil her uygulamanın Kullanıcı erişimi ayarını, hedeflenen üyelere veya gruplara atanan roller için yapılandırın. Business’ta eklenti yükleme politikasını ve uygulamaların kullanılabilirliğini çalışma alanı genelinde yönetin.
Çalışma alanı yöneticileri, kullanıma sunulan araçlar için Eylem kontrolü ayarlarını gözden geçirmekten sorumludur.
Çalışma alanı yöneticileri, ChatGPT’nin uygulamayı kullanmadan önce hangi durumlarda üyelere soracağını belirlemek için Uygulama izinleri ayarlarını gözden geçirmekten sorumludur.

Bu uygulama izinleri ChatGPT sohbetleri için geçerlidir. Çalışma alanı ajanları, hangi uygulama eylemlerinin kullanılabileceğini ve son kullanıcılardan ne zaman onay isteneceğini belirlemek için ajanı oluşturan kişinin her ajan için ayrı ayrı belirlediği kontrolleri kullanır. Ajan davranışı hakkında bilgi için Enterprise ve Business için ChatGPT çalışma alanı ajanları başlıklı makaleye bakın.

Uygulamayı test edin

Bir sohbet açın, Snowflake’i seçin ve bağlantıyı test edin.
ChatGPT’nin yapılandırdığınız araçları keşfettiğini doğrulayın.
Önce onaylanmış veriler üzerinde arama veya salt okunur sorgu gibi düşük riskli bir okuma eylemi çalıştırın.
Snowflake izinlerinin, onaylanmış rol ve nesnelerin dışına erişimi engellediğini doğrulayın.
Çalışma alanı kurulumu için farklı varsayılan Snowflake rollerine sahip, erişim izni olan ve yönetici olmayan üyelerle test yapın. Bir yöneticinin başarıyla bağlanması, her üyenin bağlanabileceğini doğrulamaz.

Çalışma alanı yöneticilerinin yalnızca Snowflake’i etkinleştirmesi yeterli değildir. Snowflake - Resmî Şablon etkinleştirilip bağlanmadıysa eklenti üyelere devre dışı görünebilir.

MCP sunucusu URL’si ve OAuth davranışı

ChatGPT, Snowflake tarafından yönetilen MCP sunucusunun tam URL’sine bağlanır:

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

ChatGPT, aşağıdaki Snowflake OAuth uç noktalarını belirlemek için bu URL’deki Snowflake ana makine ön ekini kullanır:

Yetkilendirme: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/authorize
Belirteç: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/token-request

Snowsight URL’si, tek başına Snowflake hesabının kök URL’si veya fazladan yol bölümleri içeren bir URL yapıştırmayın. MCP URL’si /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server} yolunu içermeli ve Snowflake nesnelerinizle birebir eşleşmelidir.

Sorun giderme

Snowflake yönetici için etkin, ancak üye için devre dışı

Yönetici Konsolu > Eklentiler bölümünde hem Snowflake hem de Snowflake - Resmî Şablon’un etkin olduğunu doğrulayın.
Snowflake - Resmî Şablon’u açın ve Bağlan akışını tamamlayın. Şablonu bağlamadan etkinleştirmek yeterli değildir.
Snowflake’i açın ve şablonun gerekli uygulama olarak göründüğünü doğrulayın.
Eklenti yükleme ilkesinin, sorunu yaşayan üyenin rolüne veya grubuna izin verdiğini doğrulayın.

MCP sunucusu bulunamadı

MCP sunucusunun tam URL’sini veya kurulum ekranında isteniyorsa dört şablon alanını yeniden kontrol edin.
MCP sunucusunun tam olarak belirtilen veritabanında ve şemada bulunduğunu doğrulayın.

ChatGPT’de hiçbir araç görünmüyor

MCP sunucusu tanımının araçlar içerdiğini doğrulayın.
Rolün MCP sunucusu üzerinde USAGE izni olduğunu doğrulayın.

Araç görünüyor ancak kullanıldığında başarısız oluyor

Rolün, aracın kullandığı Snowflake nesnesi üzerinde gerekli izne sahip olduğunu doğrulayın. Bu nesne bir arama hizmeti, anlamsal görünüm, ambar, yordam veya UDF olabilir.

SQL aracı başarısız oluyor

Ambar adının doğru olduğunu ve ambarın çalıştığını doğrulayın.
Rolün ambar üzerinde USAGE izni olduğunu doğrulayın.
Salt okunur erişim amaçlıyorsanız read_only: true ayarının yapıldığını doğrulayın.

İstenen ALL rolü açıkça engellenmiş

Snowflake yöneticinizden varsayılan rolünüzü OAuth entegrasyonunun izin verilen ve engellenen rolleriyle karşılaştırmasını isteyin. İzin verilen başka bir role sahip olmanız, o rolün otomatik olarak seçilmesini sağlamaz. Uygunsa varsayılan rolünüzü onaylanmış bir rolle değiştirin ve yeniden bağlanın. Varsayılan rolünüzü değiştirmek, ChatGPT dışındaki Snowflake oturumlarınızı da etkiler.

Yetkilendirme başarısız oluyor

Kullanıcının Snowflake’te oturum açabildiğini doğrulayın.
session:role:all kullanırken OAuth entegrasyonunun kullanıcının varsayılan rolüne izin verdiğini doğrulayın.
Kurulumda Snowflake tarafından yönetilen MCP OAuth akışının kullanıldığını doğrulayın.
Özel bir OAuth istemcisi kullanıyorsanız İstemci Kimliği ve İstemci Gizli Anahtarı değerlerinin Snowflake OAuth entegrasyonuyla eşleştiğini ve entegrasyonun yönlendirme URI’sinin ChatGPT’de gösterilen Geri Çağırma URL’si ile birebir aynı olduğunu doğrulayın.
Yerleşik OAuth kullanıyorsanız bir Snowflake yöneticisinden, ChatGPT iş ortağı entegrasyonunun MCP sunucusunu barındıran hesapta kullanılabilir ve etkin olduğunu kontrol etmesini isteyin.

Snowflake ağ politikası veya IP izin listesi uygulamayı engelliyor

Bir Snowflake yöneticisinden Snowflake ağ politikasını veya erişim kurallarını güncellemesini isteyin.
Güncel ChatGPT uygulaması çıkış IP aralıklarından gelen bağlantılara izin verin.
Bu izin listesini Snowflake’te yapılandırın. Bu liste, ChatGPT çalışma alanının IP izin listesinden ayrıdır.
Aralıklar değişebileceğinden, mümkünse yayımlanan JSON’u kullanarak güncellemeleri otomatikleştirin.

Ana makine adıyla bağlantı sorunu

Doğru Snowflake ana makine ön ekini kullanın. Alt çizgi içeren Snowflake ana makine adları sorunlara yol açabilir; kısa çizgi kullanmayı tercih edin.