Gunakan panduan ini jika Anda adalah admin workspace ChatGPT yang menyiapkan templat aplikasi Snowflake untuk organisasi Anda. Templat bukan aplikasi akhir yang digunakan anggota. Ini adalah alur penyiapan yang membuat draf aplikasi khusus workspace setelah Anda memberikan konfigurasi Snowflake yang diperlukan.
Untuk Snowflake, sebagian besar penyiapan terjadi di Snowflake. Anda membuat server MCP yang dikelola Snowflake, memberi akses peran yang tepat ke server MCP dan objek dasarnya, lalu memasukkan URL server MCP terkelola atau bidang komponennya dalam alur penyiapan templat ChatGPT. Setelah ChatGPT membuat draf aplikasi, Anda dapat memublikasikan dan mengelolanya seperti aplikasi workspace lainnya.
Yang Anda siapkan
Anda membuat aplikasi Snowflake khusus workspace di ChatGPT. Aplikasi terhubung ke server MCP yang dikelola Snowflake yang menentukan:
Tindakan yang dapat digunakan ChatGPT, yang disebut alat.
Data atau objek Snowflake yang dapat diakses alat tersebut.
Peran Snowflake yang harus digunakan pengguna saat memberi otorisasi.
Database, skema, dan nama server MCP Snowflake yang mengidentifikasi endpoint konektor.
ChatGPT hanya dapat menemukan dan menggunakan alat yang diekspos oleh server MCP dan diizinkan oleh peran Snowflake yang digunakan pengguna untuk memberi otorisasi.
Sebelum memulai
Anda memerlukan:
Akses admin atau pemilik workspace ChatGPT.
Akses Snowflake yang dapat membuat objek server MCP dan memberikan izin.
Database dan skema Snowflake tempat server MCP akan berada.
Keputusan tentang apa yang boleh dilakukan ChatGPT, seperti Cortex Search, Cortex Analyst, SQL baca-saja, atau prosedur atau fungsi tertentu.
Peran Snowflake dengan hak istimewa minimum yang akan digunakan pengguna saat memberi otorisasi aplikasi.
Prefiks host akun Snowflake, termasuk akhiran wilayah atau cloud apa pun.
Nilai yang perlu disiapkan
Prefiks host Snowflake: semua yang berada sebelum .snowflakecomputing.com dalam URL akun Snowflake.
Database: database yang berisi server MCP.
Skema: skema yang berisi server MCP.
Nama server MCP: nama objek server MCP Snowflake.
URL lengkap server MCP terkelola, jika layar penyiapan ChatGPT meminta URL.
Peran Snowflake: peran yang harus digunakan pengguna saat memberi otorisasi aplikasi.
Daftar alat: objek dan tindakan Snowflake yang ingin Anda gunakan dengan ChatGPT.
Tentukan apa yang dapat dilakukan ChatGPT
Pilih hanya kemampuan yang ingin Anda ekspos. Opsi umum mencakup:
Pencarian dengan Cortex Search untuk menemukan jawaban dalam data atau konten Snowflake yang diindeks.
Tanya jawab dengan Cortex Analyst melalui tampilan semantik yang disetujui.
SQL baca-saja untuk akses kueri yang terkendali.
Agen Snowflake, prosedur tersimpan, atau UDF untuk alur kerja tertentu.
Jika Anda mengaktifkan SQL, pertahankan sebagai baca-saja kecuali organisasi Anda telah meninjau dan menyetujui akses tulis.
Buat server MCP Snowflake
Di Snowflake, masuk dengan peran yang dapat membuat server MCP dan memberikan akses. Buka worksheet di database dan skema tempat server MCP harus dibuat.
Buat server MCP yang hanya mencantumkan alat yang harus digunakan ChatGPT. Ganti nama objek dengan database, skema, layanan, tampilan, warehouse, dan nama server Snowflake Anda sendiri.
Contoh:
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" $$;
Nama alat harus stabil dan deskriptif agar ChatGPT dapat memilih alat yang tepat. Membuat server MCP tidak otomatis memberikan akses ke objek Snowflake yang mendasarinya.
Berikan izin Snowflake yang tepat
Pilih peran Snowflake yang akan digunakan pengguna untuk memberi otorisasi, lalu berikan akses peran tersebut ke database, skema, server MCP, dan setiap objek dasar yang digunakan oleh alat.
Contoh:
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;
Jika server MCP mengekspos tampilan semantik, UDF, prosedur tersimpan, atau Cortex Agent, berikan juga izin yang diperlukan untuk objek tersebut.
Verifikasi Snowflake sudah siap
Jalankan:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Lalu jalankan:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Konfirmasi:
Server ada di database dan skema yang diharapkan.
Daftar alat sesuai dengan yang Anda inginkan.
Setiap pengidentifikasi alat mengarah ke objek Snowflake yang tepat.
Peran penghubung memiliki USAGE pada server MCP.
Peran penghubung memiliki izin yang diperlukan pada setiap objek dasar.
Mulai penyiapan templat di ChatGPT
Di ChatGPT, beralihlah ke workspace tempat aplikasi harus tersedia.
Buka Pengaturan workspace > Aplikasi.
Pilih Direktori.
Cari Snowflake.
Pilih templat aplikasi Snowflake dan mulai penyiapan.
Masukkan nama dan deskripsi aplikasi yang jelas, seperti Snowflake atau Snowflake - Analytics.
Masukkan detail server MCP terkelola yang diminta oleh alur penyiapan.
Jika layar penyiapan meminta URL lengkap server MCP terkelola, gunakan format ini:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Jika layar penyiapan meminta bidang terpisah, gunakan nilai yang sama dari URL tersebut:
Prefiks host Snowflake.
Database.
Skema.
Nama server MCP.
Buat dan publikasikan draf aplikasi
Simpan penyiapan templat Snowflake di ChatGPT.
Buat draf aplikasi.
Tinjau detail draf aplikasi, pengaturan autentikasi, dan tindakan yang tersedia.
Publikasikan draf aplikasi saat siap.
Pastikan aplikasi muncul di Pengaturan workspace > Aplikasi > Diaktifkan.
Konfigurasikan Akses pengguna untuk peran yang harus menggunakannya.
Tinjau Kontrol tindakan untuk alat yang diekspos.
Tinjau Izin aplikasi untuk memilih kapan ChatGPT meminta anggota sebelum menggunakan aplikasi.
Izin aplikasi ini berlaku untuk percakapan ChatGPT. Agen Workspace menggunakan kontrol per agen yang ditetapkan oleh pembuat agen untuk menentukan tindakan aplikasi mana yang tersedia dan kapan pengguna akhir diminta menyetujuinya. Untuk perilaku agen, lihat: Agen Workspace ChatGPT untuk Enterprise dan Business.
Uji aplikasi
Mulai alur koneksi dari ChatGPT sebagai pengguna uji yang diizinkan.
Masuk ke Snowflake dan pilih peran yang dimaksud jika diminta.
Pastikan ChatGPT menemukan alat yang diharapkan dari server MCP.
Jalankan tindakan baca berisiko rendah terlebih dahulu, seperti pencarian atau kueri baca-saja terhadap data yang disetujui.
Pastikan izin Snowflake mencegah akses di luar peran dan objek yang disetujui.
URL server MCP dan perilaku Oauth
ChatGPT terhubung ke URL lengkap server MCP yang dikelola Snowflake. ChatGPT menggunakan prefiks host Snowflake dari URL tersebut untuk menyelesaikan endpoint Oauth Snowflake.
Jangan tempelkan URL Snowsight, URL root akun Snowflake saja, atau URL apa pun dengan segmen path tambahan. URL MCP harus menyertakan database, skema, dan path server MCP serta harus sama persis dengan objek Snowflake Anda.
Pemecahan masalah
Server MCP tidak ditemukan: periksa kembali URL lengkap server MCP atau prefiks host, database, skema, dan bidang server yang terpisah.
Tidak ada alat yang muncul di ChatGPT: pastikan spesifikasi server MCP menyertakan alat dan peran memiliki USAGE pada server MCP.
Alat muncul tetapi gagal saat digunakan: pastikan peran memiliki izin yang tepat pada objek Snowflake yang mendasarinya.
Alat SQL gagal: pastikan nama warehouse benar, warehouse tersedia, peran memiliki USAGE padanya, dan read_only bernilai true jika Anda menginginkan akses baca-saja.
Otorisasi gagal: pastikan pengguna dapat masuk ke Snowflake dan menggunakan peran yang dimaksud.
Masalah koneksi hostname: gunakan prefiks host Snowflake yang benar. Hostname Snowflake dengan garis bawah dapat menyebabkan masalah; sebaiknya gunakan tanda hubung.